# Gumroad MCP

> Gumroad MCP Server manages your entire e-commerce backend. Connect your Gumroad account to any AI agent to handle product listings, check sales history, verify licenses, process refunds, and monitor payouts—all without leaving the chat window. It gives you full control over your digital store's operations and customer data.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** digital-products, sales-tracking, creator-economy, license-verification, revenue-analytics

## Description

Connect your Gumroad account to any AI agent and manage your whole e-commerce backend. This server treats your Gumroad store like a backend API, letting your agent handle operations usually requiring you to log into the Gumroad dashboard, click through tabs, or export CSVs. You'll get full control over your digital store's operations and customer data, all without leaving the chat window.

**List all products:** Your agent can get a list of every active item in your Gumroad store, giving you the names and current prices. You can also check deep information about any single product using its ID or name. 

**Review sales transactions:** Your agent accesses and displays detailed records for all your sales, giving you a complete sales history. You can pull up full details for any specific sale transaction, and you can process a refund for a specific sale.

**Manage customer lists:** You'll get lists of every customer who bought something from you or subscribed to your content. You can also get a list of all users subscribed to your content or newsletter.

**Verify license keys:** It checks if a provided license key is valid and tracks how many times it's been used for specific digital assets.

**Track financial payouts:** Your agent pulls your complete history of payments received and shows you your current account balance. You can also retrieve basic info about your Gumroad user account.

**Process refunds:** Your agent handles refunds for a specified sale transaction, bypassing the manual dashboard process.

**See your inventory:** You can get a list of all products in your Gumroad account, and you can also get detailed info for a specific product using its name or ID.

## Tools

### get_my_profile
Retrieves basic information about your Gumroad user account.

### get_product
Gets detailed information for a specific product by name or ID.

### get_sale
Retrieves full details for a single, specific sale transaction.

### list_payers
Lists all customers who have made purchases from your store.

### list_payouts
Retrieves your historical payout and balance information.

### list_products
Lists every product currently available in your Gumroad account.

### list_sales
Retrieves a complete list of all sales and transactions.

### list_subscribers
Lists all users subscribed to your content or newsletter.

### refund_sale
Processes a refund for a specified sale transaction.

### verify_license
Checks the validity and usage count of a specific product license key.

## Prompt Examples

**Prompt:** 
```
List all products in my Gumroad store.
```

**Response:** 
```
I've retrieved your products. You have 5 active items: 'Mastering AI' ($49.00), 'DevOps Toolkit' ($29.00), 'Python Course' ($99.00), and 2 more. Which one would you like to see more details for?
```

**Prompt:** 
```
Show me the sales history for the last 24 hours.
```

**Response:** 
```
Fetching recent transactions... You've had 12 sales in the last 24 hours, totaling $588.00 in gross revenue. The most recent purchase was 'Mastering AI' by customer@example.com. Should I list all individual transactions?
```

**Prompt:** 
```
Verify license key ABC-123 for the DevOps Toolkit.
```

**Response:** 
```
Checking license key... The key ABC-123 for 'DevOps Toolkit' is VALID. It has been used 1 time out of a maximum of 3 allowed activations. The customer email is buyer@example.com.
```

## Capabilities

### List all products
Gets a list of all active items in your Gumroad store, including names and current prices.

### Check product details
Retrieves deep information about a single product using its ID or name.

### Review sales transactions
Accesses and displays detailed records for specific sales or the entire sales history.

### Handle refunds
Processes a refund for a specific sale transaction, bypassing the manual dashboard process.

### Verify license keys
Checks if a provided license key is valid and tracks its usage count for specific digital assets.

### Track financial payouts
Retrieves the complete history of payments received and your current account balance.

### Manage customer lists
Retrieves lists of all customers who have purchased from you or subscribed to your content.

## Use Cases

### The Support Agent needs to verify a paid course license.
A customer calls claiming their course access is broken. Instead of asking the customer to email screenshots, the agent runs `verify_license(key='XYZ-123')`. The agent confirms the key is VALID and reports the remaining activations immediately.

