paid-mcp-metering

Herramientas MCP con medición de uso y precio por llamada.

El descubrimiento es gratuito: POST /mcp habla JSON-RPC 2.0 según el Model Context Protocol (initialize, tools/list, ping). La ejecución se mide: POST /v1/t/{tool} está detrás de un muro de pago x402 v2. Una petición no pagada recibe HTTP 402 con los requisitos de pago; una petición pagada lleva un encabezado PAYMENT-SIGNATURE y liquida USDC a través del facilitador antes de que la herramienta se ejecute.

Herramientas

Los proveedores son Exa (principal) y Tavily (respaldo). Cada handler devuelve la salida directa del upstream o lanza una excepción: no hay respuestas predeterminadas.

Related MCP server: Base Intel Search

Vías de pago

x402 v2, USDC, red EIP-155 seleccionada por X402_NETWORK (por defecto la testnet de Base Sepolia, CAIP-2 eip155:84532). El facilitador por defecto es https://x402.org/facilitator.

Ejecutar

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

Descubrimiento gratuito:

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

Ejecución de pago:

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

Registro

server.json apunta al Registro MCP oficial identificado como io.github.dev55acc-ai/paid-mcp-metering. Etiquetar v* ejecuta .github/workflows/publish-mcp.yml: pruebas, compilación, publicación npm (cuando NPM_TOKEN está definido) y publicación en el registro autenticada por GitHub OIDC: no se almacena ninguna credencial de registro.

Licencia

MIT