paid-mcp-metering

Тарифицируемые MCP-инструменты с оплатой за каждый вызов.

Обнаружение бесплатно: POST /mcp работает по JSON-RPC 2.0 в соответствии с Model Context Protocol (initialize, tools/list, ping). Выполнение тарифицируется: POST /v1/t/{tool} находится за платёжным барьером x402 v2. Неоплаченный запрос получает HTTP 402 с платёжными требованиями; оплаченный запрос несёт заголовок PAYMENT-SIGNATURE и до вызова инструмента проводит расчёт в USDC через фасилитатора.

Инструменты

Внешние источники (upstream) — Exa (основной) и Tavily (резервный). Каждый обработчик возвращает живые данные провайдера или выбрасывает исключение — заготовленных ответов нет.

Related MCP server: Base Intel Search

Платёжные рельсы

x402 v2, USDC, сеть EIP-155, выбираемая переменной X402_NETWORK (по умолчанию — тестовая сеть Base Sepolia, CAIP-2 eip155:84532). Фасилитатор по умолчанию — https://x402.org/facilitator.

Запуск

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

Бесплатное обнаружение:

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

Платное выполнение:

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

Реестр

server.json задаёт идентификатор официального MCP Registry — io.github.dev55acc-ai/paid-mcp-metering. Создание тега v* запускает .github/workflows/publish-mcp.yml: тесты, сборка, публикация в npm (если установлен NPM_TOKEN), затем публикация в реестре с аутентификацией через GitHub OIDC — без хранения учётных данных реестра.

Лицензия

MIT