x402engine

oficial

Mais de 50 APIs de pagamento por chamada para agentes de IA via micropagamentos cripto HTTP 402. $0,001–$0,12 por chamada com USDC e USDm.

GitHub

O que você pode fazer com x402engine MCP?

Descubra APIs pagas disponíveis — navegue pelo catálogo ativo do gateway com discover_services para encontrar endpoints de LLM, imagem, cripto, viagens e outros com pagamento por requisição.
Verifique a integridade do serviço antes de pagar — use service_health para verificar se um endpoint está acessível e veja seus preços atuais sem gastar.
Gere imagens sob demanda — chame generate_image para criar imagens geradas por IA, com pagamento automático em USDC na Base ou Solana.
Execute código em um sandbox — execute trechos via execute_code e pague por execução através do protocolo x402.
Obtenha preços de criptomoedas e dados de mercado — consulte get_crypto_price, get_crypto_markets ou get_trending_crypto para informações em tempo real sobre tokens e mercado.
Pesquise voos e hotéis — use search_flights, search_hotels ou search_locations para consultar opções de viagem com cobrança por requisição.

Documentação

x402engine-mcp

Servidor MCP amigável para agentes do x402engine. Ele permite que agentes descubram e chamem APIs de pagamento por requisição via HTTP 402, com pagamento automático em USDC na Base ou Solana.

O gateway ativo cobre LLMs, geração de imagem e vídeo, busca e raspagem web, execução de código, dados de cripto e carteiras, simulação de transações, áudio, viagens e IPFS. Este MCP expõe um conjunto curado de ferramentas e descoberta ao vivo para o catálogo completo.

Início Rápido

Use uma carteira pagadora dedicada e com saldo baixo. O MCP assina pagamentos x402 localmente e nunca envia a chave privada para o 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"
      }
    }
  }
}

Financie a carteira com USDC na Base. O facilitador x402 paga o gás da transação; a carteira assina uma autorização 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"
      }
    }
  }
}

Financie a carteira com USDC na Solana e SOL suficiente para as taxas de transação.

Descoberta Sem Carteira

O servidor inicia sem uma carteira, e ferramentas gratuitas como discover_services e service_health ainda funcionam. Ferramentas pagas retornam seus requisitos de pagamento x402 até que uma carteira seja configurada.

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

Controles de Pagamento

Variável	Padrão	Descrição
`X402_EVM_PRIVATE_KEY`	não definida	Chave pagadora dedicada para USDC na Base
`X402_SOLANA_PRIVATE_KEY`	não definida	Chave pagadora Base58 ou JSON para USDC na Solana
`X402_PAYMENT_NETWORK`	`auto`	`auto`, `base` ou `solana`
`X402_MAX_PAYMENT_USD`	`1.00`	Limite rígido de gasto por requisição
`X402_BASE_URL`	gateway de produção	Substitui a URL do gateway
`X402_PAYMENT_HEADER`	não definido	Cabeçalho x402 pré-assinado legado
`X402_DEV_BYPASS`	não definido	Segredo de bypass para desenvolvimento

No modo auto, a Base é preferida quando ambas as chaves estão configuradas. O pagamento automático aceita apenas os contratos USDC canônicos na Base e Solana. Ele rejeita ativos desconhecidos, redes não suportadas e valores acima do limite configurado antes de assinar.

MegaETH permanece disponível para clientes que forneçam seu próprio cabeçalho de pagamento compatível.

Ferramentas MCP

Categoria	Ferramentas
Descoberta	`discover_services`, `service_health`
Imagem e código	`generate_image`, `execute_code`
Áudio	`transcribe_audio`
Cripto	`get_crypto_price`, `get_crypto_markets`, `get_crypto_history`, `get_trending_crypto`, `search_crypto`, `get_crypto_categories`
Carteira e token	`get_wallet_balances`, `get_wallet_transactions`, `get_wallet_pnl`, `get_token_prices`, `get_token_metadata`
IPFS	`pin_to_ipfs`, `get_from_ipfs`
Viagens	`search_flights`, `search_locations`, `search_hotels`, `search_cheapest_dates`

Os preços estão incluídos na descrição de cada ferramenta e na descoberta ao vivo. O catálogo do gateway pode mudar independentemente deste pacote.

Descoberta

Descoberta do gateway: /.well-known/x402.json
Cartão do agente: /.well-known/agent.json
Manifesto do endpoint: /.well-known/agent-manifest.v1.json
API de serviços: /api/services
Metadados do pacote: server.json

Desenvolvimento

npm install
npm test
npm run build