MCP server

SparkPay Official

dev.sparkpay/sparkpay

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

Stripe billing for indie apps: plans, coupons, subscriptions, customers and revenue reporting.

Working at last checkVerified publisher: sparkpay.devAbout 7,403 tokens per request once connected25 tools

Website

https://sparkpay.dev/api/mcp/mcp

At a glance

Type: MCP server
Publisher: sparkpay.dev (verified by the MCP Registry)
Status: Working at last check
Tools: 25
Token cost: About 7,403 tokens per request
Sets up in: Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok
Last checked: 25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to Cursor Add to VS Code VS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http sparkpay https://sparkpay.dev/api/mcp/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.sparkpay]
url = "https://sparkpay.dev/api/mcp/mcp"

Gemini CLI

{"mcpServers":{"sparkpay":{"httpUrl":"https://sparkpay.dev/api/mcp/mcp"}}}

Cursor

{"mcpServers":{"sparkpay":{"url":"https://sparkpay.dev/api/mcp/mcp"}}}

VS Code

{"servers":{"sparkpay":{"type":"http","url":"https://sparkpay.dev/api/mcp/mcp"}}}

Antigravity

agy mcp add sparkpay https://sparkpay.dev/api/mcp/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"sparkpay","server_url":"https://sparkpay.dev/api/mcp/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"sparkpay","server_url":"https://sparkpay.dev/api/mcp/mcp"}

Tools

