Yes, The Gumroad is free to use.

How do I install The Gumroad?

The Gumroad is a local plugin. Install it using the provided package and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is The Gumroad safe to use?

Yes. The Gumroad passed MCP Marketplace's automated security scan with a score of 10/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does The Gumroad need?

The Gumroad requires the following credentials or environment variables: GUMROAD_ACCESS_TOKEN. You can find setup instructions on the server detail page.

What AI apps work with The Gumroad?

The Gumroad uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

The Gumroad MCP Server

by Mariano

Developer ToolsLow Risk10.0Local

Free

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

About

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

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (1 strong, 3 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

3 files analyzed · No issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Your Gumroad access token (Settings > Advanced > Applications).Required

Environment variable: GUMROAD_ACCESS_TOKEN

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-marstudio360-gumroad-dna-mcp": {
      "env": {
        "GUMROAD_ACCESS_TOKEN": "your-gumroad-access-token-here"
      },
      "args": [
        "-y",
        "github:marstudio360/gumroad-dna-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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)

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.