Frequently Asked Questions (FAQ)

Q: What is the Stripe Agent Toolkit?

A: The Stripe Agent Toolkit is a Python and TypeScript library that enables popular agent frameworks to integrate with Stripe APIs through function calling. It supports OpenAI’s Agent SDK, LangChain, CrewAI, Vercel’s AI SDK, and Model Context Protocol (MCP).

Q: What is the Model Context Protocol (MCP)?

A: MCP is an open protocol that standardizes how applications provide context to LLMs. The MCP server acts as a bridge, allowing AI models to access and interact with external data sources and tools, like the Stripe API.

Q: What are the requirements for using the Python version of the Stripe Agent Toolkit?

A: You need Python 3.11+ and a Stripe secret key, which you can find in your Stripe Dashboard.

Q: What are the requirements for using the TypeScript version of the Stripe Agent Toolkit?

A: You need Node 18+ and a Stripe secret key.

Q: How do I install the Stripe Agent Toolkit for Python?

A: Run pip install stripe-agent-toolkit in your terminal.

Q: How do I install the Stripe Agent Toolkit for TypeScript?

A: Run npm install @stripe/agent-toolkit in your terminal.

**Q: How do I configure the Stripe Agent Toolkit? ** A: You need to configure the toolkit with your Stripe secret key and specify the actions that can be taken. For example:

python from stripe_agent_toolkit.openai.toolkit import StripeAgentToolkit

stripe_agent_toolkit = StripeAgentToolkit( secret_key=“sk_test_…”, configuration={ “actions”: { “payment_links”: { “create”: True, }, } }, )

**Q: Can I provide default values for API requests? ** A: Yes, you can use the context configuration option to provide default values. Currently, the account context value enables you to make API calls for your connected accounts.

**Q: What Stripe API methods are supported by the toolkit? ** A: The toolkit supports various API methods, including:

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

**Q: How does the Stripe Agent Toolkit support metered billing? ** A: For Vercel’s AI SDK, you can use middleware to submit billing events for usage. You need to provide the customer ID and the input/output meters to bill.

Q: How can I run the Stripe MCP server? ** A: You can use npx to run the server: npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY. Replace YOUR_STRIPE_SECRET_KEY with your actual Stripe secret key or set the STRIPE_SECRET_KEY in your environment variables.

Q: What is UBOS?

A: UBOS is a full-stack AI Agent Development Platform focused on bringing AI Agents to every business department. It helps you orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model and Multi-Agent Systems.