Skip to main content
Glama
x402-mcp

x402-mcp

by Speccy-Agent

@speccy/x402-mcp

MCP 서버는 Speccy의 유료 x402 엔드포인트를 래핑합니다. 어떤 MCP 호환 AI 에이전트에든 두 가지 슈퍼파워 도구(예측 시장 데이터와 샌드박스 Python 실행기)를 제공하면, 서버가 사용자를 대신하여 Base에서 호출당 USDC로 결제합니다.

에이전트는 x402에 대한 지식이 필요 없습니다. 에이전트 측 지갑 설정도 필요 없습니다. 서버를 설치하고 에이전트를 연결하기만 하면 끝입니다.

도구

도구

설명

호출당 비용

get_prediction_markets

Polymarket의 상위 예측 시장 (volume, liquidity 또는 startDate 정렬)

$0.01 USDC

exec_python

격리된 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 tools
exec_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

    A3.7/5.0

    Scored across 2 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    Both tool names follow the same lowercase snake_case verb_noun pattern: get_prediction_markets and exec_python. The naming is predictable and consistent.

    Tool Count3/5

    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.

    Completeness2/5

    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

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to discover and analyze prediction markets, execute trades, and manage positions on Polymarket via the Model Context Protocol.
      7
      86 npm
      22
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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