Pink Agentic AI Payments

Pagamentos para agentes de IA via MCP: orçamentos e regras por agente (permitir, perguntar a um humano, bloquear) verificados no lado do servidor antes de um pagamento ser executado. Sandbox gratuito com dinheiro de teste.

Ver em pinkwallet.com

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

Última atualização: 2026-10-12

Visão geral

Endpoint MCP	`https://agentic-sandbox.pinkwallet.com/mcp` (Streamable HTTP), ou execute como um servidor stdio local com `npx -y pink-agentic-payments-mcp` (env `PINK_AGENT_API_KEY`)
Autenticação	OAuth 2.1 (descoberta, registro dinâmico de clientes, PKCE) para clientes como conectores personalizados do Claude.ai, ou um simples cabeçalho `Authorization: Bearer <agent_key>` / chave no caminho
Base REST	`https://agentic-sandbox.pinkwallet.com/v1`
Ferramentas	7 ferramentas MCP: `pink.get_budget`, `pink.list_payees`, `pink.list_rules`, `pink.check_policy`, `pink.request_payment`, `pink.get_credential`, `pink.report_receipt`
Custo	Gratuito. Workspaces de sandbox usam apenas credenciais de teste, sem movimentação de dinheiro
Status	Sandbox público ativo agora; acesso à produção por meio de acesso antecipado

Início rápido em 5 minutos

1. Criar um workspace de sandbox

Escolha um modelo (coffee, startup ou ecommerce) e crie um workspace. Testado no sandbox ativo em 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"}'

A resposta retorna um admin_key e uma lista de agents, cada um com seu próprio key, orçamento mensal e limite por pagamento. Salve a chave de um agente: os exemplos abaixo a chamam de $AGENT_KEY.

2. Conectar seu cliente

Opção A: Claude Desktop, Claude Code ou Cursor, com a chave do agente como cabeçalho Bearer:

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

Opção B: um conector personalizado do Claude.ai via OAuth 2.1, sem colar chave em nenhum arquivo de configuração. Adicione um conector personalizado com a URL https://agentic-sandbox.pinkwallet.com/mcp e conclua a tela de consentimento (cole o admin_key do workspace lá e escolha qual agente conectar).

Opção C: uma ponte stdio local para clientes que só falam stdio. npx -y pink-agentic-payments-mcp encaminha cada chamada para o mesmo servidor MCP remoto via PINK_AGENT_API_KEY; consulte o README do pacote para configurações prontas para colar no Claude Desktop, Cursor e VS Code.

3. Verificar a política e solicitar o pagamento

Faça um teste primeiro com pink.check_policy (nada é gasto ou retido), depois chame pink.request_payment de verdade. As regras de horário são executadas no relógio do servidor no fuso do workspace; o argumento local_hour simula uma hora apenas para testes (pink.check_policy), e uma chamada real de pink.request_payment o ignora.

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","idempotency_key":"quickstart-1"}}}'

O que retorna, por decisão:

Permitido: uma credencial de uso único vinculada ao beneficiário e ao valor, válida por 15 minutos, retornada imediatamente. Confirmado ao vivo: um pedido de grãos de café de $420 sob o limite de $500 de um agente retornou "decision": "allowed" com uma credencial de transferência bancária anexada.
Aguardando aprovação humana: um hold_id e o nome do aprovador; consulte pink.get_credential até resolver. Confirmado ao vivo: um pedido de $890 acima do mesmo limite retornou "decision": "pending_human", exigindo o gerente da loja.
Bloqueado: sem credencial, com a regra que correspondeu. Confirmado ao vivo: um beneficiário de exchange de criptomoedas retornou "decision": "blocked" na regra "Nunca: cartões-presente, semelhantes a dinheiro, cripto".

A partir daqui, os guias mais detalhados: passo a passo completo do início rápido, conectar via MCP (todos os clientes suportados), conectar via REST, referência de regras de política e o modelo de segurança. Exemplos executáveis de frameworks (LangGraph, OpenAI Agents SDK, Haystack) estão em github.com/Pink-Agentic-Payments/sandbox-examples.

