앱 열기Open app ↗
30초 · 가입 없이 시작30 seconds · no signup to try

평균이 아닌,
결정론적 시장 상태 Deterministic market state,
not averages.

에이전트가 그대로 읽는 인터페이스. 어떤 모델도 밸류에이션 못 하는 자산의 현재 상태를 — 결정론적으로 라벨하고, 매일 공개로 채점합니다. An interface your agent can read — the current state of assets no model can value, labeled deterministically and scored in public every day.

# 설치도 키도 없이 — 지금 바로# no install, no key — right now 
curl -s https://api.decker-ai.com/api/v1/public/demo | jq .
MCP 붙이기 →Connect MCP → 브라우저로 결과 보기See the raw output

MCP는 Claude·Cursor 쓰는 사람용이에요. 그냥 빠르게 써보려면 → 텔레그램 · 웹앱 MCP is for Claude / Cursor users. Just want to try it fast? → Telegram · Web app

GOLD STATE_VIEW 예시example
1h B_OBSERVING
▪ 엔진의 종합 뷰: 아래쪽(매도 관점) · 층간 힘겨루기
목표 4,401 · 무효선 4,499
엔진: 주시 자세 (시험 결과 대기)
▪ Engine view: downside (short bias) · layers in conflict
Target 4,401 · invalidation 4,499
Engine: watching (awaiting test result)
ref
4,510
목표target
4,401
무효선invalidation
4,499
최근 판정 (리시트)recent verdicts (receipts)
2026-08-17 · 4h hit
2026-08-18 · 1h invalidated
2026-08-18 · 8h miss
shape 예시 · 값 고정 캡처 (라이브 값 = 데모 API) · 룰 경로 LLM 0shape example · fixed capture (live values via demo API) · zero LLM in signal path
도구tools

14 도구 — 무엇을 반환하나14 tools — what each returns

모두 결정론 — 엔진이 영속시킨 값을 재계산 없이 직독. 실시간 LLM 호출 0(당신 에이전트가 LLM). 11개는 상태 읽기이지 매매 지시가 아닙니다 — 단 place_order·close_position·update_protective_stops 3개는 예외로 Decker 자체 실행엔진이 실제로 주문을 넣거나 바꿉니다(아래 참조).All deterministic — persisted engine values read as-is, zero recompute. No on-demand LLM call (your agent is the LLM). 11 are state readings, not trade instructions — except place_order, close_position, and update_protective_stops, which actually place or modify orders through Decker's own execution engine (see below).

