# Gumroad MCP

> Gumroad MCP gives your AI agent full control over your digital store. You can manage product listings, track detailed sales history, verify customer licenses instantly, and process refunds—all through natural conversation. Stop jumping between dashboards; automate your e-commerce operations directly from any client.

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

## Description

Connect your Gumroad account to your preferred AI agent and take manual work off your plate. This MCP lets you treat your digital store like it's being run by a dedicated operations specialist, right inside the chat window. You can list all of your products, pull up individual sales records, or monitor where your payouts are heading without ever leaving your workflow. Need to verify if a customer's license key is legit? Your agent handles that instantly. If you have a refund request, it processes the necessary actions. This level of deep integration means you don't need to export CSV files or click through half a dozen tabs just to get an overview. Because Vinkius hosts this catalog, your agent can access all these functions from one place, giving you total command over your digital revenue stream.

## Tools

### get_my_profile
Pulls core information about your main Gumroad user account profile.

### get_product
Retrieves complete details for one specific item in your digital store.

### get_sale
Gets all the specifics about a single transaction or sale event.

### list_payers
Provides a list of every customer who has purchased something from you.

### list_payouts
Generates a history report detailing all the payments Gumroad has sent to your account.

### list_products
Displays every product currently active in your Gumroad catalog.

### list_sales
Lists a comprehensive record of all sales and transactions that have occurred.

### list_subscribers
Retrieves a list of people who are subscribed to your content or newsletter.

### refund_sale
Processes and initiates a refund for a specific, identified sale.

### verify_license
Confirms the status of a license key for an asset, noting if it's valid or expired.

## 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 and detail products
You can pull a full list of items in your store and get deep details on any specific product, including its current pricing.

### Monitor sales transactions
Check out the complete history of all sales, view individual customer purchases, or see who has paid you recently.

### Handle refunds and payouts
Process specific refunds for a sale or track your account balance by pulling comprehensive records of your payout history.

### Verify customer licenses
Instantly check if a license key is valid, how many times it has been used, and who the associated customer is.

### Review subscriber data
Retrieve your entire list of subscribers to understand audience growth and manage contacts directly from the conversation.

## Use Cases

### Investigating Low Revenue
A creator notices sales dipped last month. They ask the agent to run `list_sales` for the previous 30 days and compare it against the current period, quickly pinpointing the exact day revenue dropped.

### Handling Bulk Refunds
An ops manager realizes three customers were overcharged. Instead of going into the dashboard three times, they prompt the agent to identify the relevant sales and execute `refund_sale` for all three in one go.

### Auditing Customer Accounts
A support agent needs to confirm a customer's history. They ask the agent to pull both their profile details (`get_my_profile`) and check `list_subscribers` records for context in one conversation.

### Pre-Launch Inventory Check
A product manager wants to know if they need new marketing copy. They ask the agent to run `list_products` to get a complete list, then use `get_product` on the top three sellers for deep analysis.

## Benefits

- Stop manually exporting sales data. You can ask your agent to pull a list of all transactions and summarize key metrics immediately.
- Process refunds without touching the dashboard. Simply tell your agent which sale needs correcting, and it handles the `refund_sale` process for you.
- Instantly confirm product details or check pricing by asking to retrieve any specific item using the `get_product` tool.
- Get real-time insight into who's paying you with `list_payers`, letting you know exactly which customers transacted recently.
- When a customer asks about their key, your agent can use `verify_license` to give them an immediate, accurate status check.

## How It Works

The bottom line is that your agent acts as an API wrapper for Gumroad, letting you use complex e-commerce functions through simple natural language prompts.

1. First, connect your Gumroad account by providing the necessary access token through the Vinkius platform.
2. Next, ask your AI agent to perform a task—for example, 'List all products and tell me which one sold most last week.'
3. Finally, the MCP executes the required steps in the background and delivers a clean, conversational summary of the data right where you are working.

## Frequently Asked Questions

**How do I find out what my active products are using Gumroad MCP?**
You use `list_products`. This tool pulls a complete, current catalog of every single digital item you have listed in your store.

**Can I check if a customer's license is valid with Gumroad MCP?**
Yes, running `verify_license` checks the key immediately. It tells you if it's active and how many uses are left for that specific product.

**Is listing all sales possible using the Gumroad MCP?**
Absolutely. The `list_sales` tool retrieves a detailed history of every single transaction, letting you track revenue over time.

**What if I need to process a refund with Gumroad MCP?**
You use the `refund_sale` tool. You just tell your agent which sale ID needs correcting, and it handles the initiation of the refund.

**Does Gumroad MCP help me track my money coming in?**
Yes, you can monitor payouts using `list_payouts`. This tool gives you a history of all the payments that have successfully moved into your account.