GumroadDNA

io.github.marstudio360v2.2.0Updated Oct 6, 2026

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

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an assistant manage a Gumroad store from chat: products, files, sales, refunds, licenses, offer codes, webhooks, and niche scans.

What it does
GumroadDNA exposes 44 tools over the Gumroad API v2. It can create, launch, update, publish and archive products, add files and images, list and refund sales, resend receipts, mark orders shipped, read subscribers, verify and toggle license keys, manage offer codes, custom fields, stock and webhooks, and return a revenue snapshot for today, week or month. It also scans the public Gumroad storefront for a keyword to show product counts, price spread and top sellers.
When to use it
Useful for Gumroad creators who want to run store operations conversationally: launching a product end to end, checking revenue, handling refunds or license keys, or sizing a niche before entering it. The niche scan works without a token, so it can be tried before connecting an account.
Requirements
Runs locally over stdio with Python 3.10+ and the project's dependencies installed. A Gumroad access token is required in GUMROAD_ACCESS_TOKEN for everything except the public niche scan. Network access to api.gumroad.com and gumroad.com is needed; an optional PORT variable switches it to streamable HTTP.
Before you install
The token in GUMROAD_ACCESS_TOKEN grants access to a live store, so keep it out of shared configs. Write tools such as refund_sale, archive_product, delete_offer_code and delete_webhook act on real data and can move money or remove listings. The assistant asks before calling a tool unless you have allowed it. Requests go to Gumroad, and check_for_update contacts vibedna.ai.

Installation

In SourceWeft

  1. Open GumroadDNA 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

GumroadDNA MCP

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)

AreaTools
Market researchscan_gumroad_niche (public storefront, no token needed)
Productscreate_product, launch_product, update_product, publish_product, archive_product, list_products, download_product_files
Files and imagesadd_product_file, set_product_cover, add_product_image, list_product_images, remove_product_image, reorder_product_images, download_product_images
Salesget_revenue_snapshot, list_sales, get_sale, refund_sale, resend_receipt, mark_as_shipped
Subscriberslist_subscribers, get_subscriber
License keysverify_license, enable_license, disable_license, decrement_license_uses
Discounts and checkoutlist_offer_codes, create_offer_code, delete_offer_code, list_custom_fields, create_custom_field, delete_custom_field
Stockget_stock_status, update_stock, bump_stock
Webhookslist_webhooks, create_webhook, delete_webhook
Extrasscan_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 metaget_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.

bash
git clone https://github.com/marstudio360/gumroad-dna-mcpcd gumroad-dna-mcppip 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

bash
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:

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

VariableRequiredWhat it does
GUMROAD_ACCESS_TOKENYes (except for scan_gumroad_niche)Your Gumroad API token
PORTNoIf 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]

Source: README.md at commit aa5f767

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v2.2.0LatestOct 6, 2026