x402-mcp

Name: x402 crypto market structure
Author: tunedforai

AI 에이전트를 위한 거래소 간 암호화폐 시장 구조. 20개 거래소, 26개 토큰, 9개 도구 — 주문 흐름, CVD, 고래 활동, 펀딩/OI, 7년치 OHLCV, 온체인 주소 위험. MCP를 통해 무료 제공.

npm version License: MIT

x402-mcp는 x402.tunedfor.ai (실시간 암호화폐 시장 구조 API)를 MCP 호환 클라이언트(Claude Desktop, Cursor, Cline, Windsurf, Claude Code)에서 호출할 수 있는 9개의 도구로 노출하는 stdio MCP 서버입니다. 테스트 및 저빈도 쿼리용으로 MCP를 통해 무료로 제공되며, 더 높은 처리량이 필요한 프로덕션 에이전트를 위해 동일한 엔드포인트에서 유료 REST API를 제공합니다.

설치

Claude Desktop / Cursor / Windsurf

MCP 설정 파일(~/Library/Application Support/Claude/claude_desktop_config.json (macOS 기준, 다른 OS는 해당 경로))에 추가하세요:

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "@tunedforai/x402-mcp"]
    }
  }
}

Claude Code

claude mcp add x402 -- npx -y @tunedforai/x402-mcp

Cline / Continue / 기타 MCP 클라이언트

stdio 명령어로 npx -y @tunedforai/x402-mcp를 동일하게 사용하세요.

수동 설치

npm install -g @tunedforai/x402-mcp
x402-mcp  # runs the stdio server

도구

9개의 도구 모두 상태를 저장하지 않습니다. API 키, 인증, 설정이 필요 없습니다. 그냥 호출하세요.

도구	반환 내용	REST 대응	MCP 무료 / REST 유료
`marketSnapshot`	실시간 가격, 펀딩, OI, 매수/매도 비율, 공포/탐욕 지수	`POST /data`	무료 / $0.20
`marketAnalyze`	매크로 체제, DXY, VIX, 방향성 신호 + 신뢰도	`POST /analyze/market`	무료 / $0.25
`marketOrderflow`	거래소 간 CVD, 고래 활동, 청산 압력	`POST /analyze/orderflow`	무료 / $0.50
`marketFull`	스냅샷 + 주문 흐름 + LLM 합성 분석	`POST /analyze/full`	무료 / $0.75
`addressRisk`	지갑 위험 점수 (믹서, 제재, 거래 상대방). EVM + Solana	`POST /analyze/address`	무료 / $0.25
`history1h`	매수/매도 흐름이 분리된 시간별 OHLCV. 최대 5,000개 바, 7년치 기록	`POST /data/history/1h`	무료 / $5.00
`history1d`	매수/매도 흐름이 분리된 일별 OHLCV. 최대 5,000개 바, 7년치 기록	`POST /data/history/1d`	무료 / $5.00
`history5m`	5분 단위 OHLCV. 고해상도 장중 데이터	`POST /data/history/5m`	무료 / $1.00
`apiInfo`	가격, 빠른 시작, 마이그레이션 세부 정보	`GET /api_info`	무료

토큰 커버리지

스냅샷 티어 (17개 토큰): BTC, ETH, SOL, XRP, BNB, DOGE, ADA, AVAX, LINK, ATOM, DOT, ARB, SUI, OP, LTC, AMP, ZEC
주문 흐름 + 기록 티어 (26개 토큰): 위 모든 토큰 + NEAR, AAVE, BCH, HBAR, SHIB, TON, TRX, UNI, XLM

예시

거래 전 확인

You: marketSnapshot BTC
LLM: BTC at $74,180. Buy ratio 58% — bullish lean. Funding rate +0.012%
     (mild long bias). Open interest $14.2B. Fear & Greed: 32 (Fear).
     Snapshot 12 sec old.

거래소 간 주문 흐름

You: marketOrderflow ETH
LLM: ETH cross-exchange CVD: -$1.2M last hour (sell-side dominant).
     Whale activity: 8 large bars across Binance/Coinbase/Bybit.
     Liquidations: $890K longs, $230K shorts. Pressure: bearish.

백테스트 데이터

You: history1d BTC limit=365
LLM: [returns 365 daily bars: open/high/low/close/volume/buy_volume/sell_volume]

무료 MCP vs 유료 REST

MCP 래퍼는 속도 제한이 있는 무료 서비스로, 테스트, 프로토타이핑, 저빈도 에이전트 워크플로우 및 개인적인 용도에 적합합니다.

프로덕션 에이전트(24/7 폴링, 다중 토큰 모니터링, 대규모 백테스트)의 경우 x402.tunedfor.ai의 유료 REST 엔드포인트를 사용하세요. REST의 특징은 다음과 같습니다:

x402 프로토콜을 통해 Base 또는 Solana에서 USDC로 호출당 결제
API 키 없음 — 에이전트가 로컬에서 결제에 서명하며, 개인 키는 기기를 벗어나지 않음
속도 제한 없음 — 사용한 만큼만 지불
구독 없음 — 월 최소 결제 금액 없음

모든 MCP 클라이언트에서 apiInfo를 호출하여 현재 가격표, 마이그레이션 가이드 및 SDK 예시를 확인하세요.

x402 결제 작동 방식 (REST 티어)

에이전트가 유료 REST 엔드포인트를 호출할 때:

첫 번째 요청 시 가격과 함께 HTTP 402 Payment Required가 반환됩니다.
에이전트가 로컬에서 USDC 결제에 서명합니다(개인 키는 에이전트를 벗어나지 않음).
에이전트가 결제 헤더를 첨부하여 재요청합니다.
서버가 온체인 결제를 확인하고 데이터를 반환합니다.

계정, API 키, 신용카드가 필요 없습니다. 오직 USDC와 지갑만 있으면 됩니다.

데이터 소스

가격 + 티커: OKX, Coinbase 공개 API
펀딩 / OI / 청산: Coinalyze (상업용 라이선스)
온체인 지표, 거래소 흐름, 고래 비율: Santiment (상업용 라이선스)
거래소 간 주문 흐름 (CVD, 고래 바, 청산 집계): 20개 거래소의 WebSocket 집계 데이터를 InfluxDB로 전송하여 1분 단위 바 데이터로 정규화
매크로 컨텍스트 (DXY, VIX, 국채 수익률): FRED + Finviz
공포 & 탐욕 지수: alternative.me

거래소의 원시 틱 데이터를 재배포하는 것이 아니라, 파생 및 계산된 집계 데이터를 제공합니다.

링크

서비스: x402.tunedfor.ai
REST 문서: x402.tunedfor.ai/catalog
빠른 시작: x402.tunedfor.ai/llms.txt
npm: @tunedforai/x402-mcp
Smithery: smithery.ai/server/@tunedforai/x402-mcp
이슈 / 요청: github.com/tunedforai/x402-mcp/issues
x402 프로토콜: x402.org

x402 crypto market structure