Stripe Billing MCP
This MCP server exposes Stripe billing operations for managing customers, subscriptions, invoices, checkout, and account metrics.
Create Stripe customers with name, email, and optional metadata.
Search customers by email or name with configurable result limits.
Subscribe customers to Stripe prices/plans with optional trial days.
Cancel subscriptions immediately or at period end, with proration control.
List recent customer invoices filtered by status.
Generate Stripe Checkout URLs for subscription or one-time payment modes.
Calculate revenue metrics including MRR, ARR, churn, average revenue per customer, and estimated LTV.
Retrieve the Stripe account balance and recent payouts.
Manage Stripe customers, subscriptions, invoices, checkout sessions, and revenue metrics, enabling AI assistants to handle billing operations programmatically.
Stripe Billing MCP
By MEOK AI Labs ā Sovereign AI tools for everyone.
MEOK AI Labs MCP Server
MEOK AI Labs MCP Server
š Quick Start
# Install via pip
pip install stripe_billing_mcp
# Or install via Smithery
npx -y @smithery/cli@latest install stripe-billing-mcp --client claudeRelated MCP server: MCP Billing Gateway SDK
⨠Features
MCP protocol compliant
Easy installation
Well-documented API
Production-ready
Active maintenance
š Documentation
š”ļø Compliance
This MCP server is built with EU AI Act compliance built-in:
ā Article 9 ā Risk Management System
ā Article 13 ā Transparency & Instructions for Use
ā Article 15 ā Bias Detection & Testing
ā Article 26 ā FRIA Support (where applicable)
ā Article 50 ā AI Content Watermarking (where applicable)
Need help getting compliant? Book a free 15-min diagnostic ā
How MEOK charges
MEOK has no subscriptions and no tiers. You pay per job, and only when the agreed artifact has been delivered to you. There is no public price list. See https://meok.ai/pricing.
This repository's source is MIT-licensed and free to self-host.
š¤ Part of the MEOK Ecosystem
This server is part of the MEOK AI Labs ecosystem ā 300+ MCP servers for sovereign AI governance.
Domain | Purpose |
EU AI Act compliance marketplace | |
AI safety & monitoring | |
Sovereign AI platform | |
Legacy modernization |
š License
MIT Ā© CSOAI-ORG
Pairs with MEOK Governance Suite
Build something that touches users? You need compliance. MEOK ships 38 governance MCPs that drop in alongside this tool ā EU AI Act, DORA, NIS2, CRA, GDPR, ISO 42001, FDA SaMD, MDR, Basel, MiFID II, MiCA, COPPA, and more.
# One-shot install of the governance pack
npx meok-setup --pack governanceā Full catalogue: councilof.ai ā MEOK AI Labs: meok.ai
Available Tools
8 toolscancel_subscriptionD
Cancel a Stripe subscription.
Args: subscription_id: Stripe subscription ID (sub_...) at_period_end: If True, cancel at end of billing period (default). If False, cancel immediately. prorate: Whether to prorate the final invoice (default True)
Behavior: This tool is read-only and stateless ā it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage.
When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards.
When NOT to use: Not suitable for real-time production decision-making without human review of results. Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent ā calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.
Inputs: subscription_id (required), api_key, prorate, at_period_end.
create_checkout_sessionC
Generate a Stripe Checkout URL for a price.
Args: price_id: Stripe price ID (price_...) success_url: URL to redirect after successful payment cancel_url: URL to redirect if customer cancels mode: Checkout mode ā "subscription" or "payment" (one-time) customer_email: Pre-fill the customer's email in checkout
Behavior: This tool generates structured output without modifying external systems. Output is deterministic for identical inputs. No side effects. Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage.
When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards.
When NOT to use: Not suitable for real-time production decision-making without human review of results.
Inputs: price_id (required), mode, api_key, cancel_url, +2 more.
create_customerD
Create a new Stripe customer.
Args: name: Customer full name email: Customer email address metadata: Optional key-value metadata (e.g. {"plan": "pro", "source": "website"})
Behavior: This tool generates structured output without modifying external systems. Output is deterministic for identical inputs. No side effects. Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage.
When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards.
When NOT to use: Not suitable for real-time production decision-making without human review of results.
Inputs: name (required), email (required), api_key, metadata.
create_subscriptionD
Subscribe a customer to a price/plan.
Args: customer_id: Stripe customer ID (cus_...) price_id: Stripe price ID (price_...) trial_days: Optional trial period in days
Behavior: This tool generates structured output without modifying external systems. Output is deterministic for identical inputs. No side effects. Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage.
When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards.
When NOT to use: Not suitable for real-time production decision-making without human review of results. Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent ā calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.
Inputs: price_id (required), customer_id (required), api_key, trial_days.
get_balanceC
Get current Stripe account balance and recent payouts.
Returns available and pending balances plus the last 5 payouts.
Behavior: This tool is read-only and stateless ā it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage.
When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards.
When NOT to use: Not suitable for real-time production decision-making without human review of results. Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent ā calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.
Inputs: api_key.
get_revenue_metricsB
Calculate MRR, ARR, churn rate, and LTV from live Stripe data.
Fetches active/canceled subscriptions and computes:
MRR (Monthly Recurring Revenue)
ARR (Annual Recurring Revenue)
Churn rate (cancellations in last 30 days / total active)
Average revenue per customer
Estimated LTV
Behavior: This tool is read-only and stateless ā it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage.
When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards.
When NOT to use: Not suitable for real-time production decision-making without human review of results. Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent ā calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.
Inputs: api_key.
list_invoicesA
List recent invoices for a customer.
Args: customer_id: Stripe customer ID (cus_...) limit: Number of invoices to return (default 10, max 100) status: Filter by status: draft, open, paid, uncollectible, void (optional)
Behavior: This tool generates structured output without modifying external systems. Output is deterministic for identical inputs. No side effects. Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage.
When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards.
When NOT to use: Not suitable for real-time production decision-making without human review of results. Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent ā calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.
Inputs: customer_id (required), limit, status, api_key.
search_customersC
Search Stripe customers by email or name.
Args: query: Email address or name to search for limit: Max results to return (default 10, max 100)
Behavior: This tool is read-only and stateless ā it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage.
When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards.
When NOT to use: Not suitable for real-time production decision-making without human review of results. Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent ā calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.
Inputs: query (required), limit, api_key.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 8 tools
Each tool targets a distinct resource and action: customers, subscriptions, invoices, checkout, metrics, and balance. Even the two analytics tools (get_revenue_metrics and get_balance) are clearly separable by their focus.
All tools follow a consistent verb_noun snake_case pattern: create_customer, search_customers, create_subscription, cancel_subscription, list_invoices, create_checkout_session, get_revenue_metrics, get_balance. No mixed conventions or vague verbs.
Eight tools is well-scoped for a billing-oriented server, covering customer management, subscription lifecycle, invoicing, checkout, and financial analytics. Each tool earns its place without redundancy.
Core billing workflows are present: customer create/search, subscription create/cancel, invoice listing, checkout session creation, and revenue/balance views. Minor gaps include no subscription update, no invoice detail view, and no customer update/delete, but these are workable for the stated billing domain.
Maintenance
Related MCP Connectors
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Hosted Stripe MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
MEOK Stripe ACP Checkout MCP ā ChatGPT shopping bridge. Issues + verifies + signs Stripe Agentic
Stripe MCP Pack ā read-only access to Stripe data via API key.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA remote MCP server implementation that integrates with Stripe, enabling AI assistants to interact with the Stripe API for payment processing functionality.-
- AlicenseBqualityDmaintenanceUniversal billing gateway for MCP servers. Add Stripe subscription billing to any MCP server with one line of code. Supports tiered plans, usage tracking, and automatic access control.138 PyPI2MIT
- AlicenseAqualityCmaintenancePCI DSS - MCP server providing AI-powered tools and automation by MEOK AI Labs5MIT
- AlicenseNot gradedqualityCmaintenanceInvoice Generator AI - MCP server providing AI-powered tools and automation by MEOK AI Labs3 npmMIT