Stripe Agent Toolkit
The Stripe Agent Toolkit enables popular agent frameworks including OpenAI's Agent SDK, LangChain, CrewAI, Vercel's AI SDK, and Model Context Protocol (MCP) to integrate with Stripe APIs through function calling. The
library is not exhaustive of the entire Stripe API. It includes support for both Python and TypeScript and is built directly on top of the Stripe [Python][python-sdk] and [Node][node-sdk] SDKs.
Included below are basic instructions, but refer to the Python and TypeScript packages for more information.
Python
Installation
You don't need this source code unless you want to modify the package. If you just
want to use the package run:
Requirements
- Python 3.11+
Usage
The library needs to be configured with your account's secret key which is
available in your [Stripe Dashboard][api-keys].
The toolkit works with OpenAI's Agent SDK, LangChain, and CrewAI and can be passed as a list of tools. For example:
Examples for OpenAI's Agent SDK,LangChain, and CrewAI are included in /examples.
Context
In some cases you will want to provide values that serve as defaults when making requests. Currently, the
account context value enables you to make API calls for your connected accounts.TypeScript
Installation
You don't need this source code unless you want to modify the package. If you just
want to use the package run:
Requirements
- Node 18+
Usage
The library needs to be configured with your account's secret key which is available in your [Stripe Dashboard][api-keys]. Additionally,
configuration enables you to specify the types of actions that can be taken using the toolkit.Tools
The toolkit works with LangChain and Vercel's AI SDK and can be passed as a list of tools. For example:
Context
In some cases you will want to provide values that serve as defaults when making requests. Currently, the
account context value enables you to make API calls for your connected accounts.Metered billing
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.
Model Context Protocol
The Stripe Agent Toolkit also supports the Model Context Protocol (MCP).
To run the Stripe MCP server using npx, use the following command:
Replace
YOUR_STRIPE_SECRET_KEY with your actual Stripe secret key. Or, you could set the STRIPE_SECRET_KEY in your environment variables.Alternatively, you can set up your own MCP server. For example:
Supported API methods
Stripe Agent Toolkit
The Stripe Agent Toolkit enables popular agent frameworks including OpenAI's Agent SDK, LangChain, CrewAI, Vercel's AI SDK, and Model Context Protocol (MCP) to integrate with Stripe APIs through function calling. The
library is not exhaustive of the entire Stripe API. It includes support for both Python and TypeScript and is built directly on top of the Stripe [Python][python-sdk] and [Node][node-sdk] SDKs.
Included below are basic instructions, but refer to the Python and TypeScript packages for more information.
Python
Installation
You don't need this source code unless you want to modify the package. If you just
want to use the package run:
Requirements
- Python 3.11+
Usage
The library needs to be configured with your account's secret key which is
available in your [Stripe Dashboard][api-keys].
The toolkit works with OpenAI's Agent SDK, LangChain, and CrewAI and can be passed as a list of tools. For example:
Examples for OpenAI's Agent SDK,LangChain, and CrewAI are included in /examples.
Context
In some cases you will want to provide values that serve as defaults when making requests. Currently, the
account context value enables you to make API calls for your connected accounts.TypeScript
Installation
You don't need this source code unless you want to modify the package. If you just
want to use the package run:
Requirements
- Node 18+
Usage
The library needs to be configured with your account's secret key which is available in your [Stripe Dashboard][api-keys]. Additionally,
configuration enables you to specify the types of actions that can be taken using the toolkit.Tools
The toolkit works with LangChain and Vercel's AI SDK and can be passed as a list of tools. For example:
Context
In some cases you will want to provide values that serve as defaults when making requests. Currently, the
account context value enables you to make API calls for your connected accounts.Metered billing
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.
Model Context Protocol
The Stripe Agent Toolkit also supports the Model Context Protocol (MCP).
To run the Stripe MCP server using npx, use the following command:
Replace
YOUR_STRIPE_SECRET_KEY with your actual Stripe secret key. Or, you could set the STRIPE_SECRET_KEY in your environment variables.Alternatively, you can set up your own MCP server. For example: