# Gumroad MCP

> Gumroad MCP lets you use natural conversation to run your entire e-commerce business. List products, track sales history across date ranges, manage subscriber lists, and automate discount codes—all without leaving your chat window.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** digital-products, creator-economy, checkout-flow, transaction-history, subscription-management, sales-intelligence

## Description

You can connect Gumroad directly to any AI client and treat it like a dedicated store manager. Need to know how much you sold last month? Ask. Want to create a 20% code for a new campaign? Command it. The MCP gives your agent full control over product listings, transaction history, and customer data.

This lets you move beyond just viewing dashboards. You can list all products, retrieve detailed metadata, and even get the complete sale details for a specific ID to handle customer support instantly. When connected via Vinkius, your AI client becomes the central command point for everything related to your digital goods business. It’s about controlling every aspect of the checkout flow using plain language.

No more jumping between tabs or manually filtering data; you simply ask your agent what you need, and it handles the complex API calls.

## Tools

### create_offer_code
Generates a new discount code for your store.

### get_product_details
Retrieves specific pricing and metadata for any product you list.

### get_sale_details
Pulls every detail about a single, specific transaction ID.

### get_user_profile
Retrieves high-level details about your overall Gumroad account setup.

### list_offer_codes
Shows you all discount codes currently active for a product.

### list_products
Lists every digital product associated with your account.

### list_sales
Generates a list of recent sales, allowing you to filter by date range.

### list_product_subscribers
Retrieves the names and details of people subscribed to one specific product.

## Prompt Examples

**Prompt:** 
```
List all my products on Gumroad.
```

**Response:** 
```
I've retrieved your digital products. You have 5 active items, including 'Advanced AI Guide' ($49.00) and 'MCP Templates' ($19.00). Would you like the shareable URLs for any of these?
```

**Prompt:** 
```
Show me the sales from the last 7 days.
```

**Response:** 
```
Scanning transaction history... In the last 7 days, you've had 12 sales totaling $345.00. The best-selling product was 'MCP Templates'. Would you like a breakdown of each transaction?
```

**Prompt:** 
```
Create a 20% discount code named 'SUMMER26' for my AI Guide product.
```

**Response:** 
```
Done! I've created the offer code 'SUMMER26' for your 'Advanced AI Guide'. It provides a 20% discount and is ready for use on your checkout page.
```

## Capabilities

### Review Product Inventory
List all digital products and retrieve their pricing, URLs, and metadata.

### Analyze Sales Performance
Check transaction history using date filters to track revenue trends and identify best-selling items.

### Manage Discounts
Create, list, or manage fixed or percentage-based discount codes for marketing campaigns.

### Handle Customer Support Data
Retrieve full transaction details using a sale ID to verify purchases and resolve support issues quickly.

### Monitor Audience Growth
List all product subscribers or retrieve general account profile information.

## Use Cases

### Checking Quarterly Revenue Trends
A growth marketer needs to know the total sales from Q1. Instead of running reports on a separate analytics platform, they ask their agent to 'list recent sales for Q1'. The MCP uses `list_sales` to summarize the revenue and track acquisition trends.

### Fixing a Customer's Billing Dispute
A customer claims their payment failed. An e-commerce manager asks the agent to 'check sale ID GMR12345'. The MCP uses `get_sale_details` to retrieve all transaction information, confirming whether the payment was processed or if a specific step failed.

### Launching an Immediate Flash Sale
A digital creator has a sudden inventory surplus and needs an immediate discount. They prompt the agent: 'Create a 25% code named FLASH25 for my guides.' The MCP executes `create_offer_code`, making the campaign instantly ready.

### Analyzing Product Popularity
A marketer wants to see which product is keeping people engaged. They ask, 'Show me all subscribers for my advanced template pack.' The MCP uses `list_product_subscribers` and provides a clear roster of your most dedicated users.

## Benefits

- Stop manually checking spreadsheets for revenue. Your agent can use `list_sales` to pull transaction histories with date filters in seconds, giving you immediate insight into your cash flow.
- Never forget a marketing promotion again. You can instantly create new discount codes using `create_offer_code`, letting your AI client manage the entire launch cycle from prompt to active code.
- Handling customer support is faster than ever. Instead of digging through dashboards, you just ask for sale details and use `get_sale_details` to verify a purchase ID right in chat.
- Stay connected with your audience by tracking growth. Use `list_product_subscribers` to get an instant list of people subscribed to any specific item.
- Get a full view of your storefront using `list_products`. You can pull metadata and shareable URLs for everything you sell in one command.

## How It Works

The bottom line is you get a single conversational interface for managing complex e-commerce data that used to require multiple dashboards and API calls.

1. Subscribe to this MCP and generate your Application Token from your Gumroad Dashboard settings.
2. Provide your AI client with the necessary API credentials and authorize access through Vinkius.
3. Use natural language prompts—for example, 'Show me all sales over $50 last week'—and your agent executes the request.

## Frequently Asked Questions

**How do I use the Gumroad MCP to check sales?**
You ask your agent to list recent sales and provide date filters. The MCP uses `list_sales` to pull the transaction data, allowing you to track revenue trends over specific periods.

**Can I create a discount code using Gumroad MCP?**
Yes, simply ask your agent to generate one. It executes the `create_offer_code` tool, which handles setting up both fixed and percentage-based discounts for your products.

**What data does get_sale_details provide?**
This tool retrieves all high-fidelity details about a single sale ID. You can use this to verify purchases or troubleshoot customer support issues by getting the full transaction record.

**Does list_products give me everything I need?**
It gives you a complete listing of all products, including their metadata and shareable URLs. If you want specific details on one item's price point, use `get_product_details`.

**How do I check who subscribed to my course?**
You prompt your agent to list product subscribers. The MCP runs the `list_product_subscribers` tool, giving you an instant roster of everyone connected to that specific item.