Pink Agentic AI Payments

npx add-mcp 'https://agentic-sandbox.pinkwallet.com/mcp'

Inicio rápido en 5 minutos

1. Crea un espacio de trabajo de pruebas

Elige una plantilla (coffee, startup o ecommerce) y crea un espacio de trabajo. Probado contra el sandbox en vivo el 2026-10-05:

curl -s -X POST "https://agentic-sandbox.pinkwallet.com/v1/sandbox/workspaces" \
  -H 'content-type: application/json' \
  -d '{"template":"coffee","company":"My company"}'

La respuesta devuelve un admin_key y una lista de agents, cada uno con su propio key, presupuesto mensual y límite por pago. Guarda la clave de un agente: los ejemplos a continuación la llaman $AGENT_KEY.

2. Conecta tu cliente

Opción A: Claude Desktop, Claude Code o Cursor, con la clave del agente como encabezado Bearer:

claude mcp add --transport http pink \
  "https://agentic-sandbox.pinkwallet.com/mcp" \
  --header "Authorization: Bearer $AGENT_KEY"

Opción B: un conector personalizado de Claude.ai sobre OAuth 2.1, sin pegar ninguna clave en ningún archivo de configuración. Añade un conector personalizado con la URL https://agentic-sandbox.pinkwallet.com/mcp y luego completa la pantalla de consentimiento (pega el admin_key del espacio de trabajo allí y elige con qué agente conectarte).

3. Revisa la política y luego solicita el pago

Haz una prueba en seco primero con pink.check_policy (no se gasta ni se retiene nada), y luego llama a pink.request_payment para el pago real. Ambos probados en vivo el 2026-10-05, incluido el argumento local_hour: las reglas de horario del sandbox se ejecutan según el reloj UTC del servidor a menos que pases local_hour.

curl -s -X POST "https://agentic-sandbox.pinkwallet.com/mcp" \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -H "Authorization: Bearer $AGENT_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"pink.request_payment","arguments":{"payee_id":"p_cc","amount":420,"purpose":"20 kg espresso beans","local_hour":12,"idempotency_key":"quickstart-1"}}}'

Lo que devuelve, según la decisión:

• Permitido: una credencial de un solo uso vinculada al beneficiario y al monto, válida por 15 minutos, devuelta de inmediato. Confirmado en vivo: un pedido de granos de café de $420 bajo el límite de $500 de un agente devolvió "decision": "allowed" con una credencial de transferencia bancaria adjunta.
• Pendiente de aprobación humana: un hold_id y el nombre del aprobador; consulta pink.get_credential hasta que se resuelva. Confirmado en vivo: un pedido de $890 por encima del mismo límite devolvió "decision": "pending_human", requiriendo al gerente de la tienda.
• Bloqueado: sin credencial, con la regla que coincidió. Confirmado en vivo: un beneficiario de intercambio de criptomonedas devolvió "decision": "blocked" según la regla "Nunca: tarjetas de regalo, similares a efectivo, criptomonedas".

Desde aquí, las guías más detalladas: tutorial completo de inicio rápido, conexión vía MCP (todos los clientes compatibles), conexión vía REST, referencia de reglas de política y el modelo de seguridad. Ejemplos ejecutables de frameworks (LangGraph, OpenAI Agents SDK, Haystack) están en github.com/Pink-Agentic-Payments/sandbox-examples.