### The Ops Manager needs to audit last month's revenue.
The manager doesn't want to open a spreadsheet. They ask the agent to run `list_sales` for the last 30 days, totaling the revenue and identifying the top 5 selling products in one go. They then use `list_payers` to see the names associated with the bulk of the sales.

### The Creator needs to adjust a product's pricing.
The creator wants to check if the 'DevOps Toolkit' is priced correctly. They run `get_product(product_id='devops')` to see the current details and pricing. If they need to list everything, they use `list_products` first to confirm the correct ID.

### Handling a complex return/refund.
A customer needs a refund for a sale from three months ago. The agent first runs `get_sale(sale_id='ABC-999')` to confirm the details, then executes `refund_sale(sale_id='ABC-999')`. The entire process is logged and confirmed in the chat.

## Benefits

- Stop manual data exports. Use `list_sales` or `list_products` to pull live data directly into your chat, eliminating CSV generation and dashboard hopping.
- Speed up customer service. With `get_sale` and `verify_license`, your agent instantly pulls transaction details or license status during a support call.
- Control your cash flow. Use `list_payouts` to see your payout history and account balance without navigating complex financial sections.
- Handle support tasks efficiently. The `refund_sale` tool lets you process refunds for a specific transaction using a simple command.
- Understand your audience. `list_subscribers` gives you the full list of people who signed up, while `list_payers` tracks who actually spent money.
- Deep product knowledge. `get_product` lets you check specific product details, so you can answer questions about pricing or features immediately.

## How It Works

The bottom line is you talk to your agent like talking to a human operations manager, and the agent handles all the backend API calls for you.

1. Subscribe to the Gumroad MCP Server and enter your Gumroad Access Token.
2. Your AI client runs a command, like 'Show me the sales for the last month.'
3. The server executes the necessary tools (e.g., `list_sales`, `get_sale`) and sends the compiled data back to your chat.

## Frequently Asked Questions

**How do I use the `list_products` tool on Gumroad?**
Run `list_products()` to get a complete inventory of everything you sell. This tool gives you all the product names, IDs, and basic pricing info in one list.

**Can I check a license key using the `verify_license` tool?**
Yes. The `verify_license(key='...')` tool checks if a key is valid for a specific product and tells you how many times it's been used.

**What is the difference between `list_sales` and `list_payouts`?**
`list_sales` gives you a record of every transaction (the gross revenue). `list_payouts` shows the actual money that was transferred to your bank account, after fees and processing.

**How do I process a refund using `refund_sale`?**
You must provide the specific sale ID. The agent runs `refund_sale(sale_id='...')` and processes the refund directly.

**Can I see all my customers with `list_payers`?**
Yes, `list_payers()` pulls a list of every customer who has made a purchase from your store. It's a direct list of people who spent money.

**How do I find all customers who bought specific products using `list_payers` and `get_product`?**
You can combine these tools by listing products first, then using `list_payers` to see who bought them. Your agent gathers the product ID and uses that to filter the list of buyers.

**What information does `get_sale` provide about a single transaction?**
It gives detailed records for one sale. You get the buyer's name, the product purchased, the final price, and the date of the transaction.

**What are the limits or error codes I might get when using `list_sales`?**
If you hit limits, the tool response will include a rate limit message. For incorrect parameters, it returns a specific error code, telling you exactly what needs fixing.

**How do I get my Gumroad Access Token?**
Log in to your Gumroad account, navigate to **Settings > Advanced**, and scroll down to the 'Application' section to create an application or generate a personal access token.

**Can I verify customer license keys through this integration?**
Yes! Use the `verify_license` tool by providing the `product_id` and the `license_key` provided by the customer. The agent will confirm if the key is valid and how many times it has been used.

**Does this integration support processing refunds?**
Yes, you can use the `refund_sale` tool with a specific sale ID to initiate a refund directly from your AI agent.

**Is my sales data secure?**
Absolutely. The integration uses OAuth 2.0 Bearer tokens and communicates only with Gumroad's official API over HTTPS. Your token is encrypted and stored securely in the Vinkius Cloud.