GumroadDNA

A API v2 do Gumroad via chat: produtos, arquivos, vendas, reembolsos, licenças, além de varreduras de nicho.

Documentação

MCP GumroadDNA

A API v2 do Gumroad via chat: produtos, arquivos, vendas, reembolsos, licenças, além de análises de nicho.

O GumroadDNA dá à sua IA 44 ferramentas sobre a API v2 do Gumroad: crie um produto de ponta a ponta (arquivo, capa, miniatura, publicação), atualize, publique e arquive produtos, gerencie imagens de produtos, liste e reembolse vendas, reenvie recibos, marque pedidos como enviados, leia assinantes, verifique e alterne chaves de licença, gerencie códigos de desconto, campos personalizados e webhooks, e obtenha um resumo de receita de hoje, da semana e do mês. Também lê a vitrine pública do Gumroad para qualquer palavra-chave (quantos produtos, a variação de preços, os principais vendedores por contagem de avaliações) para que você possa avaliar um nicho antes de entrar nele.

Executa localmente via stdio com Python 3.10+ e seu próprio token de acesso do Gumroad. Gratuito.

Página inicial: https://vibedna.ai/store/gumroad

Ferramentas (44)

Área	Ferramentas
Pesquisa de mercado	`scan_gumroad_niche` (vitrine pública, sem necessidade de token)
Produtos	`create_product`, `launch_product`, `update_product`, `publish_product`, `archive_product`, `list_products`, `download_product_files`
Arquivos e imagens	`add_product_file`, `set_product_cover`, `add_product_image`, `list_product_images`, `remove_product_image`, `reorder_product_images`, `download_product_images`
Vendas	`get_revenue_snapshot`, `list_sales`, `get_sale`, `refund_sale`, `resend_receipt`, `mark_as_shipped`
Assinantes	`list_subscribers`, `get_subscriber`
Chaves de licença	`verify_license`, `enable_license`, `disable_license`, `decrement_license_uses`
Descontos e checkout	`list_offer_codes`, `create_offer_code`, `delete_offer_code`, `list_custom_fields`, `create_custom_field`, `delete_custom_field`
Estoque	`get_stock_status`, `update_stock`, `bump_stock`
Webhooks	`list_webhooks`, `create_webhook`, `delete_webhook`
Extras	`scan_unlisted_assets` (quais dos nomes de projetos que você passar não têm listagem), `sync_buyers_to_resend` (exporta e-mails únicos de compradores como uma lista; não chama o Resend diretamente)
Conta e meta	`get_account`, `vibedna_info`, `check_for_update`

refund_sale, archive_product, delete_offer_code, delete_webhook e as outras ferramentas de escrita agem na sua loja ao vivo. Seu cliente de IA pergunta antes de chamar uma ferramenta, a menos que você tenha permitido.

Instalação

Obtenha um token de acesso do Gumroad: 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

O token pode ficar na entrada do MCP (abaixo) ou em um arquivo .env ao lado de server.py (copie .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

Ou no .mcp.json de um projeto:

{
  "mcpServers": {
    "gumroad-dna": {
      "command": "python",
      "args": ["/absolute/path/to/gumroad-dna-mcp/server.py"],
      "env": { "GUMROAD_ACCESS_TOKEN": "your_token" }
    }
  }
}

Cursor

Adicione o mesmo bloco mcpServers ao ~/.cursor/mcp.json (todos os projetos) ou ao .cursor/mcp.json (um projeto).

Claude Desktop

Adicione o mesmo bloco mcpServers ao claude_desktop_config.json (Settings > Developer > Edit Config) e reinicie o Claude Desktop.

INSTALL.md é um guia passo a passo escrito para que você possa colá-lo em um chat de IA e deixar a IA fazer a instalação.

Configuração

Variável	Obrigatória	O que faz
`GUMROAD_ACCESS_TOKEN`	Sim (exceto para `scan_gumroad_niche`)	Seu token da API do Gumroad
`PORT`	Não	Se definido, serve HTTP transmitível nessa porta em vez de stdio

Rede

As chamadas vão para api.gumroad.com com seu token, para gumroad.com/discover para análises de nicho e para vibedna.ai/api/mcp/latest somente quando você chama check_for_update.

Licença

Suporte: admin@vibedna.ai