get_view(symbol)
조립된 뷰 — 브리핑 카드와 동일: 종합 판정 · MTF 정렬 · 서사 · 좌표(기준/목표/무효선) · 최근 리시트. 해석된 뷰가 필요할 때.Composed view — same card the daily briefing sends: overall verdict · MTF alignment · narrative · coordinates (ref/target/invalidation) · recent receipts. When you want the interpreted view.
get_market_state(symbol, timeframe)
원시 엔진 상태 — 최신 평가 봉, 재계산 0: c_state · action_gate(GO/WATCH/HOLD 자세) · key_price · reversal_risk. 미emit 필드 = null(채움 없음).Raw engine state — latest evaluated bar, zero recompute: c_state · action_gate (GO/WATCH/HOLD posture) · key_price · reversal_risk. Absent fields = null (no filling).
get_reading(symbol, tf)
AI 조립 판독 — directional_bias · mtf_view · execution_hint + 짧은 요약. 좌표·근거까지 한 번에.Synthesized reading — directional_bias · mtf_view · execution_hint plus a short summary. State with coordinates and reasons in one shot.
get_signals(symbols, action_gate, …)
활성 시그널 — 스킬 오버레이 적용. 종목 · 게이트(GO/WATCH/HOLD) · 진행도로 필터. 지금 이 순간의 상태만 봅니다(GO 필터는 상시 0건이 흔함) — 과거 발화 이력은 get_trigger_history.Active signals — with your skill overlay applied. Filter by symbols · gate (GO/WATCH/HOLD) · progress. Reflects only the current moment (the GO filter is often 0 rows) — for past trigger history use get_trigger_history.
get_trigger_history(symbol, timeframe?, since?, limit?)
과거 실제 트리거 이력 — 대기 후보(WATCH/HOLD)가 아니라 실제로 GO가 발화된 사건들: 진입/목표/손절 좌표 + 실현손익(mfe_pct/mae_pct/exit_reason, 미청산=null). "최근에 실제로 뭐가 트리거됐고 얼마에 났나"는 이 도구로만 답 가능.Actual historical triggers — not standing WATCH/HOLD candidates, but events where GO actually fired: entry/target/stop coordinates + realized performance (mfe_pct/mae_pct/exit_reason, null if still open). Only this tool answers "what actually triggered recently and at what price".
get_assembly(symbol?)
최적 경로 조립 — 전 라이브 타임프레임을 하나로 합친 결정론적 기계 판정: 방향 · 등급(정렬/구조+눌림/소진-반전) · 진입(지금 vs 대기) · 손절 · 목표 · RR. 상위 TF가 목표를, 하위 TF가 진입을 공급하는 단일 판단 권위 — 재해석 말고 그대로 쓰세요. symbol 생략 시 14종목 전체.Optimal-path assembly — one deterministic verdict combining every live timeframe: direction · grade (aligned / structure+pullback / exhaustion-reversal) · entry (now vs wait) · stop · target · RR. Upper TF supplies the target, lower TF the entry — the single judgment authority; narrate it, don't re-decide it. Omit symbol for all 14.
validate_intent(symbol, side)
주문 전 게이트 대조 — 실행 툴(브로커 MCP 등)로 주문을 넣기 전에(또는 아래 place_order/close_position으로 Decker가 직접 집행하기 전에도 동일 적용) 의도(종목+방향)를 엔진 상태에 대조: action_gate(자세) · 활성 시그널과의 방향 정합(aligned/opposed) · 무효선. 승인/거부가 아니라 상태 읽기 — 매 판정이 감사 원장에 영속(check_id).Pre-trade gate check — before placing any order through any execution tool (e.g. a broker MCP), or before Decker itself executes via place_order/close_position below, check the intent (symbol + side) against engine state: action_gate (posture) · side alignment vs the active signal (aligned/opposed) · invalidation. A stance reading, not an approval — every check is persisted to an auditable ledger (check_id).
get_state_timeline(symbol, timeframe, since)
봉별 상태 타임라인 — get_market_state 와 같은 스키마, bar_ts 오름차순. 엔진 미emit 봉 = 정직한 공백.Per-bar state timeline — same schema as get_market_state, ascending by bar_ts. Unemitted bars = honest gaps.
get_user_skills()
스킬 카탈로그 + 활성 오버레이 — 8종(보수/표준/공격/기본/스캘프/스윙/타이트/와이드, 각 SL·TP% 다름)과 현재 선택.Skill catalog + active overlay — 8 skills (conservative/standard/aggressive/default/scalp/swing/tight/wide, each with its own SL/TP%) and your current selection.
set_skill_overlay(skill_id)
오버레이 변경 — 이후 모든 get_signals 및 하류 채널에 즉시 반영.Change overlay — immediately affects all subsequent get_signals and downstream channels.
get_positions()
실제 노출 — real 오픈 포지션(손절/목표 포함)·virtual 오픈 포지션·양쪽 최근 청산 10건. 자금 이동 0 — place_order 전에 중복진입/과노출 확인용.Your actual exposure — real open positions (with live stop/target), virtual open positions, and the last 10 closed round-trips per mode. No money moved — check this before place_order to avoid duplicate/over-exposure.
place_order(symbol, side, notional_usd)
시장가 발주 실행 — Decker 자체 실행엔진으로 집행(유저 자기 브로커 아님). crypto-6(BTC/ETH/SOL/BNB/XRP/DOGE)만 — GOLD/삼성전자 등 나머지 자산은 위 도구들로 조회만 가능, 이 도구로 주문은 못 넣습니다. real 체결은 decker-ai.com에서 별도로 거래소 키 연동+PRO tier 필요 — 미충족 시 자동 virtual(모의) 강등, 응답의 execution_mode 필드가 항상 진실. ⚠ 이 호출만으로는 손절/목표가 안 붙습니다(수동 주문 공통 동작) — 바로 아래 update_protective_stops를 이어서 부르세요.Market order executes — through Decker's own execution engine (not your own broker). Crypto-6 only — GOLD, Samsung, etc. are read-only via the tools above, you can't order them here. Real execution requires a separately linked exchange key + PRO tier on decker-ai.com — otherwise silently downgrades to virtual; the response's execution_mode field is always authoritative. ⚠ This call alone attaches no stop-loss/take-profit (same as any manual order) — follow it with update_protective_stops below.
close_position(symbol, close_fraction?)
청산/부분청산 실행 — 위와 동일 엔진으로 집행, 단 crypto-6 제한 없음(청산=위험축소). 보유 중인 포지션이 실제로 있는 곳(real/virtual)을 찾아 닫음 — 없으면 정직한 not-found.Close/reduce executes — same engine as above, but no crypto-6 restriction (closing reduces risk). Looks up whatever position(s) actually exist (real/virtual) and closes them — no position = a clean not-found.
update_protective_stops(symbol, sl_price?, tp_price?, mode?)
손절/목표 수정 실행 — 이미 보유 중인 포지션의 stop-loss·take-profit을 바꿉니다(대기 주문 취소 개념이 없는 대신 이 갭을 메움). real은 거래소 신규 SL/TP 주문을 먼저 낸 뒤 구 주문을 취소(무보호 구간 없음). virtual은 포지션 컬럼 직접 갱신. real·virtual 둘 다 열려 있으면 mode 지정 필수.Adjust stop/target executes — modifies the stop-loss/take-profit on a position you already hold (Decker has no cancel-order concept, so this is the actual gap it fills). real: places the new exchange SL/TP order first, then cancels the old one — no unprotected window. virtual: updates the position record directly. mode is required if both real and virtual positions are open.
MCP 리소스 2종도 제공: decker://rules(공개 룰북 원문) · decker://track-record(일일 자기채점 장부) — 에이전트가 "왜 HOLD인가"를 설명할 때 정본을 직접 인용할 수 있어요.Two MCP resources are also served: decker://rules (the public rulebook) and decker://track-record (the daily self-scoring ledger) — so your agent can quote the canonical source when explaining "why HOLD".
상태 어휘state vocabulary

