Indie Founder Revenue MCP

io.github.charlie-morrisonPublished by GitHub account charlie-morrisonv0.2.0Updated Oct 24, 2026

Aggregates Lemon Squeezy, Gumroad, Polar, and Stripe revenue into one Claude-queryable view.

The publisher's own server: Agent Web Reader

Overview

AI-generated overview

Aggregates Lemon Squeezy, Gumroad, Polar, and Stripe revenue into one queryable view for MRR, orders, customers, refunds, and tax CSV export.

What you can do
Combines revenue data from Lemon Squeezy, Gumroad, Polar, and Stripe into a single normalized view. Free tools include summary_mrr for combined MRR/ARR with per-provider breakdown, recent_orders for the latest orders across stores, and health for per-adapter status checks. Paid tools add top_customers, refund_signal for refund-ratio alerts, and export_csv_for_tax for quarterly CSV export with NBU exchange rates.
When to use it
Useful for solo founders or small teams running multiple storefronts who want to ask an assistant for combined revenue figures instead of checking several dashboards. Also relevant for Ukrainian FOP third-group filers who need a quarterly tax CSV with NBU rates.
Requirements
Runs locally as a stdio process, installed via uvx from the Git repository or a local clone with pip. Requires at least one provider credential: LS_API_TOKEN, GUMROAD_ACCESS_TOKEN, POLAR_API_TOKEN, or STRIPE_API_KEY. Optional LS_STORE_ID and POLAR_ORG_ID filters. Paid tools require INDIE_FOUNDER_MCP_LICENSE_KEY. Network access to provider APIs and bank.gov.ua.
Before you install
Requires secret API keys for payment providers (LS_API_TOKEN, GUMROAD_ACCESS_TOKEN, POLAR_API_TOKEN, STRIPE_API_KEY) and a paid-tier license key (INDIE_FOUNDER_MCP_LICENSE_KEY). The paid tier costs $19/mo or $190/yr. The export_csv_for_tax tool sends requests to bank.gov.ua for exchange rates. Review provider key scopes before granting access.

Installation

In SourceWeft

  1. Open Indie Founder Revenue MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Indie Founder Revenue MCP

[charlie-morrison/indie-founder-mcp MCP server]

A Model Context Protocol server that aggregates revenue across Lemon Squeezy + Gumroad + Polar + Stripe into a single Claude-queryable view. A solo founder can ask Claude "what's my MRR across all my stores?" — and Claude answers from one tool call instead of four browser tabs.

Status: v0.2 — all four adapters shipped. LS + Gumroad live-validated against production; Polar + Stripe offline-validated (live test requires your own org/account). Freemium: 3 tools free, 3 paid (see Pricing).

Tools exposed to Claude

ToolTierWhat it does
summary_mrr(days=30)FreeCombined MRR / ARR across every connected store. Per-provider breakdown.
recent_orders(limit=20)FreeLast N orders across all stores, normalized to one schema.
health()FreePer-adapter healthcheck — useful before the others.
top_customers(limit=10, days=30)PaidHighest-revenue customers in window, ranked by gross USD.
refund_signal(days=7, alert_multiplier=2.0)PaidCurrent N-day refund ratio vs prior N-day window. Fires alert when ratio jumps ≥2x. Zero-case safe.
export_csv_for_tax(year, quarter)PaidCSV export for Ukrainian FOP 3rd-group quarterly filing. NBU USD/UAH exchange rate per-order from bank.gov.ua.

Install (Claude Desktop / Claude Code / Cursor)

Until the PyPI release lands, install from this Git repo via uvx:

