hotmart-mcp
# hotmart-mcp
MCP server for Hotmart digital products platform (Brazil).
## Tools (8)
| Tool | Description |
|---|---|
| `list_sales` | List sales history |
| `get_sale` | Get sale details |
| `list_subscriptions` | List subscriptions |
| `cancel_subscription` | Cancel a subscription |
| `list_products` | List products |
| `get_commission` | Get commission summary |
| `list_users` | List users |
| `refund_purchase` | Refund a purchase |
## Quick Start
```json
{
"mcpServers": {
"hotmart": {
"command": "npx",
"args": ["-y", "@theyahia/hotmart-mcp"],
"env": {
"HOTMART_CLIENT_ID": "<YOUR_HOTMART_CLIENT_ID>",
"HOTMART_CLIENT_SECRET": "<YOUR_HOTMART_CLIENT_SECRET>",
"HOTMART_BASIC": "<YOUR_HOTMART_BASIC>"
}
}
}
}
```
## Environment Variables
| Variable | Required | Description |
|---|---|---|
| `HOTMART_CLIENT_ID` | Yes | OAuth client ID |
| `HOTMART_CLIENT_SECRET` | Yes | OAuth client secret |
| `HOTMART_BASIC` | Yes | Basic auth token |
## License
MIT
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose targeting specific resources and actions in the Hotmart domain, such as subscriptions, commissions, sales, products, and users. There is no overlap or ambiguity between tools like 'cancel_subscription' and 'list_subscriptions', or 'get_sale' and 'list_sales', making it easy for an agent to select the correct tool.
All tool names follow a consistent verb_noun pattern using snake_case, such as 'cancel_subscription', 'get_commission', and 'list_products'. This uniformity enhances readability and predictability, with no deviations in naming conventions across the toolset.
With 8 tools, the server is well-scoped for managing a Hotmart platform, covering key operations like sales, subscriptions, products, users, and refunds. Each tool serves a specific and necessary function without being overly sparse or bloated, fitting typical expectations for such a domain.
The toolset provides strong coverage for core Hotmart workflows, including CRUD-like operations for sales, subscriptions, products, and users, as well as actions like refunds and cancellations. A minor gap exists in update operations (e.g., updating a subscription or user details), but agents can likely work around this with the available tools.