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 — Peça ao seu assistente para listar serviços disponíveis por requisição via discover_services e verifique o status deles com service_health.
Gere imagens e execute código — Solicite criação de imagens com generate_image ou execução de código com execute_code, com pagamento automático em USDC na Base ou Solana.
Consulte dados de cripto e carteiras — Obtenha preços, tendências de mercado, saldos de carteiras, transações e metadados de tokens usando ferramentas como get_crypto_price e get_wallet_balances.
Processe áudio e IPFS — Transcreva arquivos de áudio com transcribe_audio, ou fixe e recupere conteúdo do IPFS usando pin_to_ipfs e get_from_ipfs.
Pesquise opções de viagem — Encontre voos, hotéis, locais e datas de viagem mais baratas com ferramentas como search_flights e search_hotels.

Documentação

x402engine-mcp

Servidor MCP amigável para agentes, projetado para 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 ao vivo cobre LLMs, geração de imagem e vídeo, busca e raspagem na 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, 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.1"],
      "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.1"],
      "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 taxas de transação.

Descoberta Sem Carteira

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

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

Agente Hermes

Instale a habilidade x402engine e mescle este servidor no config.yaml do perfil Hermes ativo:

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"

Inicie uma nova sessão e chame discover_services ou service_health; ambos são gratuitos. Mantenha a rede em auto até que uma carteira seja configurada. Para pagamentos na Base, armazene X402_EVM_PRIVATE_KEY no .env local do perfil, adicione X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}" ao env do servidor e altere a rede para base. Nunca coloque chaves de carteira no chat. O limite se aplica por requisição; autorize um orçamento total separado para cada tarefa.

Guia completo de configuração do Hermes · Habilidade instalável

Controles de Pagamento

Variável	Padrão	Descrição
`X402_EVM_PRIVATE_KEY`	não definido	Chave pagadora dedicada para USDC na Base
`X402_SOLANA_PRIVATE_KEY`	não definido	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 canônicos de USDC 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 fornecem 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 de 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