x402-mcp
@speccy/x402-mcp
MCP 서버는 Speccy의 유료 x402 엔드포인트를 래핑합니다. 어떤 MCP 호환 AI 에이전트에든 두 가지 슈퍼파워 도구(예측 시장 데이터와 샌드박스 Python 실행기)를 제공하면, 서버가 사용자를 대신하여 Base에서 호출당 USDC로 결제합니다.
에이전트는 x402에 대한 지식이 필요 없습니다. 에이전트 측 지갑 설정도 필요 없습니다. 서버를 설치하고 에이전트를 연결하기만 하면 끝입니다.
도구
도구 | 설명 | 호출당 비용 |
| Polymarket의 상위 예측 시장 (volume, liquidity 또는 startDate 정렬) | $0.01 USDC |
| 격리된 Docker 샌드박스에서 Python 3.12 코드 실행 (네트워크 없음, 읽기 전용 파일 시스템, 30초 타임아웃, 64KB 출력) | $0.02 USDC |
Related MCP server: Polymarket MCP Server
설치
npm install -g @speccy/x402-mcp구성
운영자 지갑 키(호출당 x402를 지불하는 지갑)를 설정하세요:
export SPECCY_MCP_WALLET_KEY="0x..." # operator wallet private key선택적 재정의:
SPECCY_MCP_API_BASE(기본값https://api.speccy.cloud) — Polymarket 엔드포인트SPECCY_MCP_EXEC_BASE(기본값https://exec.speccy.cloud) — 샌드박스 실행 엔드포인트
MCP 호환 에이전트에 연동
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"speccy-x402": {
"command": "speccy-x402-mcp",
"env": { "SPECCY_MCP_WALLET_KEY": "0x..." }
}
}
}모든 MCP 클라이언트 (stdio):
SPECCY_MCP_WALLET_KEY=0x... speccy-x402-mcp아키텍처
[Agent] → MCP tool call (stdio) → [this server] → x402 paid fetch → [Speccy endpoint on VPS]
→ [CDP facilitator] → on-chain USDC transfer서버는 하나의 운영자 지갑을 보유합니다. 각 호출은 해당 지갑에서 x402 결제를 트리거합니다. 정산 알림은 Notifier 을 통해 운영자의 Telegram으로 전송됩니다(HTTP 엔드포인트와 동일한 백엔드를 사용함).
참고 사항
지갑 키는 운영자의 머신을 벸어나지 않습니다(구성 파일이 아닌 환겨 변수).
Base 메인넷(
eip155:8453)에서 지갑에 USDC와 마진용 소량의 ETh를 충전하세요(ETh는 지갑이 x402가 아닌 전송을 수형하는 경우에만 사용됨).현제 Base 메인넷에서만 정산됩니다. 테스트넷/기타 체인을 사용하려면
X402_NETWORK환경 변수와 일치하는 facilitator가 필요합니다.각 호출은 독립적이고 상태가 없습니다. 세션도 서버 상태도 없습니다.
소스 / 이슈
소스: github.com/speccy-ai/x402-mcp (자리 표시자)
이슈 / 기능 요청: 저장소에 이슈를 열거나 Telegram에서 @SpeccyNotifierbot에게 메시지를 보내세요
라이선스
MIT — Speccy를 위해 Philip (Esla)이 작성함.
Available Tools
2 toolsexec_pythonA
Run Python code in an isolated Docker sandbox. Costs $0.02 USDC per execution. No network, read-only filesystem, 30s timeout, 64KB output cap.
Inputs: code (required).
get_prediction_marketsB
Get top Polymarket prediction markets. Costs $0.01 USDC per call (x402 settled in background).
Inputs: sort, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools are completely distinct in purpose: one fetches Polymarket prediction markets, the other executes Python code. There is no realistic risk of an agent confusing them.
Both tool names follow the same lowercase snake_case verb_noun pattern: get_prediction_markets and exec_python. The naming is predictable and consistent.
Two tools is on the thin side, and the tools are unrelated, making the server feel like a loose collection rather than a focused toolkit. The count is not unreasonable for a paid utility server, but it is borderline.
The tools have no shared domain and each is a single isolated operation. get_prediction_markets only returns top markets with no drill-down or follow-up actions, and exec_python is a one-off sandbox execution primitive. The broader x402 workflow is unclear, leaving significant gaps.
Maintenance
Related MCP Connectors
Market data and web intelligence for AI agents, paid per call in USDC on Base via x402.
Market and on-chain crypto data for AI agents. Pay per call in USDC on Base (x402).
17 pay-per-call web, finance, legal and onchain tools for AI agents. USDC on Base via x402/MPP.
Pay-per-call crypto market intelligence for AI agents. USDC on Base via x402.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI agents to discover and analyze prediction markets, execute trades, and manage positions on Polymarket via the Model Context Protocol.786 npm22MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to query Polymarket data such as top wallets, live trades, market details, and smart money flows using natural language through MCP tools.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to access crypto prices, DeFi yields, Polymarket data, Base chain info, and security scans with pay-per-call via USDC on Base mainnet.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to autonomously trade, analyze, and manage positions on Polymarket prediction markets with 45 tools, real-time WebSocket monitoring, and enterprise-grade safety features.MIT