x402engine
официальный50+ API с оплатой за вызов для AI-агентов через HTTP 402 криптомикроплатежи. $0.001–$0.12 за вызов с USDC и USDm.
Что можно делать с x402engine MCP?
- Обнаружение доступных платных API — просмотрите живой каталог шлюзов с помощью
discover_services, чтобы найти конечные точки для LLM, изображений, криптовалют, путешествий и других сервисов с оплатой за запрос. - Проверка работоспособности сервиса перед оплатой — используйте
service_health, чтобы убедиться, что конечная точка доступна, и узнать текущие цены без затрат. - Генерация изображений по запросу — вызывайте
generate_imageдля создания изображений с помощью ИИ с автоматической оплатой в USDC на Base или Solana. - Выполнение кода в изолированной среде — запускайте фрагменты кода через
execute_codeи оплачивайте каждое выполнение по протоколу x402. - Получение цен на криптовалюты и рыночных данных — запрашивайте
get_crypto_price,get_crypto_marketsилиget_trending_cryptoдля получения информации о токенах и рынке в реальном времени. - Поиск авиарейсов и отелей — используйте
search_flights,search_hotelsилиsearch_locationsдля поиска вариантов путешествий с оплатой за каждый запрос.
Документация
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.0"],
"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.0"],
"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.0
Управление платежами
| Переменная | По умолчанию | Описание |
|---|---|---|
X402_EVM_PRIVATE_KEY | не задано | Выделенный ключ плательщика для USDC на Base |
X402_SOLANA_PRIVATE_KEY | не задано | Ключ плательщика в Base58 или JSON для USDC на Solana |
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