agenticpay

Recibe pagos de agentes de IA. Infraestructura de pago de código abierto para el ecosistema MCP: declara un precio en cualquier herramienta, los agentes pagan en USDC a través de x402, y se liquida en Solana en ~1.5 segundos.

Sin Stripe. Sin cuentas. Sin claves API.

La pila completa está aquí: SDK, CLI, middleware de muro de pago, facilitador x402 autohospedado y una demostración de agente LLM en vivo. Todo en TypeScript, con licencia MIT.

¿Solo quieres probarlo? Apunta tu mcp-server a nuestro facilitador de devnet alojado: FACILITATOR_URL=https://agentpay-facilitator-e9b20a5fee6a.herokuapp.com — no se requiere configuración.

Demostración en vivo

Un agente real de Claude Opus recibe una tarea, decide qué herramientas de pago usar, paga de forma autónoma mediante micropagos x402 en Solana y responde al usuario.

$ pnpm --filter @agenticpay/two-agent-demo agent

Agent wallet: 3rHoEumCpH8EGrr6Lq2vBKeyec6h3yPRGj2nGG2FzEfX
Server:       http://localhost:4021
Facilitator:  http://localhost:4022   ← our own
Model:        claude-opus-4-7
Task:         Reverse the string 'agentpay rocks' and tell me how many words
              are in 'The quick brown fox jumps over the lazy dog'.

[turn 1] tool_use: reverse_string({"text":"agenticpay rocks"})  →  paying $0.001 USDC ...
  ✓ paid + got result in 1596ms: {"result":"skcor yaptnega"}
[turn 1] tool_use: word_count({"text":"The quick..."})  →  paying $0.0005 USDC ...
  ✓ paid + got result in 1286ms: {"count":9}

Agent final answer:
  1. Reversed string: skcor yaptnega
  2. Word count: 9 words

=== payments summary ===
  reverse_string   $0.0010 USDC   1596ms
  word_count       $0.0005 USDC   1286ms
  TOTAL            $0.0015 USDC   2 calls

Prueba en la cadena (Solana devnet):

• Liquidado por nuestro facilitador autohospedado: EsqzTG8id...Bnku

• Liquidación anterior a través de x402.org: 2d2HcefgJ...vkqY

Por qué

La pila actual de agentes de IA asume que los humanos tienen la tarjeta de crédito. Eso se rompe en el momento en que los agentes actúan por iniciativa propia: llamando a APIs, contratando sub-agentes, pagando por computación. No puedes usar OAuth para resolver esto.

Los micropagos con stablecoins a través de HTTP lo solucionan. agenticpay empaqueta la ergonomía necesaria específicamente para el ecosistema MCP: cualquier herramienta puede declarar un precio, cualquier agente puede pagarlo, y todo el proceso —incluyendo el facilitador que realmente envía la liquidación en la cadena— es de código abierto y autohospedable.

Arquitectura

┌──────────────┐     1) HTTP request                    ┌─────────────┐
│   Claude /   │ ────────────────────────────────────▶ │  mcp-server │
│   GPT agent  │     2) HTTP 402 + payment requirements │  (yours)    │
│              │ ◀──────────────────────────────────── │             │
│              │     3) signed USDC payload             │             │
│              │ ────────────────────────────────────▶ │             │
└──────────────┘                                        └─────┬───────┘
                                                              │ verify+settle
                                                              ▼
                                                   ┌──────────────────────┐
                                                   │ agenticpay facilitator │
                                                   │   (also yours, this  │
                                                   │    repo, port 4022)  │
                                                   └──────────┬───────────┘
                                                              │ submit
                                                              ▼
                                                          Solana
                                                       (USDC SPL,
                                                       sub-cent fees)

También puedes apuntar mcp-server al x402.org/facilitator público para testnet/devnet, o a Coinbase CDP para mainnet. Simplemente hemos facilitado la ruta autohospedada.

Paquetes

Instalación