payload enum 사전payload enum reference

에이전트가 그대로 읽는 값의 의미. 이 사전이 있어야 에이전트가 추론으로 때우지 않습니다.What the values your agent reads mean — so the agent doesn't have to guess.

c_state 구조 상태structural state
A_FORMING직전 움직임이 진짜였는지 확인 중confirming the prior move was real
B_FORMING자리를 시험하는 구간testing whether the level holds
B_OBSERVING시험 자리를 관찰하는 구간observing the tested level
B_SET자리 확정 — 다음 시도 대기level confirmed — awaiting next attempt
C_SET새 시도가 진행 중a new attempt in progress
BREAK_PLUS / _MINUS기준선 위 돌파 / 아래 이탈broke above / below the baseline
action_gate 자세 (명령 아님)posture, not an order
GO움직임 신호가 켜진 자세movement signal is on
WATCH주시 자세watching
HOLD지켜보는 자세holding
verdict 사후 자기채점 (리시트)self-scored after the fact
hit뷰대로 전개됨the view played out
miss목표 미달 / 반대로 감missed target / went against
invalidated무효선 터치 = 시나리오 종료invalidation touched = scenario over
›엔진이 안 낸 축 = null(채우지 않음, "정직한 공백") · 미지원 심볼 = 안내. 전체 스키마 = /docs · 에이전트 ingest = llms.txtAxis the engine didn't emit = null (not filled — "honest gap") · unsupported symbol = guidance. Full schema = /docs · agent-ingestable = llms.txt
쿼리 가능 자산what you can query

한 인터페이스, 세 시장One interface, three markets

모든 심볼이 같은 스키마로 나옵니다 — get_market_state("005930.KRX","1d") 든 get_market_state("BTCUSDT","4h") 든. 신선도는 시장마다 다르며, 응답에 정직하게 실립니다.Every symbol returns the same schema — get_market_state("005930.KRX","1d") or get_market_state("BTCUSDT","4h"). Freshness differs per market and is reported honestly in every response.

크립토Crypto 장중intraday

6종 · 30m–1d 봉 · 장중 갱신.6 assets · 30m–1d bars · updated intraday.

