Join early access
pinkTools({ agentKey }) wraps Pink as four Vercel AI SDK tools; no MCP client needed, no signup to try it. Works with generateText, streamText and Agent loops built with the Vercel AI SDK. Plans: Open source.
What you get
Once connected, an AI SDK agent can check its budget, request a payment and poll a pending approval through four tools: request_payment, check_policy, get_budget and check_payment_status. pinkTools() wraps the official pink-agentic-payments REST client directly as ai tool() definitions, with no MCP server or client in the loop. The rules you set in Pink decide each request: allowed on the spot, sent to a person, or blocked. The agent never holds a standing card or your account keys, only a single-use test credential once a payment is allowed.
npm install pink-agentic-payments-ai-sdk ai zodpink-agentic-payments-ai-sdk wraps the official pink-agentic-payments JS client as AI SDK tools.
createSandboxWorkspace() from the official JS client, shown in the code below.
npm install pink-agentic-payments-ai-sdk ai zod. pink-agentic-payments-ai-sdk wraps the official pink-agentic-payments JS client as four AI SDK tools; zod is what the tool schemas are declared with.pinkTools({ agentKey }) and spread the result into the tools option of generateText, streamText, or an Agent. No MCP transport or extra client setup; it is a plain object of ai tool()s.request_payment as plain text the model can read and act on, not a thrown error — confirmed in a live run against the sandbox on 2026-10-12: allowed — "decision=allowed payment_id=pay_f645358d4fd2 credential_type=virtual_card"; blocked — "decision=blocked payment_id=pay_e6b212a7434f rule=\"Eng Infra AI's monthly budget is used up\""; pending_human — "decision=pending_human payment_id=pay_e2b780b5f3fa approver=Sarah Kim (CFO)", which check_payment_status later resolved to approved once the hold was approved in the console.
import { generateText, stepCountIs } from "ai";
import { google } from "@ai-sdk/google";
import { createSandboxWorkspace } from "pink-agentic-payments";
import { pinkTools } from "pink-agentic-payments-ai-sdk";
// 1. Spin up a free sandbox workspace (test money, seeded with agents/payees/rules)
const workspace = await createSandboxWorkspace({ company: "My Test Co", template: "startup" });
const agentKey = workspace.agents[0].key;
// 2. Hand the tools to an AI SDK agent
const { text } = await generateText({
model: google("gemini-3.8-flash"),
tools: pinkTools({ agentKey }),
stopWhen: stepCountIs(5),
prompt: "Check the budget, then pay Figma $50 for our design tool renewal.",
});
console.log(text);Replace <agent_key> with the key of the agent this ai sdk should act as. Each agent has its own key, budget and rules.
“Check my budget with Pink, then pay Figma $50 for our design tool renewal.”
What you will see
This exact prompt ran live against the sandbox: Pink allowed it on the spot with a single-use test credential (decision=allowed). Ask for something above the agent's monthly budget instead and request_payment comes back blocked with the rule; ask for a mid-size amount above the single-payment cap and it comes back pending_human with the approver's name, until a person approves it in the console.
Why those two rules exist →
No. pinkTools() wraps the official pink-agentic-payments REST client directly as AI SDK tool() definitions with zod schemas. There is no MCP server or client involved; use one of the MCP connect guides instead if you want that route.
The live run in this guide used google("gemini-3.8-flash") via @ai-sdk/google. pinkTools() only defines tools, so it works with any model the AI SDK supports.
Menu names and settings paths follow each vendor's documentation at the verified date. If a vendor moves a menu, the linked page is the source of truth; the Pink side does not change.
Contact Email: [email protected]
ALTIVOX SPHERE SPÓŁKA ZO.O. is a wholly owned subsidiary of PinkWallet, registered in Poland in the Polish Ministry of Finance's virtual-currency activity register (registration number: RDWW-1797), authorized to provide cryptocurrency exchange and digital asset custody services in the EU under AML/CTF regulations.
PinkWallet (Pink Technologies Inc) is registered as a Money Services Business with the U.S. Department of the Treasury, FinCEN (Registration No. 31000321450011), enabling it to provide users with cross-border fund settlement and international payment services under the U.S. regulatory framework.
PinkWallet (Pink Wallet Technology Inc.) is registered as a Money Services Business with FINTRAC, Canada's financial intelligence unit (Registration No. C100001073), enabling it to provide users with cross-border fund settlement and virtual currency services under the Canadian regulatory framework.
