Gumroad Dna

The Gumroad API v2 from chat: products, files, sales, refunds, licenses, plus niche scans.

GumroadDNA gives your AI 44 tools over the Gumroad API v2: create a product end to end (file, cover, thumbnail, publish), update, publish and archive products, manage product images, list and refund sales, resend receipts, mark orders shipped, read subscribers, verify and toggle license keys, manage offer codes, custom fields and webhooks, and get a today, week and month revenue snapshot. It also reads the public Gumroad storefront for any keyword (how many products, the price spread, top sellers by rating count) so you can size a niche before you enter it.

Runs locally over stdio with Python 3.10+ and your own Gumroad access token. Free.

Homepage: https://vibedna.ai/store/gumroad

Tools (44)

Area	Tools
Market research	scan_gumroad_niche (public storefront, no token needed)
Products	create_product, launch_product, update_product, publish_product, archive_product, list_products, download_product_files
Files and images	add_product_file, set_product_cover, add_product_image, list_product_images, remove_product_image, reorder_product_images, download_product_images
Sales	get_revenue_snapshot, list_sales, get_sale, refund_sale, resend_receipt, mark_as_shipped
Subscribers	list_subscribers, get_subscriber
License keys	verify_license, enable_license, disable_license, decrement_license_uses
Discounts and checkout	list_offer_codes, create_offer_code, delete_offer_code, list_custom_fields, create_custom_field, delete_custom_field
Stock	get_stock_status, update_stock, bump_stock
Webhooks	list_webhooks, create_webhook, delete_webhook
Extras	scan_unlisted_assets (which of the project names you pass have no listing), sync_buyers_to_resend (exports unique buyer emails as a list; it does not call Resend itself)
Account and meta	get_account, vibedna_info, check_for_update

refund_sale, archive_product, delete_offer_code, delete_webhook and the other write tools act on your live store. Your AI client asks before calling a tool unless you have allowed it.

Install

Get a Gumroad access token: app.gumroad.com/settings/advanced > Applications > Create application > Generate access token.

git clone https://github.com/marstudio360/gumroad-dna-mcp
cd gumroad-dna-mcp
pip install -r requirements.txt

The token can live in the MCP entry (below) or in a .env file next to server.py (copy .env.example).

Claude Code

claude mcp add gumroad-dna --scope user -e GUMROAD_ACCESS_TOKEN=your_token -- python /absolute/path/to/gumroad-dna-mcp/server.py

Or in a project's .mcp.json:

{
  "mcpServers": {
    "gumroad-dna": {
      "command": "python",
      "args": ["/absolute/path/to/gumroad-dna-mcp/server.py"],
      "env": { "GUMROAD_ACCESS_TOKEN": "your_token" }
    }
  }
}

Cursor

Add the same mcpServers block to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project).

Claude Desktop

Add the same mcpServers block to claude_desktop_config.json (Settings > Developer > Edit Config), then restart Claude Desktop.

INSTALL.md is a step-by-step guide written so you can paste it into an AI chat and let the AI do the install.

Configuration

Variable	Required	What it does
GUMROAD_ACCESS_TOKEN	Yes (except for scan_gumroad_niche)	Your Gumroad API token
PORT	No	If set, serves streamable HTTP on that port instead of stdio

Network

Calls go to api.gumroad.com with your token, to gumroad.com/discover for niche scans, and to vibedna.ai/api/mcp/latest only when you call check_for_update.

License

MIT, see LICENSE. Copyright (c) 2026 VibeDNA.

Support: [email protected]