The Stripe Agent Toolkit enables popular agent frameworks including Model Context Protocol (MCP), OpenAI's Agent SDK, LangChain, CrewAI, and Vercel's AI SDK to integrate with Stripe APIs through function calling. Thelibrary is not exhaustive of the entire Stripe API. It includes support for MCP, Python, and TypeScript and is built directly on top of the StripePython andNode SDKs.

Included below are basic instructions, but refer to theMCPPython,TypeScript packages for more information.

Stripe hosts a remote MCP server athttps://mcp.stripe.com. This allows secure MCP client access via OAuth. View the docshere.

The Stripe Agent Toolkit also exposes tools in theModel Context Protocol (MCP) format. Or, to run a local Stripe MCP server using npx, use the following command:

npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY

You don't need this source code unless you want to modify the package. If you justwant to use the package run:

pip install stripe-agent-toolkit

• Python 3.11+

The library needs to be configured with your account's secret key which isavailable in yourStripe Dashboard.

fromstripe_agent_toolkit.openai.toolkitimportStripeAgentToolkitstripe_agent_toolkit=StripeAgentToolkit(secret_key="sk_test_...",configuration={"actions": {"payment_links": {"create":True,            },        }    },)

The toolkit works with OpenAI's Agent SDK, LangChain, and CrewAI and can be passed as a list of tools. For example:

fromagentsimportAgentstripe_agent=Agent(name="Stripe Agent",instructions="You are an expert at integrating with Stripe",tools=stripe_agent_toolkit.get_tools())

Examples for OpenAI's Agent SDK,LangChain, and CrewAI are included in/examples.

In some cases you will want to provide values that serve as defaults when making requests. Currently, theaccount context value enables you to make API calls for yourconnected accounts.

stripe_agent_toolkit=StripeAgentToolkit(secret_key="sk_test_...",configuration={"context": {"account":"acct_123"        }    })

You don't need this source code unless you want to modify the package. If you justwant to use the package run:

npm install @stripe/agent-toolkit

• Node 18+

The library needs to be configured with your account's secret key which is available in yourStripe Dashboard. Additionally,configuration enables you to specify the types of actions that can be taken using the toolkit.

import{StripeAgentToolkit}from"@stripe/agent-toolkit/langchain";conststripeAgentToolkit=newStripeAgentToolkit({secretKey:process.env.STRIPE_SECRET_KEY!,configuration:{actions:{paymentLinks:{create:true,},},},});

The toolkit works with LangChain and Vercel's AI SDK and can be passed as a list of tools. For example:

import{AgentExecutor,createStructuredChatAgent}from"langchain/agents";consttools=stripeAgentToolkit.getTools();constagent=awaitcreateStructuredChatAgent({  llm,  tools,  prompt,});constagentExecutor=newAgentExecutor({  agent,  tools,});

In some cases you will want to provide values that serve as defaults when making requests. Currently, theaccount context value enables you to make API calls for yourconnected accounts.

conststripeAgentToolkit=newStripeAgentToolkit({secretKey:process.env.STRIPE_SECRET_KEY!,configuration:{context:{account:"acct_123",},},});

For Vercel's AI SDK, you can use middleware to submit billing events for usage. All that is required is the customer ID and the input/output meters to bill.

import{StripeAgentToolkit}from"@stripe/agent-toolkit/ai-sdk";import{openai}from"@ai-sdk/openai";import{generateText,experimental_wrapLanguageModelaswrapLanguageModel,}from"ai";conststripeAgentToolkit=newStripeAgentToolkit({secretKey:process.env.STRIPE_SECRET_KEY!,configuration:{actions:{paymentLinks:{create:true,},},},});constmodel=wrapLanguageModel({model:openai("gpt-4o"),middleware:stripeAgentToolkit.middleware({billing:{customer:"cus_123",meters:{input:"input_tokens",output:"output_tokens",},},}),});

• Cancel a subscription
• Create a coupon
• Create a customer
• Create a payment link
• Create a price
• Create a product
• Create a refund
• Create an invoice item
• Create an invoice
• Finalize an invoice
• List all coupons
• List all customers
• List all disputes
• List all prices
• List all products
• List all subscriptions
• Retrieve balance
• Update a dispute
• Update a subscription

Stripe

Bystripe·967

Interact with Stripe API