json
{  "mcpServers": {    "indie-founder": {      "command": "uvx",      "args": [        "--from",        "git+https://github.com/charlie-morrison/indie-founder-mcp@main",        "indie-founder-mcp"      ],      "env": {        "LS_API_TOKEN": "your_lemon_squeezy_token_here",        "LS_STORE_ID": "optional_store_id_filter",        "GUMROAD_ACCESS_TOKEN": "optional_gumroad_token",        "POLAR_API_TOKEN": "optional_polar_token",        "STRIPE_API_KEY": "optional_stripe_secret_key",        "INDIE_FOUNDER_MCP_LICENSE_KEY": "optional_license_key_for_paid_tier"      }    }  }}

Drop this into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop.

Get a Lemon Squeezy API token from https://app.lemonsqueezy.com/settings/api.

Local clone install

bash
git clone https://github.com/charlie-morrison/indie-founder-mcp.gitcd indie-founder-mcppip install -e .indie-founder-mcp  # runs stdio transport

What makes this different from the 3 existing LS MCPs

Three open-source LS-only MCPs already exist on GitHub. All expose raw CRUD API calls. None monetized, none aggregated.

This MCP differs:

  1. Multi-source aggregation — one query surface across LS + Gumroad + Polar + Stripe (all four shipped in v0.2).
  2. Summarized indie-founder daily view — MRR, top customer, refund signal, churn risk — not raw API parroting.
  3. CSV export for Ukrainian FOP tax filing — third-section single-tax filers need a specific NBU-rate-anchored format.
  4. Freemium with paid tier — Lemon Squeezy license keys gate the analytics + tax-export tools; the daily-check tools stay free forever.

Production validation

Built and validated on the author's own charliemorrison.lemonsqueezy.com store (store ID 344362) and live Gumroad account:

  • health → {"lemonsqueezy": true, "gumroad": true} against each provider's /users/me-equivalent.
  • recent_orders → returns the real $17 Social Media AI Mastery LS order from [email protected] on 2026-05-07, normalized into the same schema as Gumroad orders.
  • summary_mrr → $0 MRR (correct — no subscriptions converted yet on these stores; the tool's plumbing across active/trialing/past_due statuses is exercised).
  • top_customers(limit=5, days=90) → ranks customers by lifetime USD across all wired providers.
  • refund_signal(days=7) → zero-case alert=False for healthy young stores.
  • export_csv_for_tax(2026, 2) → one row, 2026-05-07,lemonsqueezy,8274123,[email protected],Social Media AI Mastery,17.00,0.00,17.00,43.8528,745.50,745.50 — NBU rate fetched live from bank.gov.ua.

Polar + Stripe adapters are offline-validated (24 fixture tests across all four adapters pass). Live validation against those two requires the user's own Polar org / Stripe account — the adapter wires automatically when the corresponding env var is set.

Pricing

TierPriceTools
Free$0summary_mrr, recent_orders, health — the daily-check loop. Unlimited stores.
Paid$19/mo or $190/yr (2 months free)All Free tools plus top_customers, refund_signal, export_csv_for_tax (analytics + Ukrainian FOP CSV export).

Buy a license: https://charliemorrison.lemonsqueezy.com → drop the key into INDIE_FOUNDER_MCP_LICENSE_KEY and restart your MCP host.

Free tools never check the license — there's no rug-pull. The paid tier is just the analytics + export surface for people who want them.

License & monetization stack

  • Code: MIT (open server; paid features gated by a Lemon Squeezy license key at runtime).
  • License keys: Lemon Squeezy License API (/v1/licenses/validate), 6-hour validation cache.
  • Payouts: LS → Wise USD (proven — $17 cleared on the dogfood store).

Build plan

See PLAN.md for the staged build sequence. v0.2 ships all four adapters + license gate + 6 tools (3 free, 3 paid).

Why this exists

I was opening four dashboard tabs (Lemon Squeezy, Gumroad, Polar, Stripe) every morning to check MRR and recent orders, then re-doing the same math in a spreadsheet for FOP tax filing. So I asked Claude to consolidate it. This is the result — and now Claude does the morning check itself.


Built by Charlie Morrison. Issues + PRs welcome.

Source: README.md at commit a5c0ce6

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Charliemorrison integrations