x402engine

oficial

Más de 50 APIs de pago por llamada para agentes de IA mediante micropagos criptográficos HTTP 402. $0.001–$0.12 por llamada con USDC y USDm.

GitHub

¿Qué puedes hacer con x402engine MCP?

Descubre APIs de pago — Pídele a tu asistente que liste los servicios disponibles de pago por solicitud mediante discover_services y verifica su estado con service_health.
Genera imágenes y ejecuta código — Solicita la creación de imágenes con generate_image o la ejecución de código con execute_code, con pago automático en USDC en Base o Solana.
Consulta datos de cripto y billeteras — Obtén precios, tendencias del mercado, saldos de billeteras, transacciones y metadatos de tokens usando herramientas como get_crypto_price y get_wallet_balances.
Procesa audio e IPFS — Transcribe archivos de audio con transcribe_audio, o ancla y recupera contenido de IPFS usando pin_to_ipfs y get_from_ipfs.
Busca opciones de viaje — Encuentra vuelos, hoteles, ubicaciones y las fechas de viaje más económicas con herramientas como search_flights y search_hotels.

Documentación

x402engine-mcp

Servidor MCP amigable para agentes de x402engine. Permite a los agentes descubrir y llamar APIs de pago por solicitud a través de HTTP 402, con pago automático en USDC en Base o Solana.

La pasarela en vivo cubre LLMs, generación de imágenes y video, búsqueda web y scraping, ejecución de código, datos de criptomonedas y billeteras, simulación de transacciones, audio, viajes e IPFS. Este MCP expone un conjunto de herramientas seleccionadas y descubrimiento en vivo para el catálogo completo.

Inicio Rápido

Usa una billetera de pago dedicada con saldo bajo. El MCP firma pagos x402 localmente y nunca envía la clave privada a 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"
      }
    }
  }
}

Fondea la billetera con USDC en Base. El facilitador x402 paga el gas de la transacción; la billetera firma una autorización 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"
      }
    }
  }
}

Fondea la billetera con USDC en Solana y suficiente SOL para las tarifas de transacción.

Descubrimiento Sin Billetera

El servidor se inicia sin billetera, y herramientas gratuitas como discover_services y service_health siguen funcionando. Las herramientas de pago devuelven sus requisitos de pago x402 hasta que se configure una billetera.

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

Agente Hermes

Instala la habilidad x402engine y fusiona este servidor en el perfil activo de Hermes en 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"

Inicia una nueva sesión y llama a discover_services o service_health; ambas son gratuitas. Mantén la red en auto hasta que se configure una billetera. Para pagos en Base, guarda X402_EVM_PRIVATE_KEY en el .env local del perfil, agrega X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}" al env del servidor y cambia la red a base. Nunca pongas claves de billetera en el chat. El límite se aplica por solicitud; autoriza un presupuesto total separado para cada tarea.

Guía completa de configuración de Hermes · Habilidad instalable

Controles de Pago

Variable	Predeterminado	Descripción
`X402_EVM_PRIVATE_KEY`	sin configurar	Clave de pago dedicada para USDC en Base
`X402_SOLANA_PRIVATE_KEY`	sin configurar	Clave de pago Base58 o JSON para USDC en Solana
`X402_PAYMENT_NETWORK`	`auto`	`auto`, `base` o `solana`
`X402_MAX_PAYMENT_USD`	`1.00`	Límite de gasto duro por solicitud
`X402_BASE_URL`	pasarela de producción	Anula la URL de la pasarela
`X402_PAYMENT_HEADER`	sin configurar	Encabezado x402 pre-firmado heredado
`X402_DEV_BYPASS`	sin configurar	Secreto de omisión de desarrollo

En modo auto, se prefiere Base cuando ambas claves están configuradas. El pago automático solo acepta los contratos USDC canónicos en Base y Solana. Rechaza activos desconocidos, redes no compatibles y montos por encima del límite configurado antes de firmar.

MegaETH sigue disponible para clientes que proporcionen su propio encabezado de pago compatible.

Herramientas MCP

Categoría	Herramientas
Descubrimiento	`discover_services`, `service_health`
Imagen y código	`generate_image`, `execute_code`
Audio	`transcribe_audio`
Cripto	`get_crypto_price`, `get_crypto_markets`, `get_crypto_history`, `get_trending_crypto`, `search_crypto`, `get_crypto_categories`
Billetera y token	`get_wallet_balances`, `get_wallet_transactions`, `get_wallet_pnl`, `get_token_prices`, `get_token_metadata`
IPFS	`pin_to_ipfs`, `get_from_ipfs`
Viajes	`search_flights`, `search_locations`, `search_hotels`, `search_cheapest_dates`

Los precios se incluyen en la descripción de cada herramienta y en el descubrimiento en vivo. El catálogo de la pasarela puede cambiar independientemente de este paquete.

Descubrimiento

Descubrimiento de pasarela: /.well-known/x402.json
Tarjeta de agente: /.well-known/agent.json
Manifiesto de endpoint: /.well-known/agent-manifest.v1.json
API de servicios: /api/services
Metadatos del paquete: server.json

Desarrollo

npm install
npm test
npm run build

Enlaces

Sitio web: x402engine.app
npm: x402engine-mcp
GitHub: agentc22/x402engine-mcp
Protocolo: x402.org