GumroadDNA

io.github.marstudio360v2.2.0更新于 Oct 6, 2026

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

已验证STDIO仅桌面Business & CommerceFinance

概览

AI 生成的概览

让助手在对话中管理 Gumroad 店铺：商品、文件、销售、退款、许可证、优惠码、Webhook 以及细分市场扫描。

功能
GumroadDNA 基于 Gumroad API v2 提供 44 个工具。它可以创建、发布、更新、上架和归档商品，添加文件与图片，列出并退款销售记录，重发收据，标记订单已发货，读取订阅者，验证和切换许可证密钥，管理优惠码、自定义字段、库存和 Webhook，并返回今日、本周或本月的收入快照。它还能按关键词扫描 Gumroad 公开店铺，显示商品数量、价格分布和热门卖家。
适用场景
适合希望用对话方式运营店铺的 Gumroad 创作者：端到端上架商品、查看收入、处理退款或许可证密钥，或在进入某个细分市场前评估其规模。细分市场扫描无需令牌，可在连接账号前先试用。
运行要求
以 stdio 方式在本地运行，需要 Python 3.10+ 并安装项目依赖。除公开的细分市场扫描外，其余功能都需要在 GUMROAD_ACCESS_TOKEN 中提供 Gumroad 访问令牌。需要访问 api.gumroad.com 和 gumroad.com 的网络连接；可选的 PORT 变量可切换为流式 HTTP。
安装前请注意
GUMROAD_ACCESS_TOKEN 中的令牌可访问真实店铺，请勿放入共享配置。refund_sale、archive_product、delete_offer_code、delete_webhook 等写入类工具会操作真实数据，可能涉及资金变动或下架商品。除非你已授权，助手在调用工具前会先询问。请求会发送至 Gumroad，check_for_update 会联系 vibedna.ai。

安装

在 SourceWeft 中

  1. 打开 控制台中的 GumroadDNA，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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]

来源：README.md，提交 aa5f767

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v2.2.0最新Oct 6, 2026