# Stripe MCP for AI Agents AI Agent Connect > Stripe MCP lets you manage your entire payment ecosystem from a single chat interface. You can create payment intents, track invoices, and audit refunds without leaving your workspace. It puts your subscription billing and customer data at your agent's fingertips for instant access. ## Overview - **Category:** money-moves - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_YSLsQytXKUhj5dRPxEam26P5wIamLyQLkBRovGtE/ai-agent-connect - **Tags:** payments, invoicing, customer-management, subscription-billing, financial-reporting, refund-management ## Description This Connector connects your Stripe account to your AI agent so you can handle payments, subscriptions, and customer data through plain conversation. Instead of jumping between browser tabs to check if a payment went through or to see who owes money, you just ask your agent for the status. It handles the heavy lifting of looking up customer records, checking your available balances across different currencies, and reviewing your coupon usage. You can manage your product catalog and pricing tiers without manual data entry. Because it's hosted on Vinkius, you get a reliable way to bridge your financial data with your daily workflow. It turns your AI into a dedicated payments engineer that can pull reports, verify subscription cycles, and create new payment intents on demand. You'll stop hunting through complex menus and start getting answers in seconds. ## Tools ### create_customer Create a new customer profile with a name, email, and custom metadata. Use this to automate user onboarding from your own app. ### get_balance Check your current available and pending balances broken down by currency and type. This is useful for seeing your current payout status. ### get_customer Retrieve the specific details for a customer using their unique ID. Use this to pull up a profile quickly during a support call. ### list_charges View a list of all charges including status, amount, and associated customer info. You can filter these to find specific transaction types. ### list_coupons Browse all discount coupons with their specific percent-off or amount-off settings. This helps you audit your current marketing offers. ### list_customers List all customers in your account including their emails, names, and metadata. You can use this to quickly see your total user base. ### list_invoices View all invoices with details on amounts due and current payment statuses. Use this to identify which customers have outstanding balances. ### list_payment_intents Monitor the status of various payment intents and their associated customers. This is great for tracking real-time transaction progress. ### list_prices Browse your product prices including recurring intervals for subscription plans. Use this to verify your current billing tiers. ### list_products View all products in your catalog with descriptions and active statuses. This helps you manage your entire inventory in one place. ### list_refunds Review all issued refunds with timestamps and their current processing status. This makes it easy to audit your return history. ### list_subscriptions Track active subscriptions and their billing cycles for all customers. Use this to see your recurring revenue at a glance. ### create_payment_intent Create a new payment intent to handle transactions with specific amounts and currencies. This helps you generate the secrets needed for your front end. ## Prompt Examples **Prompt:** ``` What's our current available balance in USD? ``` **Response:** ``` Your available balance is **$12,450.00 USD**. Here is the breakdown: - **Available:** $12,450.00 USD - **Pending:** $1,200.00 EUR (3 transactions still processing) - **Next Payout:** Scheduled for tomorrow morning. ``` **Prompt:** ``` List the last 5 refunds we issued. ``` **Response:** ``` I found 5 refunds issued recently: | Amount | Status | Timestamp | | :--- | :--- | :--- | | $50.00 | Succeeded | Oct 12, 2023 | | $25.00 | Succeeded | Oct 11, 2023 | | $100.00 | Pending | Oct 10, 2023 | | $15.00 | Succeeded | Oct 09, 2023 | | $40.00 | Succeeded | Oct 08, 2023 | ``` **Prompt:** ``` Do we have any active subscriptions for 'John Doe'? ``` **Response:** ``` I found **1 active subscription** for John Doe. - **Plan:** Pro Plan - **Price:** $99.00/mo - **Status:** Active - **Next Billing Date:** Next Tuesday, Oct 24th. ``` ## Capabilities ### Create payment intents Generate new payment requests with specific amounts and currencies for your app. ### Audit refunds Review all past refunds including amounts, statuses, and timestamps. ### Track subscriptions Monitor active billing cycles and associated pricing for all users. ### Manage customer records List, retrieve, and create customer profiles with emails and metadata. ### Monitor balances Check available and pending balances across multiple currencies. ### Review invoices List all invoices with details on amounts due and current payment statuses. ## Use Cases ### Refund Audit A finance lead asks for all refunds over $100 from last month. The agent uses list_refunds and list_charges to provide a summary. ### Subscription Check A PM wants to know how many Pro users are on a trial. The agent uses list_subscriptions to filter by status and price. ### Quick Balance Check A founder asks 'How much money is pending?' and the agent uses get_balance to report the current status. ### Customer Onboarding A developer needs to create a customer record for a new sign-up. The agent uses create_customer to add the user to Stripe. ## Benefits - Stop manual dashboard hopping by using list_customers and get_customer to manage user data instantly. - Audit financial history faster by using list_refunds and list_charges to see every transaction. - Monitor your cash flow in real time with get_balance to see pending and available funds. - Simplify subscription management by using list_subscriptions to see active billing cycles at a glance. - Streamline product updates by using list_products and list_prices to review your entire catalog. - Handle payments programmatically by using create_payment_intent to generate client secrets for your app. ## How It Works The bottom line is you get a direct line to your payment data without the manual dashboard navigation. 1. Subscribe to the Stripe MCP on the Vinkius marketplace. 2. Enter your Stripe Secret Key into the configuration settings. 3. Ask your agent to check balances, list customers, or create payment intents. ## Frequently Asked Questions **Can I use the Stripe MCP to check my balance?** Yes, you can ask your agent to check your current available and pending balances across different currencies instantly. This saves you from having to log into the dashboard just to see your current cash position. **How do I manage customers with this Connector?** You can use your agent to list all customers, retrieve specific details for a single user, or create new customer records with emails and names. It makes handling user data much faster for support and sales teams. **Can I see my subscription statuses?** This Connector allows your agent to list all active subscriptions and show you their current status, billing cycles, and associated prices. You can quickly see who is active and who is on a trial. **Can I audit my refunds?** You can ask your agent to review all past refunds, including the amounts, statuses, and timestamps for every transaction. This is a huge time saver for finance teams during month-end audits. **Does this Connector work with my current AI client?** Yes, it works with any MCP-compatible client like Claude, Cursor, or Windsurf once you connect your Stripe secret key. It provides a bridge between your agent and your financial data. **Can I see my invoices?** You can ask your agent to list all invoices, providing details on the amount due, the payment status, and which customer they belong to. It helps you quickly identify who needs to be followed up with. **How do I get my Stripe Secret Key?** Log in to the [**Stripe Dashboard**](https://dashboard.stripe.com/apikeys), go to **Developers > API keys**, toggle **Test mode** for testing or stay in Live mode for production. Copy the Secret Key (starts with `sk_test_` or `sk_live_`). Keep it secret — never expose it in frontend code. **What's the difference between a payment intent and a charge?** A **Payment Intent** represents a pending payment that may require additional steps (3D Secure, confirmation). It tracks the lifecycle of a payment attempt. A **Charge** is the result of a successfully completed payment — it represents money that has been collected. Use list_payment_intents to track in-progress payments and list_charges for completed ones. **Can I create a payment intent for any amount?** Yes! Use the `create_payment_intent` tool with the amount in the smallest currency unit (e.g. 1000 = $10.00 USD, 1000 = €10.00 EUR) and the currency code (usd, eur, gbp, etc.). Optionally associate it with a customer ID. The tool returns the payment intent with its client_secret for use with Stripe.js. **Can I track subscription statuses?** Yes! Use `list_subscriptions` to see all subscriptions with their status (active, trialing, past_due, canceled, unpaid), customer, billing cycle and items. You can filter by customer ID or status to narrow results. This is useful for monitoring recurring revenue and identifying at-risk accounts.