x402-mcp

AI 에이전트를 위한 거래소 간 암호화폐 시장 구조. 20개 거래소, 26개 토큰, 6개 도구 - 스냅샷, 오더플로우, 매크로 체제, 전체 분석, 주소 위험 및 API 정보. MCP를 통해 무료 제공.

👁 npm version
👁 License: MIT

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

설치

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

Related MCP server: AgentPay x402 — Economic-intelligence layer for AI Agents

도구

6개의 도구 모두 상태 비저장(stateless)입니다. API 키, 인증, 설정이 필요 없습니다. 그냥 호출하세요.

토큰 커버리지

스냅샷 계층의 주요 L1 및 L2: BTC, ETH, SOL, XRP, BNB, DOGE, ADA, AVAX, LINK, ATOM, DOT, ARB, SUI, OP, LTC.

확장 오더플로우 계층: 위 항목에 더해 NEAR, AAVE, BCH, HBAR, SHIB, TON, TRX, UNI, XLM.

공식적인 최신 목록은 모든 MCP 클라이언트에서 apiInfo를 호출하세요.

예시

거래 전 확인

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.

무료 MCP vs 유료 REST

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

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

• x402 프로토콜을 통해 Base 또는 Solana에서 USDC로 호출당 결제

• API 키 없음 — 에이전트가 로컬에서 결제에 서명하며, 개인 키는 기기를 떠나지 않음

• 지갑당 분당 60회 호출 및 시간당 200회 호출로 속도 제한 — 무분별한 사용 방지; 초과 시 429 오류 반환

• 구독 없음 — 월 최소 결제 금액 없음

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

x402 결제 작동 방식 (REST 계층)

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

1. 첫 번째 요청은 가격과 함께 HTTP 402 Payment Required를 반환합니다.

2. 에이전트가 로컬에서 USDC 결제에 서명합니다(개인 키는 에이전트를 떠나지 않음).

3. 에이전트가 결제 헤더를 첨부하여 재시도합니다.

4. 서버가 온체인 결제를 확인하고 데이터를 반환합니다.

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

데이터 소스

• 가격 + 티커: OKX, Coinbase 공개 API

• 펀딩 / OI / 청산: Coinalyze (상업용 라이선스)

• 온체인 지표, 거래소 흐름, 고래 비율: 라이선스된 제3자 기관 데이터

• 거래소 간 오더플로우(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

라이선스

MIT © Tuned For AI

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• addressRiskB
• apiInfoB
• history1dA
• history1hA
• history5mB
• marketAnalyzeC
• marketFullB
• marketOrderflowC