Gatewards

@gatewards/mcp-server

Un servidor MCP que permite que cualquier agente (Claude Desktop, Cursor, VS Code, o tu propio cliente MCP) descubra y llame a APIs de pago a través de Gatewards — con límites de gasto por agente, deduplicación entre agentes y liquidación x402 sin custodia.

El agente conserva su propia clave de API y billetera. Gatewards aplica el límite de gasto en la ruta de solicitud: una llamada que excede el presupuesto se rechaza antes de ejecutarse, no se registra después.

Instalación

npx @gatewards/mcp-server --api-key=gw_agent_xxx --gateway=https://api.gatewards.com

Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "gatewards": {
      "command": "npx",
      "args": [
        "@gatewards/mcp-server",
        "--api-key=gw_agent_xxx",
        "--gateway=https://api.gatewards.com"
      ]
    }
  }
}

Obtén una clave de agente desde tu panel de Gatewards.

Dos modos

Modo	Cómo	Lo que obtienes
Proxy (predeterminado)	--api-key=gw_agent_xxx	Enruta llamadas a través de la puerta de enlace. Aplicación de presupuesto por agente, caché de respuestas y deduplicación entre agentes. Sin billetera, sin pago en cadena.
x402 (autocustodia)	--private-key=0x... --rpc-url=... --usdc-address=...	El agente firma los pagos USDC él mismo. Cuando una API devuelve 402, el pago se liquida en cadena y la solicitud se reintenta con un recibo. Las claves nunca salen de tu máquina.

Elige el modo proxy para gobernanza y caché. Añade x402 solo cuando realmente necesites pagar por llamada en cadena.

Herramientas

Herramienta	Qué hace
gatewards_discover_services	Lista los servicios de API de pago en el mercado (nombre, endpoint, precio).
gatewards_call_api	Realiza una llamada GET/POST. Devuelve estado, datos y costo si se realizó un pago.
gatewards_check_budget	Gasto diario actual, presupuesto restante y suscripciones activas.
gatewards_get_plans	Lista los planes de crédito prepagado para un servicio.
gatewards_subscribe	Compra un paquete de crédito para un servicio (solo modo proxy).

Configuración

Opciones o variables de entorno (las opciones ganan):

Opción	Entorno	Predeterminado	Notas
--gateway	GATEWARDS_GATEWAY_URL	http://localhost:3001	URL base de la puerta de enlace.
--api-key	GATEWARDS_API_KEY	—	Clave de agente. Habilita el modo proxy.
--private-key	GATEWARDS_PRIVATE_KEY	—	Clave con prefijo 0x para el modo x402. Nunca se envía a ningún lugar.
--rpc-url	GATEWARDS_RPC_URL	—	Requerido para el modo x402.
--usdc-address	GATEWARDS_USDC_ADDRESS	—	Requerido para el modo x402.
--network	GATEWARDS_NETWORK	base-sepolia	p. ej. base, base-sepolia.
--merchant	GATEWARDS_MERCHANT_URL	—	Restringe las URL absolutas a este origen.

Se requiere --api-key o --private-key.

Licencia

Apache-2.0