# Hotmart MCP

> Hotmart MCP manages your entire digital product business through natural conversation. This connector lets you track sales history, review revenue summaries, and manage active subscriptions for courses and memberships. Use it to monitor student progress and list all products without ever opening the Hotmart dashboard.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** digital-products, online-courses, subscription-management, sales-analytics, creator-economy, revenue-tracking

## Description

Need a full overview of your online course sales? Connect this MCP to any AI agent and start managing your digital product business conversationally. You can get immediate insights into your revenue performance by reviewing aggregated data, tracking every transaction in the sales history, or listing all active subscriptions. The system automatically checks student enrollment status and even tells you who's falling behind using `get_student_progress`. This ability to pull complex financial metrics—like total revenue or average ticket size—and synthesize them into a simple chat response is what makes Vinkius the best place for this catalog. It means your agent doesn't just read data; it gives you actionable reports, letting you monitor sales and student engagement right where you work.

## Tools

### get_sales_history
Retrieves a detailed list of completed transactions, including buyer email, sale status, and calculated commission amounts.

### get_sales_summary
Gathers high-level data points like total revenue, average ticket size, and overall number of sales for a given period.

### get_student_progress
Analyzes an enrolled student's activity to report their current completion percentage or flag them as inactive.

### list_products
Provides a catalog listing of all digital products you offer, along with their pricing and active status.

### list_students
Generates a roster of all enrolled members or students associated with your platform.

### list_subscriptions
Lists all current paid memberships, showing the renewal dates and payment status for quick billing checks.

## Prompt Examples

**Prompt:** 
```
Show all my products with sales data and the revenue summary for this month.
```

**Response:** 
```
Your products: 1) 'AI Mastery Course' — R$ 297, Active, 1,240 total sales. 2) 'Python Bootcamp' — R$ 197, Active, 890 total sales. 3) 'Data Science eBook' — R$ 47, Active, 2,100 total sales. Revenue summary (April 2025): Total revenue: R$ 48,230. Number of sales: 312. Average ticket: R$ 154.58. Top performer: 'AI Mastery Course' (R$ 28,710, 58.5% of revenue). Active subscriptions: 89. Would you like to see the sales history or student progress?
```

**Prompt:** 
```
Show student progress for the AI Mastery Course — who is falling behind?
```

**Response:** 
```
AI Mastery Course: 1,240 enrolled students. Completion breakdown: Completed (100%): 312 students (25.2%). Active (50-99%): 456 students (36.8%). At risk (10-49%): 289 students (23.3%). Inactive (<10%): 183 students (14.8%). Students falling behind (inactive >30 days): 1) Maria Silva (student_891) — 12% complete, last activity 45 days ago. 2) João Santos (student_902) — 8% complete, 38 days. 3) Ana Costa (student_915) — 22% complete, 35 days. Module with highest drop-off: Module 4 'Neural Networks' (42% abandon rate). Would you like to check subscriptions or get the full sales history?
```

**Prompt:** 
```
Show the last 5 sales transactions and list all active subscriptions.
```

**Response:** 
```
Last 5 sales: 1) 'AI Mastery Course' — R$ 297, buyer: pedro@email.com, status: approved, commission: R$ 89.10 (30%). 2) 'Data Science eBook' — R$ 47, buyer: lucas@email.com, approved. 3) 'Python Bootcamp' — R$ 197, buyer: carla@email.com, approved. 4) 'AI Mastery Course' — R$ 297, buyer: fernanda@email.com, approved. 5) 'Data Science eBook' — R$ 47, buyer: rafael@email.com, refunded. Active subscriptions: 89 total. Monthly: 52 (avg R$ 49/mo). Annual: 37 (avg R$ 397/yr). Next renewals this week: 8 subscriptions. Churn rate: 4.2% monthly. Would you like a detailed revenue breakdown?
```

## Capabilities

### Audit past transactions
Retrieve a detailed record of every sale to track buyer information, status, and commissions.

### Generate revenue reports
Get an aggregated summary of your sales data, including total revenue and the number of sales completed in a period.

### Track student progress
Inspect individual course completion percentages or identify students who haven't logged in for a while.

### View product inventory
List every digital item you sell, including its current status and pricing information.

### Manage membership lists
Retrieve the names and details of all currently active subscriptions and their renewal dates.

## Use Cases

### Identifying Retention Risks
The course author wants to know why their advanced module sales dipped. They ask the agent and use `get_student_progress` on a specific cohort, which reveals that 42% of students abandoned Module 4 'Neural Networks,' allowing them to adjust content immediately.

### Prepping for Investor Meetings
The digital creator needs quarterly growth numbers fast. They prompt the agent with a request, which triggers `get_sales_summary`, returning total revenue and average ticket size in seconds so they can focus on strategy instead of data compilation.

### Handling Affiliate Queries
The affiliate manager needs proof of payout for a partner. They instruct the agent to run `get_sales_history` for that specific date range, and the tool returns every sale, commission breakdown, and status needed for verification.

### Onboarding New Members
A new product is launching. The author uses `list_products` to confirm the item's pricing and status before marketing materials go out, ensuring everything is configured correctly in the system.

## Benefits

- Stop opening multiple tabs. Instead of manually compiling sales data from different reports, ask your agent to run `get_sales_summary` and get the total revenue instantly.
- Pinpoint student engagement issues fast. Use `get_student_progress` to immediately find which students are falling behind or which module has the highest drop-off rate.
- Audit sales without hassle. Running `get_sales_history` gives you every transaction detail—buyer, status, commission—in a single chat response.
- Keep membership records clean. You can call `list_subscriptions` to see who's due for renewal this week and what the current churn rate looks like.
- Get an instant inventory check using `list_products`. Know exactly what you're selling, including pricing details, right when you need it.

## How It Works

The bottom line is you talk to your agent like talking to a colleague who already has access to all your sales dashboards.

1. Subscribe to this MCP in Vinkius, then supply your Hotmart Client ID and Client Secret from the developer portal.
2. Your AI agent connects using these credentials, establishing a live data pipeline to your Hotmart account.
3. You simply ask your AI client (like Claude or Cursor) for an insight—for example, 'Who needs a progress check?'—and it executes the necessary tool calls and returns the structured answer.

## Frequently Asked Questions

**How do I use Hotmart MCP to find out how many people are active?**
You need to run the `get_student_progress` tool. This analyzes enrollment data and reports on completion percentages, allowing you to identify students who haven't logged in recently.

**Can Hotmart MCP give me a full list of every product I sell?**
Yes, run the `list_products` tool. This function retrieves an inventory catalog listing all your digital goods, including their status and pricing details.

**Does Hotmart MCP track past sales commissions?**
The `get_sales_history` tool tracks every sale. It provides full transaction records, including the buyer's commission breakdown for accurate affiliate auditing.

**What if I want to see only my active paid memberships?**
Use the `list_subscriptions` tool. This function generates a specific list of all current subscriptions and shows you their next payment renewal dates.

**How do I get total revenue for a period?**
You run `get_sales_summary`. This is the best way to quickly gather high-level financial metrics, like total revenue and average ticket size, without diving into raw transaction data.