Invoket

El servidor MCP de Invoket

@invoket/mcpes la forma con menos fricción de dar a un agente de IA acceso de pago a Invoket: una línea de configuración del host MCP y cada endpoint de pago se convierte en una herramienta tipada que tu agente puede llamar. Paga las llamadas automáticamente mediante x402 — el agente nunca tiene que conocer el protocolo.

El servidor se ejecuta en tu máquina a través de stdio, lanzado por tu host MCP (Claude Desktop, Claude Code, cualquier cliente MCP). Invoket no aloja nada y nunca ve tu clave ni tus fondos. Las herramientas se generan en vivo desde las superficies de descubrimiento de la pasarela — nada está codificado de forma fija, por lo que los endpoints añadidos o eliminados en la pasarela aparecen o desaparecen por sí solos.

Si estás implementando el flujo x402 crudo por tu cuenta en lugar de pasar por MCP, consulta Para agentes y la Guía de inicio rápido.

Para quién es

Cualquier persona que opere un agente que deba poder actuar — pagar, enviar mensajes, asesorar, planificar, comprar — y necesite las comprobaciones previas a la acción que Invoket ofrece. Si tu runtime habla MCP (Claude Desktop, Claude Code, un agente SDK, cualquier host MCP), este es el camino con menos código entre tu agente y una llamada de pago.

Seguridad primero — BYOK no custodial

Este es un paquete pagador, por lo que la confianza es el producto. Cada garantía a continuación está aplicada por el propio paquete; lee el modelo de amenazas completo en SECURITY.md y audita el código fuente — es pequeño y con pocas dependencias a propósito.

• Tu clave nunca sale de tu máquina. PAYER_PRIVATE_KEY se lee una vez del entorno del proceso y se usa solo para producir firmas EIP-712 / EIP-3009 localmente. Nunca se transmite, nunca se escribe en disco, nunca se devuelve en un resultado de herramienta y nunca se registra — un depurador de salida global redacta material con forma de clave de cada línea de registro y error como respaldo.
• El gasto está limitado antes de cualquier firma. Tres comprobaciones independientes se ejecutan antes de que se firme un pago, y cualquier incumplimiento es un rechazo contundente: MAX_PRICE_USD (límite por llamada), SESSION_BUDGET_USD (presupuesto por sesión, en memoria), y una comprobación de que el monto del desafío 402 nunca supere el precio publicado por el descubrimiento — la pasarela no puede cobrar de más silenciosamente.
• Origen único, sin fetch arbitrario. Cada solicitud va al único origen configurado (INVOKET_BASE_URL, HTTPS obligatorio excepto en localhost). Ninguna entrada impulsada por el modelo puede hacer que el servidor obtenga otra URL.
• Sin estado persistente, sin telemetría. Nada se escribe en disco; los contadores de gasto viven en memoria solo durante la sesión.

Usa una billetera dedicada y de saldo bajo. Los límites de gasto acotan el costo por llamada y por sesión, pero tu techo de exposición real es simplemente el saldo de la billetera cuya clave proporcionas. Nunca apuntes esto a una billetera principal o de alto valor.

Inicio rápido

Necesitas Node.js ≥ 20. No hay paso de instalación — tu host MCP ejecuta npx -y @invoket/mcp. Para hacer llamadas de pago también necesitas una billetera EVM con fondos (USDC en Base). Para solo explorar el catálogo y probar llamadas de prueba gratuitas, omite la clave por completo y el servidor se inicia en modo solo descubrimiento.

Claude Desktop

Edita claude_desktop_config.json (Configuración → Desarrollador → Editar configuración), luego reinicia Claude Desktop:

{
  "mcpServers": {
    "invoket": {
      "command": "npx",
      "args": ["-y", "@invoket/mcp"],
      "env": {
        "PAYER_PRIVATE_KEY": "0xYOUR_DEDICATED_WALLET_KEY",
        "MAX_PRICE_USD": "10.00",
        "SESSION_BUDGET_USD": "10.00"
      }
    }
  }
}

Claude Code

claude mcp add invoket \
  --env PAYER_PRIVATE_KEY=0xYOUR_DEDICATED_WALLET_KEY \
  --env MAX_PRICE_USD=10.00 \
  --env SESSION_BUDGET_USD=10.00 \
  -- npx -y @invoket/mcp