npm install @agenticpay/sdk           # Solana + USDC primitives
npm install -g @agenticpay/cli        # `agenticpay` command
npm install @agenticpay/mcp-server    # paywalled HTTP server
npm install @agenticpay/facilitator   # self-hosted x402 facilitator
npm install @agenticpay/eliza-plugin  # Eliza plugin (Solana-native agents)
npm install @agenticpay/ai-sdk        # Vercel AI SDK paid tools
npm install -g @agenticpay/mcp-bridge # MCP server for Claude Desktop / Cursor

O clona el monorepo para obtener la demostración en vivo de dos agentes y plantillas fáciles de editar (recomendado para la primera ejecución; consulta el Inicio rápido a continuación).

Uso con Claude Code

Este repositorio incluye una Habilidad de Anthropic en .claude/skills/agenticpay/SKILL.md. Cópiala en tu ~/.claude/skills/ para darle a Claude Code contexto de primera clase sobre agenticpay; luego te guiará a través de la monetización de un servidor MCP, la generación de rutas de herramientas y la verificación de liquidaciones en la cadena sin tener que volver a leer el README cada vez.

mkdir -p ~/.claude/skills
cp -r .claude/skills/agenticpay ~/.claude/skills/

Inicio rápido (devnet, ~5 minutos, gratis)

# 1. Install
pnpm install
pnpm -r build

# 2. Generate a payer wallet, fund it on devnet
node packages/cli/dist/index.js wallet new
node packages/cli/dist/index.js wallet show
# → fund SOL at https://faucet.solana.com  (paste pubkey)
# → fund USDC at https://faucet.circle.com (Solana Devnet, same pubkey)

# 3. (option A — fastest) Use our hosted devnet facilitator. Skip step 4.
export FACILITATOR_URL=https://agentpay-facilitator-e9b20a5fee6a.herokuapp.com

# 3. (option B — fully self-hosted) Start your own facilitator (terminal 1)
pnpm --filter @agenticpay/facilitator dev
# Note the printed feePayer address. It needs ~0.05 SOL devnet to cover fees.
# Either airdrop or use the helper:
pnpm --filter @agenticpay/facilitator fund
export FACILITATOR_URL=http://localhost:4022

# 4. Start the paywalled mcp-server (terminal 2)
PAY_TO=<recipient pubkey> pnpm --filter @agenticpay/mcp-server dev

# 5. Run the live LLM agent demo (terminal 3, needs ANTHROPIC_API_KEY in .env)
pnpm --filter @agenticpay/two-agent-demo agent

Integraciones de marcos de trabajo

Las plantillas listas para usar para las pilas de agentes de IA más comunes se encuentran en examples/:

Consulta examples/README.md para ver la matriz de integración.

Estado

Pre-alfa. Validado de extremo a extremo en Devnet. La configuración de Mainnet es compatible, pero requiere financiar al facilitador con SOL real y apuntar a un RPC capaz de trabajar en mainnet (Helius, QuickNode, etc.).

Hoja de ruta

• [x] Demostración de extremo a extremo en Devnet (humo + agente LLM)

• [x] Facilitador x402 autohospedado (verificar + liquidar, abstracción de fee_payer)

• [ ] Plantilla de servidor MCP del mundo real (buscar, obtener, resumir, extraer — en lugar del juguete reverse_string)

• [ ] Depósito en garantía en la cadena para tareas de larga duración (programa Anchor)

• [ ] Registro de reputación de agentes en la cadena

• [ ] Servicio de facilitador alojado (agenticpay.com)

¿Qué es un facilitador?

Si nunca has visto x402 antes: el facilitador es el intermediario de confianza que (1) verifica la carga útil de pago firmada por un agente, (2) envía la transferencia de USDC en la cadena y (3) paga las tarifas de gas SOL para que el agente no necesite nada de SOL, solo USDC. La mayoría de los desarrolladores de MCP no quieren ejecutar el suyo propio; apuntan a uno alojado.

Este repositorio incluye una implementación completa del facilitador. Puedes autohospedarlo, bifurcarlo, auditarlo o desplegarlo como un servicio para tus propios usuarios.

Licencia

MIT