English Français العربية

Paid MCP Metering

Registre officiel Autres

Metered MCP tools: free discovery over MCP; per-call execution settled in USDC via x402 v2.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http paid-mcp-metering 'https://paid-mcp-metering-clsiojdd7-benlafreniere6-3913s-projects.vercel.app/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "paid-mcp-metering": {
            "type": "http",
            "url": "https://paid-mcp-metering-clsiojdd7-benlafreniere6-3913s-projects.vercel.app/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. paid-mcp-metering
  2. Live deployment
  3. Tools
  4. Rails
  5. Run
  6. Registry
  7. License

paid-mcp-metering

Metered MCP tools, priced per call.

Discovery is free: POST /mcp speaks JSON-RPC 2.0 per the Model Context Protocol (initialize, tools/list, ping). Execution is metered: POST /v1/t/{tool} sits behind an x402 v2 paywall. An unpaid request gets HTTP 402 with payment requirements; a paid request carries a PAYMENT-SIGNATURE header and settles USDC through the facilitator before the tool runs.

Live deployment

Base URL: https://paid-mcp-metering.vercel.app

  • GET /health — free, public
  • POST /mcp — free discovery
  • POST /v1/t/{tool} — metered; currently answers 503 settlement_not_configured because X402_PAY_TO is unset on the deployment (settlementConfigured:false in /health is the honest switch). No payment can be accepted until a receiving address is configured.

server.json declares this URL as the registry remote.

Tools

ToolPriceWhat it returns
web_search$0.001/callRanked live web results with source URLs
deep_research$0.01/callMulti-source research pass with a synthesized answer plus cited sources

Upstreams are Exa (primary) and Tavily (fallback). Every handler returns live upstream output or throws — there is no canned response.

Rails

x402 v2, USDC, EIP-155 network selected by X402_NETWORK (default Base Sepolia testnet, CAIP-2 eip155:84532). Facilitator defaults to https://x402.org/facilitator.

Env varPurpose
X402_PAY_TOReceiving address. Required for settlement; unset serves 402 requirements only
X402_NETWORKCAIP-2 network id (default eip155:84532)
X402_FACILITATOR_URLx402 facilitator endpoint
EXA_API_KEY / TAVILY_API_KEYSearch upstream credentials

Run

npm install
npm run build
npm start          # node dist/x402-server.js
npm test           # build + node --test dist/test-x402.js

Free discovery:

curl -s localhost:4021/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Paid execution:

curl -s localhost:4021/v1/t/web_search -H 'Content-Type: application/json' \
  -d '{"query":"x402 protocol","max_results":3}'
# -> 402 with payment requirements; pay via an x402 client and retry with PAYMENT-SIGNATURE

Registry

server.json targets the official MCP Registry as io.github.dev55acc-ai/paid-mcp-metering. Tagging v* runs .github/workflows/publish-mcp.yml: tests, build, npm publish (when NPM_TOKEN is set), then registry publish authenticated by GitHub OIDC — no stored registry credential.

License

MIT

Questions fréquentes

Qu'est-ce que Paid MCP Metering ?

Metered MCP tools: free discovery over MCP; per-call execution settled in USDC via x402 v2.

Comment installer Paid MCP Metering ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http paid-mcp-metering 'https://paid-mcp-metering-clsiojdd7-benlafreniere6-3913s-projects.vercel.app/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Paid MCP Metering ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Paid MCP Metering est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Paid MCP Metering ?

Il est publié par dev55acc-ai. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.