Pensado para agentes

Un agente puede integrar Talo, probar todo el flujo en sandbox y llevarlo a producción sin ayuda. Lo único que hace una persona es autorizar la cuenta Talo una vez por entorno.

1. Conectarse sin pegar keys

El servidor MCP tiene OAuth: el agente lo agrega sin header, el navegador se abre y la persona elige sandbox o producción y los permisos. La key va directo al cliente y nunca pasa por la conversación.

claude mcp add --transport http talo https://talopartnerhub.vercel.app/api/mcp
# después: /mcp → Authenticate

2. Probar todo solo, en sandbox

Con una key de sandbox el agente crea pagos, simula transferencias exactas, de menos y de más, registra su webhook, le manda un evento de prueba firmado y verifica el checklist. Nada mueve plata real. Ver el plan de prueba.

create_payment      { amount: 15000, external_id: "test-1" }
simulate_transfer   { payment_id, amount: 14999 }   → UNDERPAID
simulate_transfer   { payment_id, amount: 1 }       → SUCCESS · payment.paid
create_webhook_endpoint { url }  →  test_webhook { endpoint_id }  → delivered
check_go_live       → ready: true

3. Llevarlo a producción

check_go_live (o npx talo-hub doctor) dice qué falta y cómo resolverlo. En producción las skills le indican al agente pedir confirmación antes de reembolsar o cambiar montos. Ver los pasos.

4. Credenciales seguras

Keys separadas por entorno (tph_test_ y tph_live_) y con tres permisos: read, charge y full. El servidor MCP solo le muestra al agente las herramientas que su key permite. Ver las reglas.

5. Leer esta web

Cada página tiene su versión en Markdown, pensada para modelos:

• /docs/index.md — Start here: what the hub does, how to connect, and where every page is.
• /docs/quickstart.md — From nothing to a paid sandbox payment in five commands.
• /docs/sandbox.md — Simulated transfers, every payment status, webhook pings, and the end-to-end test plan.
• /docs/credentials.md — Key types and scopes, where to keep them, least privilege, rotation, and what never to do.
• /docs/security.md — Who operates the hub, what it keeps (secrets encrypted), what each key can do, and how to revoke one key or disconnect the whole account.
• /docs/go-live.md — The readiness checklist and the exact steps to start charging real money.
• /docs/mcp.md — Connect with OAuth or a key, and every tool with its scope.
• /docs/cli.md — talo-hub commands, environments and non-interactive use.
• /docs/api.md — Every endpoint with its fields, the payment object, errors and payment statuses.
• /docs/webhooks.md — Events, the exact signature format, verification code, retries, ordering and a test vector.
• /docs/checkout.md — Talo's payment page, reusable payment links (/l/<id>, with a QR) and the <talo-checkout> widget or shadcn component, with the read-only checkout_token behind it.
• /docs/stacks.md — One kit of best practices per stack (Next.js + Vercel, Node, Python, Laravel, edge), the contract every integration meets, and how to port it to any other stack.
• /docs/skills.md — SKILL.md files that teach an agent to integrate and operate Talo.

Skills

npx talo-hub skills install   # las skills base y el kit del stack del proyecto

• talo-payments: El agente integra el checkout por transferencia: crea el pago, muestra el CVU, verifica webhooks firmados y prueba todo en sandbox.
• talo-go-live: El agente prueba el flujo completo en sandbox, maneja las credenciales de los dos entornos con seguridad y lleva la integración a producción.
• talo-operations: El agente consulta pagos, reembolsa, revisa saldo y movimientos, y prueba flujos en sandbox con el CLI o el MCP.

Kits por stack: Next.js + Vercel, Node.js (Express, Fastify, NestJS, Koa), Python (FastAPI, Django, Flask), PHP + Laravel, Edge (Cloudflare Workers, Supabase Edge Functions, Deno). Para cualquier otro stack, /docs/stacks.md tiene las reglas y cómo adaptarlas.