앱 열기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

BTC STATE_VIEW 예시example
4h B_SET
▪ 엔진의 종합 뷰: 위쪽(매수 관점) · 층간 힘겨루기
목표 진행 64,458 · 뷰 접힘 62,576
엔진: 지켜보는 자세 (되돌림 위험 감시)
▪ Engine view: upside (long bias) · layers in conflict
Target in progress 64,458 · view folds under 62,576
Engine: watching (reversal risk)
ref
63,738
목표target
64,458
무효선invalidation
62,576
최근 판정 (리시트)recent verdicts (receipts)
2026-07-05 · 4h hit
2026-07-06 · 4h invalidated
2026-07-06 · 1d miss
shape 예시 · 값 고정 캡처 (라이브 값 = 데모 API) · 룰 경로 LLM 0shape example · fixed capture (live values via demo API) · zero LLM in signal path
도구tools

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

모두 결정론 — 엔진이 영속시킨 값을 재계산 없이 직독. 실시간 LLM 호출 0(당신 에이전트가 LLM). 모든 응답은 상태 읽기이지 매매 지시가 아닙니다.All deterministic — persisted engine values read as-is, zero recompute. No on-demand LLM call (your agent is the LLM). Every response is a state reading, not a trade instruction.

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, tf)
원시 엔진 상태 — 최신 평가 봉, 재계산 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, gate, …)
활성 시그널 — 스킬 오버레이 적용. 종목 · 게이트(GO/WATCH/HOLD) · 진행도로 필터.Active signals — with your skill overlay applied. Filter by symbols · gate (GO/WATCH/HOLD) · progress.
validate_intent(symbol, side)
주문 전 게이트 대조 — 실행 툴(브로커 MCP 등)로 주문을 넣기 전에 의도(종목+방향)를 엔진 상태에 대조: action_gate(자세) · 활성 시그널과의 방향 정합(aligned/opposed) · 무효선. 승인/거부가 아니라 상태 읽기 — 매 판정이 감사 원장에 영속(check_id).Pre-trade gate check — before placing any order through any execution tool (e.g. a broker MCP), 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, tf, 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()
스킬 카탈로그 + 활성 오버레이 — 기본 3종(보수/표준/공격)과 현재 선택.Skill catalog + active overlay — 3 base skills (conservative/standard/aggressive) and your selection.
set_skill_overlay(skill_id)
오버레이 변경 — 이후 모든 get_signals 및 하류 채널에 즉시 반영.Change overlay — immediately affects all subsequent get_signals and downstream channels.
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 → 도구 8개가 보이면 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 8 tools.
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 CLI는 ~/.codex/config.toml에 MCP 서버를 등록합니다 (TOML · Node/npx 필요). 버전이 다르면 DEVELOPER_README를 참고하세요.Codex CLI registers MCP servers in ~/.codex/config.toml (TOML · Node/npx required). If your version differs, see the DEVELOPER_README.

~/.codex/config.toml
[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.
복붙용 첫 질문copy-paste first prompts

이렇게 물어보세요Try asking

빈 채팅 앞에서 뭘 물을지 모르겠다면, 이 중 하나를 그대로 붙여넣으세요.Not sure what to ask a blank chat? Paste one of these as-is.

decker로 BTC 지금 상태 봐줘. 들어가도 되는 자리야?Use decker to read BTC's current state. Is this a spot to enter?
decker로 이더리움 4시간봉 상태랑 최근 판정 리시트 보여줘.With decker, show ETH's 4h state and its recent scoring receipts.
decker로 삼성전자(005930.KRX) 일봉 상태랑 자세 알려줘.Use decker to read Samsung (005930.KRX) daily state and posture.
안 되면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