Skip to main content
Glama
x402-mcp

x402-mcp

by Speccy-Agent

@speccy/x402-mcp

MCP-Server, der Speccy's kostenpflichtige x402-Endpunkte kapselt. Gib jedem MCP-kompatiblen KI-Agenten zwei Superkraft-Tools – Vorhersagemarktdaten und einen Sandbox-Python-Executor – und der Server zahlt pro Aufruf in USDC auf Base in deinem Namen.

Kein x402-Wissen erforderlich für den Agenten. Kein Wallet-Setup auf der Agentenseite. E infach den Server installieren, deinen Agenten darauf zeigen, fertig.

Tools

Tool

Beschreibung

Kosten pro Aufruf

get_prediction_markets

Top-Polymarket-Vorhersagemärkte (Sortierung nach Volumen, Liquidität oder startDate)

$0.01 USDC

exec_python

Python-3.12-Code in einer isolierten Docker-Sandbox ausführen (kein Netzwerk, schreibgeschütztes Dateisystem, 30s Timeout, 64KB Ausgabe)

$0.02 USDC

Related MCP server: Polymarket MCP Server

Install

npm install -g @speccy/x402-mcp

Konfiguration

Setze den Operator-Wallet-Key fest (das Wallet, das x402 pro Aufruf zahlt):

export SPECCY_MCP_WALLET_KEY="0x..."   # operator wallet private key

Optionale Überschreibungen:

  • SPECCY_MCP_API_BASE (Standard: https://api.speccy.cloud) — Polymarket-Endpunkt

  • SPECCY_MCP_EXEC_BASE (Standard: https://exec.speccy.cloud) — Sandbox-Exec-Endpunkt

Integration in einen MCP-kompatiblen Agenten

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "speccy-x402": {
      "command": "speccy-x402-mcp",
      "env": { "SPECCY_MCP_WALLET_KEY": "0x..." }
    }
  }
}

Beliebiger MCP-Client (stdio):

SPECCY_MCP_WALLET_KEY=0x... speccy-x402-mcp

Architektur

[Agent] → MCP tool call (stdio) → [this server] → x402 paid fetch → [Speccy endpoint on VPS]
                                                                → [CDP facilitator] → on-chain USDC transfer

Der Server verwaltet ein einziges Operator-Wallet. Jeder Aufruf löst eine x402-Zahlung aus diesem Wallet aus. Abrechnungsbenachrichtigungen gehen über den Notifier-Bot an das Telegram des Operators (dasselbe Backend wie die HTTP-Endpunkte).

Hinweise

  • Der Wallet-Key verlässt niemals die Maschine des Operators (Umgebungsvariable, keine Konfigurationsdatei).

  • Fülle das Wallet mit USDC auf dem Base-Mainnet (eip155:8453) und einer winzigen Menge ETH als Margin (nur verwendet, falls das Wallet jemals Nicht-x402-Transfers durchführt).

  • Die Abrechnung erfolgt derzeit nur auf dem Base-Mainnet. Testnet / andere Chains wären eine X402_NETWORK-Umgebungsvariable und ein passender Facilitator erforderlich.

  • Jeder Aufruf ist unabhängig und zustandslos – keine Sitzungen, kein Zustand auf dem Server.

Quelle / Issues

  • Quelle: github.com/speccy-ai/x402-mcp (Platzhalter)

  • Issues / Feature-Anfragen: Öffne ein Issue im Repo oder kontaktiere @SpeccyNotifierbot per Telegram.

Lizenz

MIT – von Philip (Esla) für Speccy.

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