TestRaptor x402 MCP

Serveur MCP exposant les API payantes de TestRaptor en paiement à l'unité x402 (USDC sur Solana, gas sponsorisé) : aucun compte, aucune clé API, aucun abonnement. Un agent IA appelle l'outil, paie quelques centimes, reçoit le résultat.

Outils (5)

Related MCP server: MCP RAG Agent Server

Modes de paiement

Le serveur lit sa configuration dans l'environnement. Deux modes (dans l'ordre de priorité) :

1. Crédit prépayé — X402_CREDIT_TOKEN : un jeton opaque obtenu via un top-up (credit_topup ou bundle_check). Chaque appel débite le crédit sans transaction Solana. Idéal pour un volume élevé.

2. Wallet payeur — X402_PAYER_KEY_B64 : clé privée Solana (64 octets, base64) d'un wallet financé en USDC (pas de SOL requis : le gas est sponsorisé par le facilitateur). Chaque appel règle sa transaction x402 automatiquement.

Sans l'un ni l'autre, les outils renvoient le challenge 402 décodé (montant, adresse payTo, réseau) afin que l'agent comprenne ce qui est demandé.

Variables d'environnement

Installation

Claude Desktop

{
  "mcpServers": {
    "testraptor": {
      "command": "npx",
      "args": ["-y", "testraptor-x402-mcp"],
      "env": {
        "X402_PAYER_KEY_B64": "<votre clé privée base64>",
        "X402_TRUSTED_PAYTO": "84uuBKFPR5rYMCrJQkW5unKUebozV1xwdY5UPxBWyFvr"
      }
    }
  }
}

Cursor / autres clients stdio

Ajoutez la même entrée command: npx, args: ["-y", "testraptor-x402-mcp"] avec vos env.

Local

git clone https://github.com/maximethemens-code/testraptor-x402-mcp && cd testraptor-x402-mcp && npm install
X402_PAYER_KEY_B64=... npm start   # npm start = node src/index.js

Exemple d'appel

certs_check_now { domain: "exemple.ca" }
→ { "ok": true, ... rapport de vérification TLS ... }   (0,002 $ USDC débité)

Sécurité

• X402_PAYER_KEY_B64 n'est jamais transmis au serveur : il ne sert qu'à signer la transaction localement.

• X402_TRUSTED_PAYTO est fortement recommandé : il empêche le wallet de payer un destinataire inattendu (ex. si X402_BASE_URL pointe vers un serveur malveillant).

• Le wallet de paiement doit être distinct du wallet de réception (payTo).

Limites connues

• heartbeat_create_monitor exige un compte TestRaptor connecté (SSO) côté backend : un agent anonyme recevra 401 après le paiement.

• Le règlement réel on-chain (verify/settle via Dexter) n'est exercé qu'avec un wallet effectivement financé en USDC.