x402-mcp

x402-mcp — микроплатежи в USDC на Base для оплаты и монетизации HTTP API

От сообществаСбоиБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Находить и проверять платные API по протоколу x402
  • Оплачивать запрос и получать результат
  • Настраивать продавца и проверять оплату
  • Активировать подписку Pro и покупать кредиты
  • Отправлять письма и проверять статус доставки

Какие данные видит

Ассистент работает с кошельком USDC на Base и данными платежей, которые пользователь подтверждает сам.

Нужен ли аккаунт

Не нужен: сервер работает без входа

x402-mcp реализует протокол x402 для оплаты сторонних API и приёма платежей за собственные. MCP-сервер позволяет ассистенту находить платные эндпоинты, оплачивать запросы в USDC на сети Base, настраивать продавца и отслеживать метрики и выручку.

Как подключить

Как подключить x402-mcp к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://x402-mcp.onrender.com/mcp/mcp

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить x402-mcp к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://x402-mcp.onrender.com/mcp/mcp

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить x402-mcp к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://x402-mcp.onrender.com/mcp/mcp

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (23)

Технические названия из tools/list. Нужны только разработчикам.

x402.agent_cardReturn the A2A Protocol v1.0 Agent ID Card and MCP server card. Optional target_id filters to a skill id, name, or tag.
get_agent_cardBack-compat alias for x402.agent_card. Returns the A2A Protocol v1.0 Agent ID Card and MCP server card.
x402.discoverDiscover paid HTTP APIs in the x402 Bazaar via the facilitator catalog. Call this first to find a resource URL, then x402.probe and x402.pay_and_fetch.
x402.probeProbe a URL for HTTP 402 PAYMENT-REQUIRED terms using the x402 client SDK. Use before x402.pay_and_fetch to inspect price, network, and payTo without spending.
x402.pay_and_fetchPay USDC via x402 and fetch a protected HTTP resource in one call. Requires EVM_PRIVATE_KEY on this host; otherwise use x402.probe for a no-spend 402.
x402.build_sellerBuild seller-side x402 payment requirements for your own HTTP resource. Pass resource_url plus discovery_* fields to catalog the endpoint in Bazaar.
x402.verifyVerify an x402 PAYMENT-SIGNATURE against PAYMENT-REQUIRED terms via the facilitator. Call after a buyer presents a signature and before releasing paid content.
x402.networksList supported settlement networks, facilitators, and x402 v2 header names. Call when choosing a preferred_network for x402.pay_and_fetch or x402.build_seller.
commerce.pro_requirementsBuild x402 payment requirements to purchase the Pro quota tier. Next: pay those terms, then commerce.activate_pro with the signature.
commerce.activate_proVerify a Pro-tier x402 payment and unlock Pro quota limits for the agent. Call after commerce.pro_requirements and a completed USDC payment.
commerce.credits_requirementsBuild x402 payment requirements to buy a pack of per-use MCP tool credits. Next: pay those terms, then commerce.purchase_credits with the signature.
commerce.purchase_creditsVerify an x402 payment and add per-use tool credits to the agent. Call after commerce.credits_requirements and a completed USDC payment.
swarm.researchRun the swarm agency: compose a research product from free inputs and list it for resale. Pass allow_paid_inputs=true only when buying upstream x402 services is intended.
swarm.settleVerify and settle a buyer's x402 payment for a listed composite product and record revenue. Call with product_id plus PAYMENT-SIGNATURE after the buyer pays.
swarm.revenueGet swarm composite economics: spend, composite sales, LTV:CAC, margins, per-source scores. total_revenue_usdc is swarm listings only; storefront.revenue_usdc is the full settled ledger. Call after swarm.research or swarm.settle to inspect realized economics.
pulse.baseGet live Base Network Pulse: base fee, EIP-1559 projection, utilization, USD settlement cost, verdict. Call before settling on Base when you need a settle-now vs hold recommendation.
ops.metricsGet host OS telemetry: CPU, memory, swap, disk, network, and an ok/warn/critical health verdict. Call to diagnose this MCP host; set include_processes=true for top memory processes.
city.listList US City Open-Data Compliance Network cities with paid_url, sample_url, and price. Call first, then city.sample, then city.check for the paid address lookup.
city.sampleGet a free fixed-address property compliance sample for one US city code. Use before city.check to validate city_code and response shape without paying.
city.checkRun a paid US city property compliance check via x402 on the same HTTP resource buyers use. Prefer city.sample first. Settles USDC when EVM_PRIVATE_KEY is set; otherwise returns a 402 probe. Price: $0.01 per call (x402, USDC on Base/Solana/Arbitrum).
mailrail.sendDispatch transactional receipts, alert notifications, or agent communication over MailRail. Supports mock ledger, Resend API, SMTP, or Webhooks.
mailrail.statusInspect MailRail provider status, active sender address, and dispatch capabilities.
mailrail.inboundIngest an incoming message or webhook to the MailRail Postmaster agent with mention defusing and inbox ledger recording.