Cualquier host MCP

Cualquier host que hable MCP sobre stdio puede lanzar el mismo comando:

{
  "command": "npx",
  "args": ["-y", "@invoket/mcp"],
  "env": {
    "PAYER_PRIVATE_KEY": "0xYOUR_DEDICATED_WALLET_KEY",
    "MAX_PRICE_USD": "10.00",
    "SESSION_BUDGET_USD": "10.00"
  }
}

Omite PAYER_PRIVATE_KEY para ejecutar en modo solo descubrimiento.

Variables de entorno

Las dos que normalmente configurarás son PAYER_PRIVATE_KEY (tu billetera dedicada) y los límites de gasto. El resto tienen valores predeterminados seguros.

Variable	Predeterminado	Significado
PAYER_PRIVATE_KEY	(ninguno → solo descubrimiento)	Clave privada EVM de tu billetera pagadora dedicada y de saldo bajo. Firma solo localmente; nunca se transmite ni se registra. Sin ella, las llamadas de pago están deshabilitadas.
MAX_PRICE_USD	10.00	Precio máximo aceptado para una sola llamada, en USD. Cualquier desafío 402 por encima de este se rechaza antes de firmar. El valor predeterminado cubre la llamada individual más cara que el catálogo puede cotizar (un lote de tamaño completo); establécelo más bajo explícitamente si quieres un límite más estricto.
SESSION_BUDGET_USD	10.00	Presupuesto total en USD para toda la sesión (en memoria, por proceso). Misma cifra que el límite por llamada: en el peor caso, una llamada máxima, o muchas pequeñas.
PREFER_TRIAL	true	Selecciona el requisito de prueba gratuita cuando la pasarela lo ofrezca. Establécelo en false para siempre liquidar en el riel de pago.
INVOKET_BASE_URL	https://api.invoket.com	El único origen que llama cada herramienta. HTTPS obligatorio excepto en localhost.
HTTP_TIMEOUT_MS	30000	Tiempo de espera de la solicitud HTTP a la pasarela, en milisegundos.
DISCOVERY_TTL_SECS	300	Cuánto tiempo se reutiliza una instantánea de descubrimiento antes de una actualización perezosa.
LOG_LEVEL	info	Verbosidad de registro solo en stderr: debug, info, warn, error.

Lo que ve tu agente

• Una herramienta tipada por endpoint de pago, generada desde el descubrimiento: el nombre se deriva de la ruta, el esquema de entrada del esquema publicado del endpoint, y el precio se indica en la descripción. Cuando una llamada no conlleva pago (una llamada de prueba o gratuita), el resultado informa paid: false — tu agente siempre sabe si una llamada costó algo.
• Herramientas de plataforma gratuitas, siempre disponibles y sin cargo:
  • search_endpoints — búsqueda de texto completo sobre el catálogo descubierto; pasa de una intención a la herramienta de pago correcta.
  • wallet_status — modo de pago, dirección pública del pagador, límites configurados y gasto de sesión (nunca la clave privada, nunca un saldo en cadena).
  • submit_review — enviar comentarios (una brecha, un error, una preocupación de precios) a Invoket.
  • platform_info — origen de la pasarela, número de endpoints descubiertos, frescura de la instantánea y el último error de descubrimiento (úsalo para diagnosticar una lista de herramientas vacía).

Prueba gratuita

Sin clave, el servidor se ejecuta en modo solo descubrimiento: explora el catálogo y lee esquemas sin pagar. Con una clave, la primera llamada de cada día a un endpoint habilitado para prueba es gratuita (PREFER_TRIAL tiene como valor predeterminado true) e informa paid: false. Qué endpoints ofrecen actualmente una prueba lo determina el /catalog de la pasarela, nunca está codificado de forma fija.

Cadenas y activos

USDC en Base en v1. El riel de pago se selecciona del desafío 402 de la pasarela; un requisito no compatible se rechaza con un mensaje claro.

Enlaces

• npm — @invoket/mcp
• Fuente — github.com/Invoket/mcp
• Modelo de amenazas — SECURITY.md
• Flujo x402 crudo (sin MCP) — Para agentes y Guía de inicio rápido