BTC · ETH · SOL · BNB · XRP · DOGE
symbol: BTCUSDT
상품 · 지수Commodities & indices 장중intraday

HL 합성 8종 · 같은 판독 스키마.8 synthetics · same reading schema.

금·은Gold · Silver · WTI · Brent · S&P 500 · 코스피200KOSPI 200 · Tesla · Nvidia
symbol: XYZ_GOLDUSD, XYZ_KR200USD
한국 주식 (KRX)Korean equities (KRX) 일간 · 베타daily · beta

KOSPI + KOSDAQ · 약 2,770 종목 · 종가 판정. 포트폴리오 자세 ADD / HOLD / REDUCE / EXIT.KOSPI + KOSDAQ · ~2,770 tickers · close-of-day. Portfolio posture ADD / HOLD / REDUCE / EXIT.

매일 16:30 KST 마감 체크업.Daily 16:30 KST closing checkup.
symbol: 005930.KRX (삼성전자)(Samsung)
크립토·상품·지수는 장중 봉으로, 한국 주식은 매일 종가로 판정됩니다. MCP get_market_state·get_signals가 세 시장을 같은 스키마로 반환해요.Crypto, commodities and indices update on intraday bars; Korean equities settle once daily at the close. MCP get_market_state and get_signals return all three with the same schema.
30초 데모30-second demo

붙이기 전에, 받게 될 걸 먼저 보세요See what you'll get, before you set anything up

curl 한 줄 → MCP 한 줄 → 에이전트가 좌표와 리시트로 답합니다.one curl → one MCP line → the agent answers with coordinates and receipts.

3스텝 · 약 30초3 steps · ~30 seconds

MCP로 붙이기Connect over MCP

쓰는 앱을 고르세요. 앱마다 붙이는 방식이 조금 달라요 — 탭을 고르면 딱 맞는 설정이 나옵니다.Pick your app. Each one connects a little differently — choose a tab and you get the exact config for it.

1

무료 API 키 발급Get a free API key

decker-ai.com → Settings → API Keys. 텔레그램이면 @deckerclawbot에 /apikey. At decker-ai.com → Settings → API Keys. On Telegram, send /apikey to @deckerclawbot.

베타 중엔 가입만 하면 PRO 무료.During beta, signing up gets you PRO for free. 결제 없음.No payment.
키 넣기 전에, 서버가 살아있는지 먼저 확인 (키 필요 없음): curl https://api.decker-ai.com/api/v1/mcp/health → tools 목록이 보이면 OK.Before touching config, check the server is up (no key needed): curl https://api.decker-ai.com/api/v1/mcp/health → you should see the tools list.
2

설정에 붙여넣기Paste the config

Claude Desktop → Settings → Developer → Edit Config 버튼을 누르면 설정 파일이 열립니다. 아래를 붙여넣으세요. (Claude Desktop은 원격 MCP를 mcp-remote 브리지로 붙여요 — Node/npx 필요.)Claude Desktop → Settings → Developer → Edit Config opens the file. Paste the block below. (Claude Desktop reaches remote MCP through the mcp-remote bridge — Node/npx required.)

claude_desktop_config.json
{
  "mcpServers": {
    "decker": {
      "command": "npx",
      "args": ["-y", "mcp-remote",
        "https://api.decker-ai.com/api/v1/mcp",
        "--header", "X-API-Key:${DECKER_API_KEY}"],
      "env": { "DECKER_API_KEY": "dk_live_YOUR_KEY" }
    }
  }
}

Cursor → Settings → MCP → Add new, 또는 ~/.cursor/mcp.json을 직접 열어 붙여넣으세요. Cursor는 원격 MCP 서버(Streamable HTTP)를 직접 지원해서 브리지가 필요 없어요.Cursor → Settings → MCP → Add new, or open ~/.cursor/mcp.json directly. Cursor supports remote MCP servers (Streamable HTTP) natively — no bridge needed.

~/.cursor/mcp.json
{
  "mcpServers": {
    "decker": {
      "url": "https://api.decker-ai.com/api/v1/mcp",
      "headers": { "X-API-Key": "dk_live_YOUR_KEY" }
    }
  }
}

