GumroadDNA

La API v2 de Gumroad desde el chat: productos, archivos, ventas, reembolsos, licencias, además de escaneos de nicho.

Documentación

GumroadDNA MCP

La API de Gumroad v2 desde el chat: productos, archivos, ventas, reembolsos, licencias, además de análisis de nichos.

GumroadDNA le da a tu IA 44 herramientas sobre la API de Gumroad v2: crea un producto de principio a fin (archivo, portada, miniatura, publicar), actualiza, publica y archiva productos, gestiona imágenes de productos, lista y reembolsa ventas, reenvía recibos, marca pedidos como enviados, lee suscriptores, verifica y alterna claves de licencia, gestiona códigos de oferta, campos personalizados y webhooks, y obtén un resumen de ingresos de hoy, la semana y el mes. También lee el escaparate público de Gumroad para cualquier palabra clave (cuántos productos, la dispersión de precios, los vendedores principales por recuento de valoraciones) para que puedas dimensionar un nicho antes de entrar en él.

Se ejecuta localmente sobre stdio con Python 3.10+ y tu propio token de acceso de Gumroad. Gratis.

Página de inicio: https://vibedna.ai/store/gumroad

Herramientas (44)

Área	Herramientas
Investigación de mercado	`scan_gumroad_niche` (escaparate público, no se necesita token)
Productos	`create_product`, `launch_product`, `update_product`, `publish_product`, `archive_product`, `list_products`, `download_product_files`
Archivos e imágenes	`add_product_file`, `set_product_cover`, `add_product_image`, `list_product_images`, `remove_product_image`, `reorder_product_images`, `download_product_images`
Ventas	`get_revenue_snapshot`, `list_sales`, `get_sale`, `refund_sale`, `resend_receipt`, `mark_as_shipped`
Suscriptores	`list_subscribers`, `get_subscriber`
Claves de licencia	`verify_license`, `enable_license`, `disable_license`, `decrement_license_uses`
Descuentos y pago	`list_offer_codes`, `create_offer_code`, `delete_offer_code`, `list_custom_fields`, `create_custom_field`, `delete_custom_field`
Inventario	`get_stock_status`, `update_stock`, `bump_stock`
Webhooks	`list_webhooks`, `create_webhook`, `delete_webhook`
Extras	`scan_unlisted_assets` (cuáles de los nombres de proyecto que pases no tienen listado), `sync_buyers_to_resend` (exporta correos electrónicos únicos de compradores como lista; no llama a Resend por sí mismo)
Cuenta y metadatos	`get_account`, `vibedna_info`, `check_for_update`

refund_sale, archive_product, delete_offer_code, delete_webhook y las demás herramientas de escritura actúan sobre tu tienda en vivo. Tu cliente de IA pregunta antes de llamar a una herramienta a menos que lo hayas permitido.

Instalación

Obtén un token de acceso de 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

El token puede estar en la entrada de MCP (abajo) o en un archivo .env junto a server.py (copia .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

O en el .mcp.json de un proyecto:

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

Cursor

Añade el mismo bloque mcpServers a ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto).

Claude Desktop

Añade el mismo bloque mcpServers a claude_desktop_config.json (Settings > Developer > Edit Config) y luego reinicia Claude Desktop.

INSTALL.md es una guía paso a paso escrita para que puedas pegarla en un chat de IA y dejar que la IA haga la instalación.

Configuración

Variable	Requerida	Qué hace
`GUMROAD_ACCESS_TOKEN`	Sí (excepto para `scan_gumroad_niche`)	Tu token de API de Gumroad
`PORT`	No	Si se establece, sirve HTTP transmisible en ese puerto en lugar de stdio

Red

Las llamadas van a api.gumroad.com con tu token, a gumroad.com/discover para análisis de nichos, y a vibedna.ai/api/mcp/latest solo cuando llamas a check_for_update.

Licencia

Soporte: admin@vibedna.ai