GumroadDNA

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

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

已驗證STDIO僅桌面FinanceBusiness & Commerce

概覽

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