Codex(ChatGPT 앱 내장) 는 ~/.codex/config.toml에 MCP 서버를 등록합니다. 최신 버전은 원격 MCP 를 네이티브로 지원해서 브리지가 필요 없어요 — 아래를 먼저 써보세요.Codex (bundled with the ChatGPT app) registers MCP servers in ~/.codex/config.toml. Recent versions support remote MCP natively — no bridge needed. Try this first.

~/.codex/config.toml (네이티브, 권장)(native, recommended)
[mcp_servers.decker]
url = "https://api.decker-ai.com/api/v1/mcp"
http_headers = { "X-API-Key" = "dk_live_YOUR_KEY" }
⚠ url 끝에 /sse를 붙이면 405 Method Not Allowed로 실패해요 — 반드시 /api/v1/mcp로 끝나야 합니다 (뒤에 아무것도 붙이지 마세요).⚠ Appending /sse to the url fails with 405 Method Not Allowed — it must end exactly at /api/v1/mcp (nothing after).

위 방식이 도구를 못 찾으면 (구버전 Codex CLI), 브리지로 등록하세요 (TOML · Node/npx 필요).If the above doesn't pick up the tools (older Codex CLI), register through the bridge instead (TOML · Node/npx required).

~/.codex/config.toml (구버전 브리지)(legacy bridge)
[mcp_servers.decker]
command = "npx"
args = ["-y", "mcp-remote",
  "https://api.decker-ai.com/api/v1/mcp",
  "--header", "X-API-Key:${DECKER_API_KEY}"]
env = { DECKER_API_KEY = "dk_live_YOUR_KEY" }
dk_live_YOUR_KEY를 1번에서 받은 키로 바꾸세요.Replace dk_live_YOUR_KEY with the key from step 1.
3

앱 재시작 후 물어보기Restart, then ask

앱을 완전히 종료했다 다시 켜야 MCP가 로드됩니다. 그다음 아래처럼 물어보세요.You must fully quit and reopen the app for the MCP to load. Then ask something like below.

채팅에 "decker"라는 단어를 넣으면 에이전트가 이 도구를 씁니다.Include the word "decker" in your message so the agent reaches for the tool.
됐는지 확인: 도구 목록에 decker가 뜨고, 답변에 좌표(기준·목표·무효선)와 최근 판정이 나오면 성공.How to know it worked: decker shows in the tool list, and the reply comes back with coordinates (ref / target / invalidation) and recent verdicts.
14개를 잇는 여정the 14 tools, as one journey

탐색 → 내 설정 → 결정 → 실행 → 관리Explore → your settings → decide → execute → manage

아래는 금(GOLD, XYZ_GOLDUSD) — HL 합성 8종 중 하나, 비트코인이 아닌 이종 자산 — 으로 실제 라이브 호출한 순서다. 탐색·결정 3단계는 크립토·상품·KRX 어떤 심볼이든 동일 스키마로 그대로 통한다. 단 실행(4단계)은 crypto-6 전용이라 GOLD는 여기서 끊기고, 마지막 두 단계는 크립토 심볼(예: ETH)로 이어야 한다 — 이 경계 자체가 정직한 설계다.Below is the actual live call order for Gold (XYZ_GOLDUSD) — one of the 8 HL-synthetic symbols, not Bitcoin. The first 3 phases work identically for any symbol — crypto, commodity, or KRX. Execution (phase 4) is crypto-6 only, so GOLD's journey stops there — the last two phases continue with a crypto symbol (e.g. ETH). That boundary is by design, not an oversight.

decker로 금 시세 지금 상태 봐줘. 1시간봉 기준으로 들어가도 되는 자리야?Use decker to check gold's current state. On the 1h timeframe, is this a spot to enter?
decker로 여러 시간대 종합해서 금 최적 진입 경로 알려주고, 지금 스킬 설정도 보여줘.With decker, compose gold's multi-timeframe optimal entry path, and show my current skill setting too.
decker로 이더리움 50달러어치 매수하고, 손절·목표가도 바로 잡아줘.Use decker to buy $50 of ETH, and set a stop-loss/take-profit right after.

1. 탐색 — 지금 상태가 뭐야1. Explore — what's the state right now

4개 도구, 넓게 봤다가 좁혀 들어가는 순서.4 tools, wide-to-narrow.

