gumroad-mcp
Provides read-only access to a Gumroad store, allowing products listing, sales retrieval with pagination and totals, and revenue summaries net of refunds.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gumroad-mcp how much revenue did I make this month?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
gumroad-mcp
Read-only MCP server for your Gumroad store — products, sales, and revenue summaries, exposed as tools your AI agent can call.
Built by a store operator, not from the API docs alone:
Sales are fully paginated — and say so when they aren't. The v2 sales endpoint pages by
page_key; naive clients read page 1 and silently under-report. This server walks every page. There is a hard page cap so a huge store can't hang a session, and if that cap is ever hit the response carries"complete": falseplus an explicit warning that the totals are a floor. A truncated total is never returned as if it were the real number.Money is integer cents + a formatted string. Models shouldn't do float arithmetic on revenue.
Refunds are first-class.
salesandrevenue_summaryreport gross and net-of-refunds.Buyer privacy by default. Sales rows expose the buyer's email domain only — enough for channel analysis, no PII handed to the model.
Read-only by design. Only GET endpoints. The token comes from the environment and is never echoed or logged.
No false delivery alarms. Gumroad returns an empty
file_infofor multi-file products, so "empty" does not mean "no file attached". This server reports that field as the raw API fact it is (file_info_reported_by_api) and attaches a note, instead of asserting a delivery status the endpoint cannot actually tell you.
Requires the 1.x MCP SDK.
mcp2.0.0 removedmcp.server.fastmcp, so the dependency is pinnedmcp>=1.0.0,<2.0.0. Porting to the 2.x (mcp.server.mcpserver) API is tracked as follow-up.
Tools
Tool | What it answers |
| What am I actually selling? Name, permalink, price, published state, sales count |
| Every sale in a window, paginated to the end, with totals |
| One-call health check: product counts, lifetime sales per product, revenue since a date (default: this month) |
Related MCP server: Shopify MCP
Install
git clone https://github.com/stcmain/gumroad-mcp.git
cd gumroad-mcp
pip install .Get a token: Gumroad → Settings → Advanced → Applications → create app → copy the access token.
Register with Claude Code:
claude mcp add --scope user gumroad --env GUMROAD_ACCESS_TOKEN=your_token -- gumroad-mcpOr any MCP client config:
{
"mcpServers": {
"gumroad": {
"command": "gumroad-mcp",
"env": { "GUMROAD_ACCESS_TOKEN": "your_token" }
}
}
}License
MIT © Zachary Pampu
Available Tools
3 toolslist_productsA
List all products in the store: name, permalink, price, published state, and sales count. Answers 'what am I actually selling right now?'
Inputs: no named parameters. Returns: result
revenue_summaryA
One-call store health check: product count, published count, lifetime
sales counts per product, and revenue since after (YYYY-MM-DD, default:
start of current month). The number an operator actually wants first.
Inputs: after. Returns: result
salesA
List sales, fully paginated. Dates are YYYY-MM-DD (after defaults to today — pass e.g. after='2026-01-01' for history). Returns per-sale price, product, email domain (full buyer email withheld), refund state, and totals.
Inputs: after, before, product_id. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Tools are mostly distinct: list_products focuses on the product catalog, sales provides transaction-level details, and revenue_summary gives aggregate metrics. There is minor overlap in sales counts per product between list_products and revenue_summary, but descriptions clarify their different intents.
Naming is mixed: list_products follows verb_noun, while sales and revenue_summary are plain nouns. All are lowercase snake_case, but the lack of a consistent verb_prefix pattern makes it slightly less predictable.
Three tools is a tight, well-scoped set for a read-only store analytics server. Each tool covers a distinct high-level need (catalog, transactions, summary) without unnecessary bloat or missing core functions.
For the apparent purpose of store health monitoring, the surface is fairly complete: product listings, detailed sales history, and revenue summaries are all covered. A minor gap is the lack of a single-product detail or sales-by-sale retrieval, but pagination and filtering mitigate this.
Maintenance
Related MCP Connectors
MCP server for Lemon Squeezy — stores, products, orders, subscriptions, license keys.
Federated commerce search across independent WooCommerce merchants. Keyless, read-only MCP server.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
MerchantFlow is a hosted, read-only ecommerce analytics MCP server for Shopify and WooCommerce. It gives AI assistants tenant-scoped access to revenue, profit and loss, product and SKU profitability, COGS coverage, fulfillment costs, advertising spend, ROAS, marketing performance, cohorts, LTV, and business valuation across connected commerce and marketing platforms. Connect with OAuth over Streamable HTTP. No local server installation is required.
Related MCP Servers
- AlicenseAqualityFmaintenanceA Model Context Protocol (MCP) server implementation for Gumroad, enabling MCP-compatible AI clients like Claude Desktop to interact with Gumroad API.11216 npm32MIT
- AlicenseAqualityBmaintenanceA read-only MCP server that exposes the full Shopify Admin GraphQL API through 6 universal tools, with multi-store support and mutation rejection at the parser level for safety.630 PyPI1MIT
- AlicenseAqualityDmaintenanceMCP server that integrates with Gumroad API, enabling Claude to list products, view sales, and get sales summaries for your Gumroad store.4216 npmMIT
- AlicenseAqualityDmaintenanceA local-first, read-only MCP server for the Loyverse POS API that lets AI assistants query receipts, items, employees, customers, stores, and sales analytics — built for secure local use with Personal Access Tokens.1510 npmApache 2.0