x402engine

официальный

50+ API с оплатой за вызов для AI-агентов через HTTP 402 криптомикроплатежи. $0.001–$0.12 за вызов с USDC и USDm.

Что можно делать с x402engine MCP?

Discover paid APIs — Попросите ассистента вывести список доступных сервисов с оплатой за запрос через discover_services и проверьте их статус с помощью service_health.
Generate images and run code — Запросите создание изображений через generate_image или выполнение кода через execute_code с автоматической оплатой в USDC на Base или Solana.
Query crypto and wallet data — Получайте цены, рыночные тренды, балансы кошельков, транзакции и метаданные токенов с помощью таких инструментов, как get_crypto_price и get_wallet_balances.
Process audio and IPFS — Транскрибируйте аудиофайлы через transcribe_audio или закрепляйте и получайте контент из IPFS с помощью pin_to_ipfs и get_from_ipfs.
Search travel options — Ищите авиарейсы, отели, локации и самые дешёвые даты поездок с помощью таких инструментов, как search_flights и search_hotels.

Документация

x402engine-mcp

Дружественный к агентам MCP-сервер для x402engine. Он позволяет агентам обнаруживать и вызывать API с оплатой за запрос через HTTP 402, с автоматической оплатой в USDC на Base или Solana.

Живой шлюз охватывает LLM, генерацию изображений и видео, веб-поиск и скрапинг, выполнение кода, крипто- и кошельковые данные, симуляцию транзакций, аудио, путешествия и IPFS. Этот MCP предоставляет курируемый набор инструментов и живое обнаружение для полного каталога.

Быстрый старт

Используйте выделенный кошелек плательщика с низким балансом. MCP подписывает x402-платежи локально и никогда не отправляет приватный ключ в x402engine.

Base

{
  "mcpServers": {
    "x402engine": {
      "command": "npx",
      "args": ["-y", "x402engine-mcp@1.1.1"],
      "env": {
        "X402_EVM_PRIVATE_KEY": "0xYOUR_DEDICATED_PAYER_KEY",
        "X402_PAYMENT_NETWORK": "base",
        "X402_MAX_PAYMENT_USD": "1.00"
      }
    }
  }
}

Пополните кошелек USDC на Base. Фасилитатор x402 оплачивает газ транзакций; кошелек подписывает авторизацию USDC EIP-3009.

Solana

{
  "mcpServers": {
    "x402engine": {
      "command": "npx",
      "args": ["-y", "x402engine-mcp@1.1.1"],
      "env": {
        "X402_SOLANA_PRIVATE_KEY": "YOUR_BASE58_OR_JSON_PRIVATE_KEY",
        "X402_PAYMENT_NETWORK": "solana",
        "X402_MAX_PAYMENT_USD": "1.00"
      }
    }
  }
}

Пополните кошелек USDC на Solana и достаточным количеством SOL для комиссий за транзакции.

Обнаружение без кошелька

Сервер запускается без кошелька, и бесплатные инструменты, такие как discover_services и service_health, продолжают работать. Платные инструменты возвращают свои требования к оплате x402, пока не настроен кошелек.

claude mcp add x402engine -- npx -y x402engine-mcp@1.1.1

Hermes Agent

Установите навык x402engine и объедините этот сервер в активный профиль Hermes через config.yaml:

mcp_servers:
  x402engine:
    command: npx
    args: ["-y", "x402engine-mcp@1.1.1"]
    env:
      X402_BASE_URL: "https://x402engine.app"
      X402_PAYMENT_NETWORK: "auto"
      X402_MAX_PAYMENT_USD: "0.10"

Начните новую сессию и вызовите discover_services или service_health; оба бесплатны. Держите сеть на auto, пока не настроен кошелек. Для платежей на Base сохраните X402_EVM_PRIVATE_KEY в локальном .env профиля, добавьте X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}" в env сервера и измените сеть на base. Никогда не помещайте ключи кошелька в чат. Лимит применяется к каждому запросу; авторизуйте отдельный общий бюджет для каждой задачи.

Полное руководство по настройке Hermes · Устанавливаемый навык

Контроль платежей

Переменная	По умолчанию	Описание
`X402_EVM_PRIVATE_KEY`	не задано	Выделенный ключ плательщика для Base USDC
`X402_SOLANA_PRIVATE_KEY`	не задано	Ключ плательщика Base58 или JSON для Solana USDC
`X402_PAYMENT_NETWORK`	`auto`	`auto`, `base` или `solana`
`X402_MAX_PAYMENT_USD`	`1.00`	Жесткий лимит расходов на запрос
`X402_BASE_URL`	production gateway	Переопределить URL шлюза
`X402_PAYMENT_HEADER`	не задано	Устаревший предварительно подписанный заголовок x402
`X402_DEV_BYPASS`	не задано	Секрет обхода для разработки

В режиме auto Base предпочтителен, когда настроены оба ключа. Автоматическая оплата принимает только канонические контракты USDC на Base и Solana. Она отклоняет неизвестные активы, неподдерживаемые сети и суммы выше настроенного лимита до подписания.

MegaETH остается доступным для клиентов, которые предоставляют свой собственный совместимый платежный заголовок.

Инструменты MCP

Категория	Инструменты
Обнаружение	`discover_services`, `service_health`
Изображения и код	`generate_image`, `execute_code`
Аудио	`transcribe_audio`
Крипто	`get_crypto_price`, `get_crypto_markets`, `get_crypto_history`, `get_trending_crypto`, `search_crypto`, `get_crypto_categories`
Кошелек и токены	`get_wallet_balances`, `get_wallet_transactions`, `get_wallet_pnl`, `get_token_prices`, `get_token_metadata`
IPFS	`pin_to_ipfs`, `get_from_ipfs`
Путешествия	`search_flights`, `search_locations`, `search_hotels`, `search_cheapest_dates`

Цены включены в описание каждого инструмента и в живое обнаружение. Каталог шлюза может меняться независимо от этого пакета.

Обнаружение

Обнаружение шлюза: /.well-known/x402.json
Карточка агента: /.well-known/agent.json
Манифест конечных точек: /.well-known/agent-manifest.v1.json
API сервисов: /api/services
Метаданные пакета: server.json

Разработка

npm install
npm test
npm run build

Ссылки

Веб-сайт: x402engine.app
npm: x402engine-mcp
GitHub: agentc22/x402engine-mcp
Протокол: x402.org