get_view
"금 지금 어때?" — 조립된 뷰(브리핑 카드와 동일): 층간 힘겨루기 서사 + 기준·목표·무효선. tf 생략 시 4h 기본, "1시간봉으로는?"처럼 다시 물으면 좁혀짐."How's gold doing?" — the composed view (same card the daily briefing sends): the layer-conflict narrative + ref/target/invalidation. Omit tf for the 4h default; ask "on the 1h?" to narrow.
get_reading
"AI가 더 자세히 분석해줘" — MTF(1h/4h/1d) 정렬표 + 방향별 setup. ⚠ preferred_direction과 그 방향의 setup이 어긋날 수 있음 — setup이 null이면 그 방향은 아직 근거가 없다는 뜻."Give me the deeper AI read" — MTF (1h/4h/1d) alignment table + directional setups. ⚠ preferred_direction and that side's setup can diverge — a null setup means that direction has no backing yet.
get_assembly
"여러 시간대 종합해서 하나로" — 전 라이브 타임프레임을 합친 단일 판정: 등급·진입·손절·목표·RR. 재해석 말고 그대로 쓰는 게 맞음."Combine every timeframe into one" — a single verdict across all live TFs: grade · entry · stop · target · RR. Use it as-is, don't re-decide it.
get_state_timeline
"최근엔 어떻게 흘러왔어?" — 봉별 상태 이력(국면 전개를 순서대로). 지금 상태만으론 안 보이는 "왜 지금 이 자리인지"가 여기서 나옴."How did we get here?" — per-bar state history. Shows the "why this level, why now" that a single snapshot can't.
개발자용 여담 — get_market_state: 위 4개와 달리 사람 질문으로 잘 안 닿는 유일한 도구. 엔진 원어(c_state·R_*) 그대로 나오는 raw 계기라, 다른 도구/에이전트가 정밀값이 필요할 때 쓴다. 해석된 답이 필요하면 위 get_view·get_reading을 쓸 것.Developer aside — get_market_state: the one tool that doesn't map to a natural customer question. It's a raw instrument (engine-native c_state/R_* vocabulary, unfiltered) for another tool/agent that needs the precise value — for an interpreted answer use get_view/get_reading above instead.

2. 내 설정 — 어떤 리스크 성향으로 볼까2. Your settings — through which risk lens

2개 도구, 이후 모든 신호에 즉시 반영됨.2 tools, take effect on every signal immediately after.

get_user_skills
"내 투자 성향 뭘로 돼있어?" — 8종 카탈로그(보수/표준/공격/기본/스캘프/스윙/타이트/와이드, 각자 SL·TP%)와 지금 활성 스킬."What's my current risk setting?" — 8-skill catalog (conservative/standard/aggressive/default/scalp/swing/tight/wide, each with its own SL/TP%) and your active one.
set_skill_overlay
"스캘프로 바꿔줘" — 즉시 전환, 다음 get_signals 호출부터 바로 반영(사이즈·손절·목표 전부). 되돌리려면 같은 방식으로 원래 스킬 다시 지정."Switch me to scalp" — takes effect immediately, the very next get_signals call reflects it (size, stop, target). Revert the same way by naming your original skill.

3. 결정 — 그래서 살 수 있어?3. Decide — so, can I buy?

3개 도구. 여기까지는 GOLD·삼성전자·크립토 무엇이든 동일하게 작동.3 tools. Everything up to here works identically for GOLD, Samsung, or any crypto.

get_signals
"지금 살 수 있는 신호 있어?" — 스킬 오버레이 적용된 실제 진입/목표/손절 좌표. ⚠ 방향과 반대 모양 기하(손절이 목표보다 유리한 쪽)일 수 있는데 이 도구 단독으론 경고가 안 붙음 — get_assembly의 defects 필드와 교차확인 권장."Any signal I can act on right now?" — actual entry/target/stop coordinates with your skill overlay applied. ⚠ can carry inverted-looking risk geometry with no warning on this tool alone — cross-check get_assembly's defects field.
get_trigger_history
"최근에 실제로 뭐 트리거됐어?" — get_signals 는 지금 순간만 보여줘서 GO 필터가 상시 0건이기 쉬운데, 이 도구는 과거 실제 발화 이력 + 진입/목표/손절 + 실현손익을 그대로 돌려줌."What actually triggered recently?" — get_signals only reflects this instant (its GO filter is often 0 rows); this tool returns actual past triggers with entry/target/stop and realized performance.
validate_intent
"지금 사도 될까?" — 매수/매도 의도를 엔진 상태에 대조: 자세(GO/WATCH/HOLD)·방향 정합(aligned/opposed)·무효선. 승인이 아니라 상태 읽기 — 판정마다 감사 원장에 남음(check_id)."Should I buy this now?" — checks your intent against engine state: posture (GO/WATCH/HOLD) · side alignment (aligned/opposed) · invalidation. A stance reading, not approval — every check is logged (check_id).

