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?

Descubrir APIs de pago disponibles — explore el catálogo de puertas de enlace en vivo con discover_services para encontrar endpoints de LLM, imágenes, cripto, viajes y otros de pago por solicitud.
Verificar el estado del servicio antes de pagar — use service_health para comprobar que un endpoint sea accesible y ver su precio actual sin gastar.
Generar imágenes bajo demanda — llame a generate_image para crear imágenes generadas por IA, con pago automático en USDC en Base o Solana.
Ejecutar código en un entorno aislado — ejecute fragmentos mediante execute_code y pague por ejecución a través del protocolo x402.
Obtener precios de criptomonedas y datos de mercado — consulte get_crypto_price, get_crypto_markets o get_trending_crypto para obtener información en tiempo real sobre tokens y mercados.
Buscar vuelos y hoteles — use search_flights, search_hotels o search_locations para consultar opciones de viaje con facturación por solicitud.

Documentación

x402engine-mcp

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

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

Inicio Rápido

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

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.0"],
      "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 inicia sin billetera, y las herramientas gratuitas como discover_services y service_health aún funcionan. 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.0

Controles de Pago

Variable	Predeterminado	Descripción
`X402_EVM_PRIVATE_KEY`	sin establecer	Clave de pagador dedicada para USDC en Base
`X402_SOLANA_PRIVATE_KEY`	sin establecer	Clave de pagador 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 estricto por solicitud
`X402_BASE_URL`	puerta de enlace de producción	Anular la URL de la puerta de enlace
`X402_PAYMENT_HEADER`	sin establecer	Encabezado x402 pre-firmado heredado
`X402_DEV_BYPASS`	sin establecer	Secreto de omisión para 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 soportadas y montos por encima del límite configurado antes de firmar.

MegaETH permanece 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 están incluidos en la descripción de cada herramienta y en el descubrimiento en vivo. El catálogo de la puerta de enlace puede cambiar independientemente de este paquete.

Descubrimiento

Descubrimiento de puerta de enlace: /.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