archive_plan ~318 tokens
Remove a tier from an app's plan catalog. WRITE, human-gated: a real write needs an elicitation-capable client and the human must approve; dry_run previews anywhere. Every other plan tool edits tiers that already exist, so a catalog could grow but never shrink, and collapsing a multi-tier page down
bulk_create_coupon ~428 tokens
Create the SAME discount code across many apps in one call: the portfolio-promo shortcut (e.g. a summer sale on every owned app). WRITE, human-gated: a real create requires an elicitation-capable client; the human enters the coupon terms ONCE in a form (overriding the arguments here) and that one ap
bulk_delete_coupon Deletes data · ~329 tokens
Delete the SAME coupon code across many apps in one call: the inverse of bulk_create_coupon, for retiring a portfolio-wide promo. WRITE, human-gated: a real delete requires an elicitation-capable client; the human sees every app the code would be removed from (with per-app redemption counts) and mus
create_app_kit ~415 tokens
Step 2 of onboarding a new app onto SparkPay. Applies answers.plan_catalog by minting real Stripe prices (same helper /api/apps/sync-plans uses) and registers/updates the app, then returns a downloadable integration kit (lib/spark-pay client + plans.json + sync script + INTEGRATION.md, modeled on st
create_coupon ~518 tokens
Create a percentage discount coupon for an app. WRITE, human-gated: a real create requires an elicitation-capable client (e.g. Claude Desktop). The human enters the final code, percent, expiry, visibility, and tier scope in a form; those values OVERRIDE the arguments here, which only pre-fill the fo
delete_coupon Deletes data · ~296 tokens
Delete one coupon from an app. WRITE, human-gated: a real delete requires an elicitation-capable client; the human sees the exact coupon (code, percent, redemption count) and must click approve. The model cannot confirm on its own, and confirm_used is only consulted for dry_run previews. Clients wit
get_customer ~130 tokens
Look up a customer by email. Returns every subscription/registration for that email across apps (or within one app if app_id is given), with full detail: verification, plan, billing period, usage, refunds. Empty when the email is unknown.
invite_to_coupon ~367 tokens
Add email addresses to a coupon's invite list and, by default, switch the coupon to invite-only so the list is actually enforced. WRITE, human-gated: a real write requires an elicitation-capable client and the human sees every address plus whether the coupon is about to be closed to everyone else; c
list_apps ~86 tokens
List the registered apps (app_id + name). Use this first to discover valid app_id values, then pass one to the other tools to scope results to a single product.
list_coupon_invites ~198 tokens
List who a coupon was offered to and what they did with it: per-address status (invited / redeemed / revoked), where the invite came from, and the timestamps. Also returns the coupon's own `invite_only` flag -- read that FIRST: when it is false the invite rows are recorded but NOT enforced, and anyo
list_coupons ~145 tokens
List discount coupons (code, percent off, expiry, max uses, use count, which paid tiers they apply to). Optionally scope by app_id and/or restrict to currently-active ones (not expired, not maxed out). Read-only: cannot create, edit, or delete coupons.
list_plans ~177 tokens
Download an app's live plan catalog: tiers, names, prices, trial, and the machine-readable `limits` that gate features inside the app. This is the source of truth each app repo's `bun run plans:sync` regenerates lib/spark-pay/plans.json from, so diff against this rather than trusting the committed f
list_recent_cancellations ~135 tokens
Recently canceled paid subscriptions (excludes free rows), most recent cancellation first, with what each customer was paying. Use for churn review; list_subscriptions orders by signup date instead.
list_recent_payments ~136 tokens
List recent paid transactions (excludes free-tier rows), newest first, ordered by payment date. Optionally scope by app_id. Use to review recent sales activity. Amounts are in the transaction currency (cents).
list_referrals ~132 tokens
List referral records (who referred whom, reward coupon code, pending/rewarded status), newest first. Optionally scope by app_id and/or status.
list_subscriptions ~184 tokens
List subscriptions/registrations, newest first. Optionally filter by app_id, status, or payment_type. Returns metadata (email, status, plan, amounts). Use get_customer for a single user, or revenue_summary for totals.
plan_app_kit ~156 tokens
Step 1 of onboarding a new app onto SparkPay. Recons app_name against existing apps and the rest of the portfolio's plan catalogs, then returns automated findings plus the minimum set of questions that genuinely need a human answer (plan prices, billing model, redirect URLs, trial length, push-webho
revenue_by_app ~166 tokens
Per-app rollup in USD cents (latest_payments/refunded/MRR + paid customer count), largest refund-adjusted latest payments first. latest_payments sums the most recent payment per customer, so it is a run-rate and NOT lifetime turnover. No lifetime figure is available per app (accrual is recorded per
revenue_summary ~299 tokens
Revenue and subscriber summary in USD cents (normalized from each transaction currency). Returns latest_payments (the MOST RECENT payment summed per customer: a run-rate, NOT lifetime turnover, because amount_paid is overwritten on renewal), refunds, approximate MRR, active/trialing/paid counts, and
revoke_coupon_invite Changes accounts · ~324 tokens
Withdraw one address's right to spend a coupon: the targeted block. WRITE, human-gated: a real write requires an elicitation-capable client and the human sees the address and its current status; clients without elicitation are refused (dry_run works anywhere). Works on an address that was never invi
set_coupon_listed ~515 tokens
Show, hide or SCHEDULE an EXISTING coupon on the public pricing pages by setting its `listed` flag and optional `listed_from` start date. WRITE, human-gated: a real write requires an elicitation-capable client and the human sees the code, the discount, which way it is moving and any start date; clie
setup_pricing_page ~682 tokens
Guided, stage-chained wizard that configures an app's hosted pricing page end to end: plan billing model + price (with clickable recommendations), plan name and badge (elite/recommended), optional free tier, a seasonal coupon (SUMMER26-style code suggested from the current season), favicon-derived t
update_plan_limits ~390 tokens
Change the usage limits on an app's existing tiers (e.g. set ai_generations_daily to 200 on pro). WRITE, human-gated: a real write requires an elicitation-capable client; the human sees the per-tier before -> after diff and must click approve. Clients without elicitation are refused (dry_run still w
update_plan_meta ~425 tokens
Set an existing tier's display metadata: its name and the two badge flags the public pricing page styles cards from: is_elite (gold/carbon BEST VALUE card with the rainbow title and app icon) and recommended (MOST POPULAR). A tier called "Elite" is NOT styled as elite unless is_elite is actually tru
update_plan_pricing ~452 tokens
Change what an app's EXISTING tiers charge: the amount, the billing model (one_time vs subscription), or both. WRITE, human-gated at the highest tier: a real write requires an elicitation-capable client, and the human types the tier, billing model and price into a form. Those typed values OVERRIDE t

Browse

Related MCP servers

FavCRM
Agentic CRM for service businesses — bookings, customers, WhatsApp, loyalty, invoicing.
Autumn MCP by usefulapi
MCP server for Autumn — read customers, plans, balances & invoices; track usage and attach plans.
Memberful MCP by usefulapi
Manage Memberful members, subscriptions, plans, passes and coupons via the GraphQL API.
Sprkly
Schedule, publish and track social posts across TikTok, Instagram, Threads and YouTube Shorts.
MoonClerk MCP by usefulapi
Read MoonClerk payment forms, customers (plans with subscriptions) and payments. Read-only.
Inferventis — Financial Data, News & Web MCP
Live financial data MCP: FX, crypto, stocks, news, URL reader. x402 on Base: $0.001/call.
DealMachine
Search and enrich US property, owner, people, and company data for sales and lead generation.
Foxy.io MCP by usefulapi
Read Foxy transactions, subscriptions, customers, carts and coupons; update customers and subs.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/dev.sparkpay/sparkpay.svg)](https://aptlynx.net/servers/dev.sparkpay/sparkpay)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents