stripe

 # Stripe AI This repo is the one-stop shop for building AI-powered products and businesses on top of Stripe. It contains a collection of SDKs to help you integrate Stripe with LLMs and agent frameworks, including: * [`@stripe/agent-toolkit`](/tools/typescript) - for integrating Stripe APIs with popular agent frameworks through function calling—available in [Python](/tools/python) and [TypeScript](/tools/typescript). * [`@stripe/ai-sdk`](/llm/ai-sdk) - for integrating Stripe's billing infrastructure with Vercel's [`ai`](https://npm.im/ai) and [`@ai-sdk`](https://ai-sdk.dev/) libraries. * [`@stripe/token-meter`](/llm/token-meter) - for integrating Stripe's billing infrastructure with native SDKs from OpenAI, Anthropic, and Google Gemini, without any framework dependencies. ## Model Context Protocol (MCP) Stripe hosts a remote MCP server at `https://mcp.stripe.com`. This allows secure MCP client access via OAuth. View the docs [here](https://docs.stripe.com/mcp#remote). The Stripe Agent Toolkit also exposes tools in the [Model Context Protocol (MCP)](https://modelcontextprotocol.com/) format. Or, to run a local Stripe MCP server using npx, use the following command: ```sh npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY ``` See [MCP](/tools/modelcontextprotocol) for more details. ## Agent toolkit Stripe's Agent Toolkit enables popular agent frameworks including OpenAI's Agent SDK, LangChain, CrewAI, and Vercel's AI SDK to integrate with Stripe APIs through function calling. The library is not exhaustive of the entire Stripe API. It includes support for 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 [Python](/tools/python) and [TypeScript](/tools/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: ```sh pip install stripe-agent-toolkit ``` ##### 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]. ```python from stripe_agent_toolkit.openai.toolkit import StripeAgentToolkit stripe_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: ```python from agents import Agent stripe_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](/tools/python/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](https://docs.stripe.com/connect/authentication). ```python stripe_agent_toolkit = StripeAgentToolkit( secret_key="sk_test_...", configuration={ "context": { "account": "acct_123" } } ) ``` ### 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: ```sh npm install @stripe/agent-toolkit ``` ##### 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. ```typescript import { StripeAgentToolkit } from "@stripe/agent-toolkit/langchain"; const stripeAgentToolkit = new StripeAgentToolkit({ secretKey: process.env.STRIPE_SECRET_KEY!, configuration: { actions: { paymentLinks: { create: true, }, }, }, }); ``` ##### Tools The toolkit works with LangChain and Vercel's AI SDK and can be passed as a list of tools. For example: ```typescript import { AgentExecutor, createStructuredChatAgent } from "langchain/agents"; const tools = stripeAgentToolkit.getTools(); const agent = await createStructuredChatAgent({ llm, tools, prompt, }); const agentExecutor = new AgentExecutor({ agent, tools, }); ``` ##### 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](https://docs.stripe.com/connect/authentication). ```typescript const stripeAgentToolkit = new StripeAgentToolkit({ secretKey: process.env.STRIPE_SECRET_KEY!, configuration: { context: { account: "acct_123", }, }, }); ``` ## Supported API methods See the [Stripe MCP](https://docs.stripe.com/mcp) docs for a list of supported methods. [python-sdk]: https://github.com/stripe/stripe-python [node-sdk]: https://github.com/stripe/stripe-node [api-keys]: https://dashboard.stripe.com/account/apikeys ## License [MIT](LICENSE)