Pink Agentic AI Payments

السجل الرسمي المالية والمدفوعات

Pink Agentic AI Payments: AI agents pay within spending rules (budgets, caps, approval). Sandbox.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http pink-agentic-ai-payments 'https://agentic-sandbox.pinkwallet.com/mcp' --header 'Authorization: <Optional. OAuth 2.1 is available (discovery at /.well-known/oauth-authorization-server, dynamic client registration, PKCE S256, consent page); or a Bearer sandbox agent key (pk_sandbox_agent_*) issued by POST /v1/sandbox/workspaces or the create-workspace form at https://agentic-sandbox.pinkwallet.com/.>'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "pink-agentic-ai-payments": {
            "type": "http",
            "url": "https://agentic-sandbox.pinkwallet.com/mcp",
            "headers": {
                "Authorization": "<Optional. OAuth 2.1 is available (discovery at /.well-known/oauth-authorization-server, dynamic client registration, PKCE S256, consent page); or a Bearer sandbox agent key (pk_sandbox_agent_*) issued by POST /v1/sandbox/workspaces or the create-workspace form at https://agentic-sandbox.pinkwallet.com/.>"
            }
        }
    }
}
NPM package pink-agentic-payments-mcp
Claude Code
claude mcp add pink-agentic-ai-payments -e 'PINK_AGENT_API_KEY=<your pink_agent_api_key>' -e 'PINK_MCP_URL=<PINK_MCP_URL>' -- npx -y pink-agentic-payments-mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "pink-agentic-ai-payments": {
            "command": "npx",
            "args": [
                "-y",
                "pink-agentic-payments-mcp@0.1.1"
            ],
            "env": {
                "PINK_AGENT_API_KEY": "<your pink_agent_api_key>",
                "PINK_MCP_URL": "<PINK_MCP_URL>"
            }
        }
    }
}

متغيرات البيئة

  • PINK_AGENT_API_KEY إلزامي سري Agent API key from a Pink sandbox workspace (create one free, no signup, at https://agentic-sandbox.pinkwallet.com or via `npx pink-agentic-payments-mcp --create-sandbox`).
  • PINK_MCP_URL Remote Pink MCP endpoint to bridge to. Defaults to the public sandbox: https://agentic-sandbox.pinkwallet.com/mcp

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Pink Agentic AI Payments MCP server: let Claude, ChatGPT or Cursor pay vendors and invoices within spending rules
  2. Can Claude or ChatGPT pay an invoice through MCP?
  3. How this package works
  4. Quick start
  5. Tools
  6. How this was tested
  7. Links
  8. Status
  9. License

Pink Agentic AI Payments MCP server: let Claude, ChatGPT or Cursor pay vendors and invoices within spending rules

pink-agentic-payments-mcp is the MCP server for Pink Agentic AI Payments (by PinkWallet). It lets an AI agent in Claude, ChatGPT, Cursor, VS Code, Windsurf or any other MCP client request a payment, such as paying a vendor invoice or topping up API credits, and Pink checks that payment against the company's spending rules (per-agent budgets, single-payment caps, payee allow-lists, human approval above a threshold) before any payment credential is issued. The agent never holds a standing card or key.

Every payment request gets one of three answers: allowed (with a single-use credential), pending_human (a person is asked first), or blocked (with the reason).

Sandbox preview: test money only, no signup required to get a key.

Can Claude or ChatGPT pay an invoice through MCP?

Yes, with limits you set. Connect Pink as an MCP server, and the agent gets 7 payment tools (listed below). Asked to "pay the Acme invoice for $1,200", the agent calls pink.check_policy or pink.request_payment; Pink pays only if the invoice fits the rules, asks a person if it needs approval, or refuses and says why. Setup guides: Claude · ChatGPT (developer mode) · Cursor · Claude Code · Walkthrough: an MCP server that lets AI agents pay invoices.

How this package works

This package is a local stdio MCP server that bridges any MCP client to Pink's remote Streamable HTTP MCP server (https://agentic-sandbox.pinkwallet.com/mcp). It forwards tools/list and tools/call (and resources/prompts, if the remote adds them) transparently, so the local server always reflects whatever tools Pink's remote server currently exposes; nothing is hardcoded. Clients that support remote MCP can also connect to that URL directly.

Quick start

1. Get a free sandbox agent key

No signup needed. Either run:

npx -y pink-agentic-payments-mcp --create-sandbox

which creates a sandbox workspace and prints a ready-to-paste client config, or create one yourself:

curl -s -X POST https://agentic-sandbox.pinkwallet.com/v1/sandbox/workspaces

and take any agents[].key from the response.

2. Add it to your MCP client

Claude Desktop (claude_desktop_config.json), Cursor, Windsurf, and most other stdio-based MCP clients:

{
  "mcpServers": {
    "pink": {
      "command": "npx",
      "args": ["-y", "pink-agentic-payments-mcp"],
      "env": { "PINK_AGENT_API_KEY": "pk_sandbox_agent_..." }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "pink": {
      "command": "npx",
      "args": ["-y", "pink-agentic-payments-mcp"],
      "env": { "PINK_AGENT_API_KEY": "${input:pink_agent_key}" }
    }
  }
}

Env vars:

  • PINK_AGENT_API_KEY (required) — your agent key from a sandbox workspace.
  • PINK_MCP_URL (optional) — defaults to https://agentic-sandbox.pinkwallet.com/mcp.

Tools

These are live from the remote server's tools/list response (see TEST-OUTPUT.txt for the full run):

ToolWhat it does
pink.get_budgetWhat this agent may still spend: monthly budget left, spent today, single-payment cap, vault balances, company daily ceiling.
pink.list_payeesSuppliers, platforms and contractors this company has approved. Paying anyone else stops and asks a person.
pink.list_rulesThe policy rules that apply to this agent, in evaluation order. First match decides: allow, ask, or block.
pink.check_policyDry run. Returns would_allow / would_ask / would_block with the rule and full decision trace. Nothing is spent or held.
pink.request_paymentThe real call. Returns allowed with a single-use credential, pending_human with a hold_id while a person is asked, or blocked with the reason.
pink.get_credentialPoll a pending hold. Once a person approves, this returns the credential.
pink.report_receiptFile the receipt for a completed payment so it reconciles.

How this was tested

TEST-OUTPUT.txt in this repo is the full, unedited output of three real runs against a live sandbox workspace (test money only):

  1. The built server (dist/bin.js) driven over stdio by an MCP SDK test client — tools/list plus pink.request_payment calls that returned real allowed (with an issued sandbox credential), blocked (over monthly budget), and pending_human (new-payee approval) decisions.
  2. The official MCP Inspector CLI (npx @modelcontextprotocol/inspector --cli) run headless against the same built server.
  3. The same stdio test run again from a packed tarball (npm pack then npx -y ./pink-agentic-payments-mcp-0.1.0.tgz) in a clean directory, to prove the npx install path works end to end.

Status

Sandbox preview (test money only). Published on npm as pink-agentic-payments-mcp — npx -y pink-agentic-payments-mcp is all you need, no clone or build step required.

License

MIT

الأسئلة الشائعة

ما هو Pink Agentic AI Payments؟

Pink Agentic AI Payments: AI agents pay within spending rules (budgets, caps, approval). Sandbox.

كيف أثبّت Pink Agentic AI Payments؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http pink-agentic-ai-payments 'https://agentic-sandbox.pinkwallet.com/mcp' --header 'Authorization: <Optional. OAuth 2.1 is available (discovery at /.well-known/oauth-authorization-server, dynamic client registration, PKCE S256, consent page); or a Bearer sandbox agent key (pk_sandbox_agent_*) issued by POST /v1/sandbox/workspaces or the create-workspace form at https://agentic-sandbox.pinkwallet.com/.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Pink Agentic AI Payments إلى مفتاح API؟

نعم. يتطلب PINK_AGENT_API_KEY, Authorization، وتضبطها في إعداداته.

هل Pink Agentic AI Payments مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Pink Agentic AI Payments؟

ينشره Pink-Agentic-Payments. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.