# GumroadDNA

> GumroadDNA is an open-source MCP server for e-commerce. Run a Gumroad store and size a niche from your AI chat, with 44 tools over the API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, API, CLI
- **Website:** https://vibedna.ai/store/gumroad
- **Repository:** https://github.com/marstudio360/gumroad-dna-mcp
- **MCP Registry name:** io.github.marstudio360/gumroad-dna-mcp
- **Categories:** e-commerce, marketing and SEO
- **Listing updated:** 2026-11-14

## About

GumroadDNA covers two jobs: checking whether a niche is worth entering, and running the store once you are in it. The niche scan reads the public Gumroad storefront for any keyword and reports how many products exist, the price spread and the top sellers by rating count. It needs no token and works for markets you do not sell in yet.

The store side wraps Gumroad API v2. The README groups the tools into products, files and images, sales, subscribers, license keys, offer codes, custom fields, stock, webhooks and account. Write tools such as `refund_sale`, `archive_product`, `delete_offer_code` and `delete_webhook` act on the live store, so the README advises letting your AI client ask before each call. Payments and payouts stay with Gumroad.

It runs locally over stdio with Python 3.10 or newer and your own access token, or serves streamable HTTP if a PORT is set. Network calls go to api.gumroad.com, to gumroad.com/discover for niche scans, and to vibedna.ai only when you call `check_for_update`. It is published by VibeDNA, whose site lists it among its free tools.

## Features

- **Niche scan:** Counts products, price range and top sellers for any keyword on the public storefront, without a token.
- **End-to-end product creation:** Creates a product, uploads the file, sets the cover and thumbnail and publishes it.
- **Sales and refunds:** Lists sales, refunds them, resends receipts and marks orders as shipped.
- **License keys:** Verifies, enables and disables license keys and decrements their use count.
- **Offers, fields and stock:** Manages offer codes, custom checkout fields and stock limits.
- **Revenue snapshot:** Reads back today, this week and this month revenue.
- **Webhooks and subscribers:** Lists, creates and deletes webhooks and reads subscribers.

## Good for

- Size up a Gumroad niche before building a product
- Publish a new product with its file and cover from chat
- Process a refund or resend a receipt for a buyer
- Check stock left on limited products
- Export buyer emails as a list for a mailing tool

## Install

### Claude Code (Terminal)

```sh
claude mcp add gumroad-dna-mcp --env GUMROAD_ACCESS_TOKEN='<GUMROAD_ACCESS_TOKEN>' -- npx -y https://github.com/marstudio360/gumroad-dna-mcp/releases/download/v2.3.0/gumroad-dna-mcp-2.3.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gumroad-dna-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/gumroad-dna-mcp/releases/download/v2.3.0/gumroad-dna-mcp-2.3.0.mcpb"
      ],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "<GUMROAD_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gumroad-dna-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/gumroad-dna-mcp/releases/download/v2.3.0/gumroad-dna-mcp-2.3.0.mcpb"
      ],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "<GUMROAD_ACCESS_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gumroad-dna-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/gumroad-dna-mcp/releases/download/v2.3.0/gumroad-dna-mcp-2.3.0.mcpb"
      ],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "<GUMROAD_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gumroad-dna-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/gumroad-dna-mcp/releases/download/v2.3.0/gumroad-dna-mcp-2.3.0.mcpb"
      ],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "<GUMROAD_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gumroad-dna-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/gumroad-dna-mcp/releases/download/v2.3.0/gumroad-dna-mcp-2.3.0.mcpb"
      ],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "<GUMROAD_ACCESS_TOKEN>"
      }
    }
  }
}
```

## Tools

- `scan_gumroad_niche`: Scans the public storefront for a keyword and reports product count, prices and top sellers.
- `create_product`: Creates a product.
- `launch_product`: Part of the product tools for putting a product live.
- `publish_product`: Publishes a product.
- `archive_product`: Archives a product on the live store.
- `list_sales`: Lists sales.
- `refund_sale`: Refunds a sale on the live store.
- `get_revenue_snapshot`: Returns today, week or month revenue.
- `verify_license`: Verifies a license key.
- `create_offer_code`: Creates an offer code.
- `get_stock_status`: Reports stock status and purchase limits.
- `create_webhook`: Creates a webhook.
- `sync_buyers_to_resend`: Exports unique buyer emails as a list; it does not call Resend itself.
- `check_for_update`: Checks whether the installed copy is current.

## FAQ

### Do I need a Gumroad token?

Yes for store tools, which use GUMROAD_ACCESS_TOKEN. Only scan_gumroad_niche works without one.

### How do I get the token?

In Gumroad, go to Settings, Advanced, Applications, create an application and generate an access token.

### Does it call Resend directly?

No. sync_buyers_to_resend only exports unique buyer emails as a list.

### Which licence is it under?

MIT, according to the README.

### Is GumroadDNA free?

Yes. GumroadDNA is open source, so you can use and self-host it for free.

### How do I add GumroadDNA to Claude Code?

Run this command in your terminal: claude mcp add gumroad-dna-mcp --env GUMROAD_ACCESS_TOKEN='<GUMROAD_ACCESS_TOKEN>' -- npx -y https://github.com/marstudio360/gumroad-dna-mcp/releases/download/v2.3.0/gumroad-dna-mcp-2.3.0.mcpb

### What are the best alternatives to GumroadDNA?

The closest alternatives to GumroadDNA are Google Ads + Meta Ads + SEO/GEO MCP, Calven, O'So MCP Server for PrestaShop, SecureCloud and MCP.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/gumroaddna
