# Stripe MCP

> Stripe MCP lets your AI agent handle all financial operations directly from Stripe. Manage customer records, track payment intents, review open invoices, and monitor account balances without leaving your workflow. Get full control over billing, subscriptions, and payments—all through conversation.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** payments, invoicing, recurring-billing, pci-compliance, checkout, customer-management

## Description

You can use this MCP to give your AI client real power over financial accounts. Instead of logging into the Stripe dashboard just to find a customer's payment history or pull an invoice link, you simply ask your agent. It connects directly to your data, giving it visibility into every transaction, active subscription, and current account balance. This means finance teams can audit payments, founders can track monthly recurring revenue (MRR), and support agents can look up billing issues—all from a single conversation thread.

This MCP lets you create new customer records or instantly check if an invoice is overdue. Whether your workflow is handling customer onboarding, reconciling complex subscription cycles, or just needing to know how much money you have pending, it provides the data instantly. Since Vinkius hosts this MCP, you connect once and gain access to Stripe's full suite of tools within any compatible AI client.

## Tools

### customers_list
Lists Stripe customers and provides details like name, email, balance, and delinquency status.

### refunds_list
Retrieves a list of all processed refunds.

### customers_create
Creates a new customer record using required name and email details.

### payments_list
Lists payment intents, allowing filtering by customer ID. Amounts are provided in the smallest currency unit.

### subscriptions_list
Retrieves a list of subscriptions, which you can filter by status or associated customer.

### invoices_list
Lists invoices and lets you filter results by customer ID or payment status (e.g., paid, open).

### balance_get
Gets the current account balance, showing both available and pending amounts across all currencies.

### products_list
Use this to browse your existing product offerings listed in Stripe.

### product_create
Creates a new Stripe product entry before you define specific pricing tiers for it.

### prices_list
Lists all available price tiers, allowing you to filter them by a specific product ID.

### refund_create
Creates a partial or full refund for an existing payment using the required amount in cents.

### charges_list
Lists charges, with the option to filter results by customer ID.

### payouts_list
Retrieves a history of payouts processed through your Stripe account.

## Prompt Examples

**Prompt:** 
```
Show my Stripe account balance.
```

**Response:** 
```
Your Stripe balance: **$12,450.80 available** and **$3,200.00 pending** in USD.
```

**Prompt:** 
```
List all past-due subscriptions.
```

**Response:** 
```
Found 3 past-due subscriptions. The largest is for Acme Corp ($299/month, overdue since March 15). Would you like me to pull the associated invoices?
```

**Prompt:** 
```
Create a new customer: Jane Smith, jane@example.com
```

**Response:** 
```
Customer created: **Jane Smith** (cus_QR7x...). Email: jane@example.com. Ready for invoicing and subscriptions.
```

## Capabilities

### List Customer Records
You can retrieve a list of existing customers, optionally filtering by email address.

### Create New Customers
This tool lets you create brand new customer profiles using a required name and email.

### Track Payment Attempts
Retrieve payment intent details, including amounts and currency, across all transactions.

### Manage Subscriptions
List current or past subscriptions, allowing you to filter by status or customer ID.

### Review Invoices
Pull comprehensive data on invoices, letting you narrow the search by customer or specific payment status (draft, paid, overdue).

### Check Account Balances
Instantly get a breakdown of your available and pending funds across multiple currencies.

## Use Cases

### The Support Agent needs to check a client’s overdue status.
A support agent receives a ticket from Acme Corp asking why their service was paused. They use the MCP to list invoices and immediately see that the invoice is 'uncollectible' or 'overdue,' allowing them to respond with actionable information, rather than just telling the client they need to pay.

### The Founder needs to calculate immediate cash flow.
The founder asks their agent: 'What is our total available and pending balance across all currencies?' The MCP runs a balance_get, providing an instant, consolidated view of the company's current liquid assets without opening any accounting software.

### The Finance Team needs to reconcile recent sales.
A finance analyst uses the payments_list tool to check all payment intents for a specific customer ID. This allows them to verify if the full amount was received and confirm the status of each attempted charge.

### Creating new accounts and setting up billing.
A sales representative uses customers_create, providing the name and email for a new client. They then immediately list products to recommend services and can even initiate subscriptions_list checks once payment details are confirmed.

## Benefits

- Know the money status instantly. Instead of navigating multiple tabs to check balances, you ask your agent for a balance_get and get available and pending funds across every currency immediately.
- Eliminate manual customer data entry. You can use customers_create to build new client records in seconds, giving them an instant Stripe ID ready for invoicing.
- Master the billing cycle. Reviewing subscriptions via subscriptions_list lets you quickly identify which accounts are past due or need renewal, all from a simple query.
- Audit transactions without leaving your desk. You can list charges or payments by filtering on a customer ID to see every transaction associated with one person's account history.
- Handle refunds instantly. Use refund_create when necessary; you specify the payment and amount, and the MCP executes the partial refund immediately.

## How It Works

The bottom line is that you talk to your agent using plain language, and it executes complex API calls against your live Stripe data.

1. Subscribe to this MCP in Vinkius.
2. Provide the Stripe Secret Key (found in your Dashboard → Developers → API keys).
3. Ask your AI client to query specific financial data, like checking account balances or listing overdue invoices.

## Frequently Asked Questions

**Can I use Stripe MCP to see how much money I have available?**
Yes, you can run the balance_get tool. This shows both your available and pending funds across all currencies in a single report.

**How do I list all of my past customer records with Stripe MCP?**
Use the customers_list tool. You can optionally filter this data by email address to narrow down who you're looking for.

**Is Stripe MCP only for checking payments, or can I create new ones?**
It does both. You can track payments using payments_list, and if needed, run the refund_create tool to process a partial or full reimbursement.

**What tools do I use to check overdue invoices with Stripe MCP?**
You need the invoices_list tool. This lets you filter by status, making it easy to pull reports specifically on open or uncollectible bills.

**Can Stripe MCP help me create a new customer record?**
Yes. Use the customers_create tool and provide the required name and email address for the new client.