x402-mcp

x402-mcp: платежи USDC на Base, проверка соответствия объектов и Agent ID для автономных агентов

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

Что умеет

  • Искать платные API в каталоге x402 Bazaar
  • Проверять условия оплаты 402 без списания средств
  • Оплачивать USDC и получать защищённый ресурс за один вызов
  • Проверять соответствие объекта нормативам конкретного города
  • Смотреть метрики сети Base и активность газа

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

Платежи выполняются приватным ключом EVM, заданным на хостинге сервера; без ключа доступны только режимы проверки без списания.

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

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

MCP-сервер даёт агенту инструменты для экономической самостоятельности: поиск и оплата платных HTTP-ресурсов через x402 в USDC на Base, проверка соблюдения нормативов объектов недвижимости по городам США, оценка комиссий газа и работа с идентификационными карточками агентов для взаимной проверки. Требует приватный ключ EVM на хостинге для реальных платежей.

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

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

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

https://x402-mcp--kwizzlesurp10.run.tools

  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--kwizzlesurp10.run.tools

  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--kwizzlesurp10.run.tools

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

Вручную:

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

Авторизация

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

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

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

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.
commerce.stripe_checkoutCreate a Stripe Checkout Session for Pro tier or tool credits (fiat rail). Use when the buyer pays by card instead of USDC; webhook fulfills the grant.
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 portfolio revenue intelligence: spend, revenue, LTV:CAC, margins, per-source scores. 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.