Paid MCP Metering

io.github.dev55acc-aiv2.0.0更新于 Sep 29, 2026

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

已验证Streamable HTTP可网页运行Other

安装

在 SourceWeft 中

  1. 打开 控制台中的 Paid MCP Metering，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "paid-mcp-metering": {
      "type": "http",
      "url": "https://paid-mcp-metering-clsiojdd7-benlafreniere6-3913s-projects.vercel.app/mcp"
    }
  }
}

README

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

bash
npm installnpm run buildnpm start          # node dist/x402-server.jsnpm test           # build + node --test dist/test-x402.js

Free discovery:

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

Paid execution:

bash
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

来源：README.md，提交 ef85ddd

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v2.0.0最新Sep 16, 2026