The Stripe Agent Toolkit (@stripe/agent-toolkit) is an open-source SDK that gives AI agents the ability to perform real Stripe API operations — creating invoices, managing subscriptions, issuing refunds — via standard function calling. It also ships a hosted MCP server at mcp.stripe.com, making Stripe one of the first payment platforms to offer first-party MCP integration.
What It Does
The toolkit exposes a curated set of Stripe API operations as structured tool definitions that any LLM with function-calling support can invoke:
| Category | Tools |
|---|---|
| Customers | Create, list |
| Products & Pricing | Create product, create price, list both |
| Payments | Create payment link |
| Invoicing | Create invoice, finalize invoice |
| Subscriptions | Create, cancel |
| Refunds & Disputes | Create refund, list disputes, update dispute |
| Balance | Retrieve balance |
| Documentation | Search Stripe docs (agent self-help) |
Beyond basic CRUD, it supports Stripe Issuing (virtual card creation) and Stripe Treasury (fund movement) — enabling agents to autonomously manage more complex financial workflows.
MCP Integration
Stripe hosts a remote MCP server at mcp.stripe.com with OAuth-based access. Local usage:
npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY
This means any MCP-compatible host (Claude Desktop, Cursor, VS Code Agent Mode, custom agents) can connect to Stripe without additional SDK setup.
Supported Frameworks
The SDK ships first-class integrations for:
- OpenAI Agents SDK
- LangChain / LangGraph
- CrewAI
- Vercel AI SDK
- Google ADK (Agent Development Kit)
Why This Matters
The toolkit represents a shift in how financial APIs are designed: instead of building integrations for human-authored code, Stripe is explicitly designing for LLM consumption. The search_documentation tool — which lets an agent query Stripe's own docs mid-task — is a good example of this design philosophy.
Stripe is also co-developing the Agentic Commerce Protocol (ACP) with OpenAI to standardise how AI agents interact with payment systems across the web.
Why Trial, Not Adopt
- The SDK is still pre-1.0 (npm
0.7.xas of March 2026) — breaking changes are possible - Financial operations require careful scoping of agent permissions; test mode is essential during development
- The broader agentic commerce ecosystem (ACP, Agent Payments Protocol) is still forming — the standards may shift
Start here: enable the Stripe MCP server in your Claude Desktop or agent setup and explore what operations your existing agents can perform. Use test mode. Keep tool permissions narrow.
Key Characteristics
| Property | Value |
|---|---|
| Type | SDK + hosted MCP server |
| Languages | TypeScript, Python |
| npm | @stripe/agent-toolkit |
| GitHub | stripe/agent-toolkit |
| MCP server | mcp.stripe.com (hosted, OAuth) |
| Docs | docs.stripe.com/agents |
| First announced | November 2024 |
| Related | Agentic Commerce Protocol |