[

Para agentes que já rodam em um cliente ou framework compatível com MCP — Claude, Cursor, VS Code, OpenAI Agents SDK, LangChain — conecte diretamente sem precisar escrever um cliente HTTP personalizado.

Ferramenta	O que faz
`pink.get_budget`	Verifica o orçamento mensal restante e o limite por pagamento do agente chamador
`pink.list_payees`	Lista os beneficiários que este agente pode pagar
`pink.list_rules`	Lista as regras de política que se aplicam a este agente
`pink.check_policy`	Testa um pagamento contra as regras sem enviá-lo
`pink.request_payment`	Solicita um pagamento; as regras decidem PERMITIR, PERGUNTAR A UMA PESSOA ou BLOQUEAR
`pink.get_credential`	Recupera a credencial de cartão de uso único ou transferência bancária após aprovação
`pink.report_receipt`	Registra o recibo de um pagamento concluído

](https://pinkwallet.com/agentic/developers/connect-via-mcp)[

Para qualquer linguagem ou framework de agente sem suporte nativo a MCP, chame a API REST diretamente.

Método	Endpoint	O que faz
`POST`	`/v1/payments/check`	Teste: permitiria / perguntaria / bloquearia com o rastreamento completo das regras
`POST`	`/v1/payments`	Solicita um pagamento
`GET`	`/v1/payments/{id}`	Consulta um pagamento pendente; retorna a credencial após aprovação
`POST`	`/v1/payments/{id}/receipt`	Registra o recibo de um pagamento concluído

](https://pinkwallet.com/agentic/developers/connect-via-rest)

Cliente Python

Pink Agentic AI Payments tem um cliente Python oficial, pink-agentic-payments, que encapsula a API REST do sandbox: verificações de política, solicitações de pagamento, aprovações e recibos.

pip install pink-agentic-payments

from pink_agentic_payments import create_sandbox_workspace, PinkClient

workspace = create_sandbox_workspace(company="My Test Co", template="coffee")
agent_key = workspace["agents"][0]["key"]
client = PinkClient(agent_key)

check = client.check_policy(amount=420, payee_id="p_cc", purpose="beans")
print(check["decision"], "-", check["reason"])

github.com/Pink-Agentic-Payments/pink-agentic-payments-python (também no PyPI: pip install pink-agentic-payments).

Cliente Pink JS/TS

Pink Agentic AI Payments também tem um cliente JavaScript/TypeScript oficial, pink-agentic-payments-js, que encapsula a API REST do sandbox: verificações de política, solicitações de pagamento, aprovações e recibos.

npm install pink-agentic-payments

import { createSandboxWorkspace, PinkClient } from 'pink-agentic-payments';

const workspace = await createSandboxWorkspace({ company: 'My Test Co', template: 'coffee' });
const agentKey = workspace.agents[0].key;
const client = new PinkClient(agentKey);

const check = await client.checkPolicy({ amount: 420, payeeId: 'p_cc', purpose: 'beans' });
console.log(check.decision, '-', check.reason);

github.com/Pink-Agentic-Payments/pink-agentic-payments-js (no npm: npm install pink-agentic-payments).

Instalar os pacotes

Todos MIT, mantidos em github.com/Pink-Agentic-Payments. Tudo aqui fala com o sandbox; apenas dinheiro de teste.

Cliente JS/TS	`npm install pink-agentic-payments` — ativo no npm. pink-agentic-payments-js
Cliente Python	`pip install pink-agentic-payments`. pink-agentic-payments-python
LangChain	`pip install langchain-pink` — 4 ferramentas (`pink_request_payment`, `pink_check_policy`, `pink_get_budget`, `pink_check_payment_status`) + `PinkToolkit`. langchain-pink, ou o guia de conexão
n8n	`npm install n8n-nodes-pink` — ativo no npm (0.1.0), ou instale pela interface do n8n: Configurações → Nós da Comunidade → Instalar → `n8n-nodes-pink`. n8n-nodes-pink, ou o guia de conexão
MCP (stdio local)	`npx -y pink-agentic-payments-mcp` com env `PINK_AGENT_API_KEY` — conecta qualquer cliente MCP stdio ao servidor remoto acima. pink-agentic-payments-mcp
Vercel AI SDK	`npm install pink-agentic-payments-ai-sdk ai zod` — `pinkTools({ agentKey })` retorna 4 ferramentas `ai`. pink-agentic-payments-ai-sdk, ou o guia de conexão

Guias com capturas de tela, por cliente

Não é desenvolvedor, ou só quer os nomes dos menus? Os guias de conexão mostram cada cliente passo a passo: Claude, ChatGPT, Claude Code, Gemini CLI, Cursor, Windsurf, VS Code, Copilot Studio, APIs da OpenAI e da Anthropic, LangChain, CrewAI, n8n e os SDKs oficiais.

Começar

Início rápido em 5 minutos — o caminho mais rápido do zero ao primeiro pagamento de teste.
Padrões de integração de agentes
Receitas de frameworks — loops completos de agentes para o SDK TypeScript MCP, REST, Claude, APIs da Anthropic e da OpenAI, OpenAI Agents SDK, LangChain, CrewAI e clientes de IDE.
Referência de ferramentas MCP — todas as sete ferramentas com esquemas de entrada e respostas reais do sandbox.
Referência de regras de política — o objeto de regra, ordem de avaliação, escopos de beneficiários, janelas, quóruns de aprovadores, condições de evidência.
Modelo de segurança — o que um agente errado, comprometido ou excessivamente ansioso pode e não pode fazer. — como integrar verificações de orçamento, aprovações e recibos no próprio loop de um agente.

Status do sandbox

Sandbox ativo: apenas credenciais de teste, sem movimentação de dinheiro.Crie um workspace de sandbox gratuito — sem formulário de inscrição. A produção ainda não está disponível.

Procuramos parceiros de design

Estamos procurando 3 parceiros de design para executar Pink Agentic AI Payments em um caso de uso real antes da disponibilidade geral: equipes cujos agentes compram créditos de API, anúncios, nuvem ou viagens, ou que executam muitos pagamentos automatizados pequenos a fornecedores. Você recebe configuração prática das suas regras com nossa equipe e acesso antecipado. Gratuito durante o período de parceiro de design.

Prefere e-mail? [email protected], assunto "Pink design partner".

FAQ

Devo conectar via MCP ou REST?

Use MCP se seu agente já roda em um cliente ou framework compatível com MCP (Claude, Cursor, VS Code, OpenAI Agents SDK, LangChain) — você obtém 7 ferramentas (get_budget, list_payees, list_rules, check_policy, request_payment, get_credential, report_receipt) sem precisar escrever um cliente HTTP personalizado. Use REST se seu framework de agente não fala MCP, ou se você quer controle direto sobre as chamadas HTTP; ambos os caminhos rodam contra o mesmo mecanismo de política e workspace de sandbox.

Como testo um pagamento antes de realmente solicitar um?

Chame POST /v1/payments/check (REST) ou pink.check_policy (MCP) primeiro — é um teste que retorna would_allow, would_ask ou would_block junto com o rastreamento completo das regras, sem criar uma solicitação de pagamento real.

O que uma solicitação de pagamento realmente retorna?

POST /v1/payments retorna um de três estados: 201 se as regras permitem imediatamente, 202 se está aguardando aprovação humana, ou 403 se está bloqueado. Para uma solicitação pendente, você consulta GET /v1/payments/{id} até resolver, que retorna a credencial após aprovação. Enviar um cabeçalho Idempotency-Key torna as tentativas repetidas da mesma solicitação seguras.

O sandbox está conectado a dinheiro real?

Não. O sandbox está ativo: crie um workspace de sandbox gratuito em https://agentic-sandbox.pinkwallet.com/ (apenas credenciais de teste, sem movimentação de dinheiro). A produção ainda não está disponível.