4–5. 실행 & 관리 — crypto-6 전용, 여기서부터 GOLD는 못 감4–5. Execute & manage — crypto-6 only, GOLD's journey ends here

4개 도구. Decker 자체 실행엔진이 실제로 주문을 넣거나 바꾸는 유일한 구간 — BTC/ETH/SOL/BNB/XRP/DOGE 6종만 되고, GOLD·KRX는 여기서부터 조회 전용으로 남는다.4 tools. The only stretch where Decker's own execution engine actually places or changes orders — BTC/ETH/SOL/BNB/XRP/DOGE only; GOLD and KRX stay read-only from here on.

place_order
"이더리움 50달러 사줘" — 시장가 발주. ⚠ 이 호출만으론 손절/목표 미부착(수동 주문 공통 동작) — 바로 다음 도구로 이어야 함."Buy $50 of ETH" — market order. ⚠ attaches no stop/target by itself (same as any manual order) — chain the next tool right after.
update_protective_stops
"손절 얼마, 목표 얼마로 잡아줘" — 방금 연 포지션의 stop-loss/take-profit 설정. real은 새 주문 먼저 넣고 구 주문 취소(무보호 구간 없음)."Set my stop at X, target at Y" — sets stop-loss/take-profit on the position you just opened. real: places the new order first, cancels the old one after (no unprotected window).
get_positions
"내 포지션 확인해줘" — real/virtual 오픈 포지션 + 양쪽 최근 청산 10건. 다음 매매 전 중복진입·과노출 점검용."Show me my positions" — real/virtual open positions + last 10 closed round-trips each. Check this before your next order to avoid duplicate/over-exposure.
close_position
"청산해줘" — 보유 중인 자리를 찾아 닫음(전량 또는 부분). 포지션 없으면 정직한 not-found, 에러 아님."Close it out" — finds and closes whatever you're holding (full or partial). No position = a clean not-found, not an error.
안 되면if it doesn't show up

막힐 때Troubleshooting

◆ 도구가 안 보여요The tool doesn't appear

앱을 완전히 종료했다 다시 켰나요? MCP는 재시작 후에만 로드됩니다 (Claude Desktop은 Cmd+Q). mcp-remote를 쓰는 앱은 Node/npx가 깔려 있어야 해요.Did you fully quit and reopen? MCP loads only after a restart (Cmd+Q on Claude Desktop). Clients using mcp-remote need Node/npx installed.

◆ 키 오류가 나요Key / auth error

X-API-Key에 dk_live_ 키를 넣었는지 확인하세요. 서버·도구는 키 없이도 확인돼요: curl .../api/v1/mcp/health. 키는 decker-ai.com → Settings → API Keys.Check that X-API-Key holds your dk_live_ key. Server + tools are checkable without a key: curl .../api/v1/mcp/health. Get a key at decker-ai.com → Settings → API Keys.

◆ 설정 파일이 어디죠?Where's the config file?

Claude Desktop은 Settings → Developer → Edit Config가 열어줍니다. Cursor는 ~/.cursor/mcp.json, Codex는 ~/.codex/config.toml.Claude Desktop opens it via Settings → Developer → Edit Config. Cursor uses ~/.cursor/mcp.json, Codex ~/.codex/config.toml.

◆ 터미널이 없어요No terminal

맨 위 curl 대신 이 링크를 그냥 브라우저에서 열면 결과가 보입니다: api.decker-ai.com/…/public/demoSkip the curl — just open this link in a browser to see the output: api.decker-ai.com/…/public/demo