agent-trade-kit MCP — 사용 사례, 설치 & 라이브 데모

Name: agent-trade-kit MCP Server
Author: okx

왜 쓰나요

핵심 기능

112 tools across 8 modules: market, spot, swap, futures, options, account, earn, bots
70+ technical indicators built in
Algo order types: conditional, trailing stops, grid, DCA
--read-only mode for research without trade execution
Credentials stored locally — no OKX-run cloud service

라이브 데모

실제 사용 모습

agent-trade-kit.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "agent-trade-kit",
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "agent-trade-kit": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "agent-trade-kit"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add agent-trade-kit -- npx -y agent-trade-kit

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: agent-trade-kit

Research an asset before deciding to trade (read-only)

👤 Crypto traders doing due diligence ⏱ ~20 min advanced

언제 쓸까: You're considering a position and want charts + indicators + order book snapshot in one pass — without any risk of accidental trades.

사전 조건

OKX API key (read-only scope) — OKX > API > Create key with read-only permission

흐름

Start in read-only mode

Configure agent-trade-kit with --read-only. Confirm trade tools are disabled.✓ 복사됨

→ Only research tools enabled
Pull data

For SOL-USDT: 4h candles last 30 days, RSI(14), MACD, current funding rate, top-of-book depth, and open interest trend.✓ 복사됨

→ Indicator stack
Synthesize

What's the short-term technical picture and is it aligned with funding/OI?✓ 복사됨

→ Analysis

결과: Informed view without execution risk.

함정

TA is not a prediction engine — Use as one input; not a trade signal on its own

Set up a grid bot within conservative parameters

👤 Crypto traders exploring grid strategies ⏱ ~30 min advanced

언제 쓸까: You want a range-bound grid on a pair you believe will oscillate.

사전 조건

Funded OKX account — Real money at stake — tread carefully
Full API key (trade scope) — OKX > API; DO NOT enable withdrawal

흐름

Plan

For ETH-USDT spot: analyze last 30d range. Propose a grid: 40 levels, range $2800-$3400, $50 per grid investment. Show projected returns.✓ 복사됨

→ Grid plan with assumptions
Confirm and create

Before placing: confirm parameters. If I say 'go', create the grid bot; otherwise abort.✓ 복사됨

→ Explicit confirmation gate

결과: Grid bot running with sized risk.

함정

Range breakout = grid loses — Set a stop-loss price outside the range; review weekly
LLM mis-sizes the order — real money lost — Small starting sizes; verify every parameter before confirming

Check portfolio PnL and open positions

👤 Active traders ⏱ ~5 min intermediate

언제 쓸까: Morning check — what do I have open, how is it doing, any risks to my margin?

흐름

Pull account state

List all open positions (spot + swap + futures) with unrealized PnL. Show account equity + maintenance margin ratio.✓ 복사됨

→ Portfolio snapshot
Risk check

Which position is at highest liquidation risk? How far from its liq price?✓ 복사됨

→ Risk ranked

결과: Risk-aware morning check.

조합

다른 MCP와 조합해 10배 효율

agent-trade-kit + filesystem

Log every trade execution locally for tax/audit

After each trade, append instrument/side/size/price/ts to ~/trades/YYYY-MM.csv.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
market_candles	instrument, bar, limit?	Price data	1 API call
market_book	instrument, depth	Liquidity check	1 API call
account_balance		Account status	1 API call
spot_place_order	instrument, side, size, type, price?	Spot execution — destructive; confirm!	1 API call + real money
grid_bot_create	instrument, range, levels, total_investment	Launch a grid strategy — destructive; confirm!	1 API call + real money

비용 및 제한

운영 비용

API 쿼터: OKX API has per-endpoint rate limits
호출당 토큰: Candles/books can be large — trim by limit
금액: Free MCP. Trades incur OKX fees + real money risk.
팁: Use --read-only until you've read the tool list and trust your prompt discipline.

보안

권한, 시크릿, 파급범위

최소 스코프: API key with NO withdrawal permission, ever

자격 증명 저장: Local via okx config init — stays on disk

데이터 외부 송신: To OKX API; account data to your LLM provider

절대 부여 금지: Withdrawal permission on an API key used with an LLM

This MCP moves real money. Start in --read-only, then tiny sizes, then scale.
IP-whitelist your API key in OKX settings so a leaked key can't be used from elsewhere.
LLMs hallucinate numbers. Always confirm size, side, and instrument before execution.

문제 해결

자주 발생하는 오류와 해결

Signature invalid

API key/secret/passphrase mismatch. Re-run okx config init. Also check server clock (API is time-sensitive).

Insufficient balance for order

Transfer funds to trading account (OKX has multiple wallets).

Tool missing when expected

Per-module filtering may be blocking it; check config.

대안

agent-trade-kit 다른 것과 비교

대안	언제 쓰나	단점/장점
Hummingbot / custom bot frameworks	You want non-LLM automated trading	Code, no LLM; more deterministic
Direct OKX API	You want full control and can self-audit	Build your own wrapper

agent-trade-kit

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

클라이언트 선택

사용 사례

실전 활용법: agent-trade-kit

Research an asset before deciding to trade (read-only)

사전 조건

흐름

함정

Set up a grid bot within conservative parameters

사전 조건

흐름

함정

Check portfolio PnL and open positions

흐름

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

agent-trade-kit 다른 것과 비교

더 보기

리소스