Indie Founder Revenue MCP

io.github.charlie-morrison由 GitHub 帳號 charlie-morrison 發布v0.2.0更新於 Oct 24, 2026

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

發布方自己的服務:Agent Web Reader

概覽

AI 產生的概覽

將 Lemon Squeezy、Gumroad、Polar 和 Stripe 的收入彙整為單一可查詢檢視,用於 MRR、訂單、客戶、退款和稅務 CSV 匯出。

可以做什麼
將 Lemon Squeezy、Gumroad、Polar 和 Stripe 的收入資料合併為單一標準化檢視。免費工具包括 summary_mrr(合併 MRR/ARR 及依供應商細分)、recent_orders(各商店最新訂單)和 health(各適配器狀態檢查)。付費工具增加 top_customers、refund_signal(退款比率警示)和 export_csv_for_tax(帶 NBU 匯率的季度 CSV 匯出)。
適用情境
適合經營多個店面的獨立創辦人或小型團隊,希望讓助理直接給出合併收入數據,而不必查看多個儀表板。也適用於需要帶 NBU 匯率的季度稅務 CSV 的烏克蘭 FOP 第三組申報者。
執行需求
以 stdio 程序在本機執行,可透過 uvx 從 Git 儲存庫安裝,或本機複製後以 pip 安裝。至少需要一個供應商憑證:LS_API_TOKEN、GUMROAD_ACCESS_TOKEN、POLAR_API_TOKEN 或 STRIPE_API_KEY。選用 LS_STORE_ID 和 POLAR_ORG_ID 篩選器。付費工具需要 INDIE_FOUNDER_MCP_LICENSE_KEY。需要存取供應商 API 和 bank.gov.ua 的網路。
安裝前請注意
需要支付供應商的祕密 API 金鑰(LS_API_TOKEN、GUMROAD_ACCESS_TOKEN、POLAR_API_TOKEN、STRIPE_API_KEY)以及付費層授權金鑰(INDIE_FOUNDER_MCP_LICENSE_KEY)。付費層費用為每月 19 美元或每年 190 美元。export_csv_for_tax 工具會向 bank.gov.ua 發送請求以取得匯率。授予存取權限前請檢查供應商金鑰的權限範圍。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Indie Founder Revenue MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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.

來源:README.md,提交 a5c0ce6

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Charliemorrison 整合