hotmart-mcp
This server connects to your Hotmart account, enabling you to manage sales, subscriptions, products, coupons, events, and members area through natural language commands and visual dashboards.
💰 Sales
List sales history, view summaries, participants, price details, and commissions (producer, co-producer, affiliate)
Refund a sale by transaction code ⚠️ (irreversible)
Visual apps: sales dashboard (revenue cards, daily chart, payment type breakdown), sales breakdown (top products/buyers), commissions dashboard
🔁 Subscriptions
List subscriptions, transactions, summaries, and subscriber purchase history
Cancel (single or batch) ⚠️, reactivate (single or batch), and change billing due day
Generate or preview negotiation proposals for delinquent subscribers (boleto/PIX installment plans)
Visual apps: subscriptions health dashboard, churn analyzer, subscriber 360 view
📦 Products
List products, their offers (prices/discounts), and subscription plans
Visual app: product catalog dashboard
🎟️ Coupons
List, create, and delete coupons for specific products
Visual app: coupon manager (validity, discount, usage)
🎓 Members Area (Club)
List modules, pages, and students; retrieve student progress
Visual apps: module analytics dashboard, students overview (engagement, progress ranking)
🎫 Events (ETICKET only)
Get event info and list participants (filterable by lot, ticket type, status, check-in)
Visual app: event dashboard with participant table and lot breakdown
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@hotmart-mcp cria um cupom de 20% pro produto X"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
hotmart-mcp
Connect Claude (or any MCP client) to your Hotmart account. Sales, subscriptions, members area, products, coupons.
Install
pip install git+https://github.com/thaleslaray/hotmart-mcp.gitRelated MCP server: WooCommerce MCP Server
Configure
Get your credentials at developers.hotmart.com → create app → copy
Client ID,Client SecretandBasic.Paste them into
.mcp.json(orclaude_desktop_config.json):
{
"mcpServers": {
"hotmart": {
"command": "hotmart-mcp",
"env": {
"HOTMART_CLIENT_ID": "cole_aqui",
"HOTMART_CLIENT_SECRET": "cole_aqui",
"HOTMART_BASIC_AUTH": "cole_aqui"
}
}
}
}Restart Claude. Done.
What you can do
Ask in plain English:
"How much did I sell last month?"
"List the subscriptions that were canceled this week"
"Create a 20% coupon for product X"
"Who watched more than 80% of module Y?"
"Refund sale HP12345"
Issues?
Open an issue.
License
MIT
Available Tools
40 toolshotmart_batch_subscriptions_cancelA
Batch Cancel Subscriptions. Use this for multiple subscriber_codes at once. For a single one, prefer hotmart_subscription_cancel.
Inputs: subscriber_code (required), send_mail. Returns: result
hotmart_batch_subscriptions_reactivateA
Batch Reactivate Subscriptions. Use this for multiple subscriber_codes at once. For a single one, prefer hotmart_subscription_reactivate.
Inputs: subscriber_code (required), charge. Returns: result
hotmart_churn_analyzer_appA
Análise de churn — cancelamentos por período + tendência.
LineChart cancelamentos no tempo + DataTable de recentes. Use pra 'análise de churn', 'cancelamentos da semana', 'taxa de cancelamento'.
Inputs: product_id.
hotmart_commissions_dashboard_appB
Painel de comissões — total a pagar/receber por afiliado.
DataTable com afiliado/papel/valor + Metric de total. Use pra 'comissões do mês', 'quanto pagar pros afiliados', 'settlement'.
Inputs: start_date, end_date, commission_as.
hotmart_coupon_createC
Create Coupon. Example: hotmart_coupon_create(product_id=12345).
Inputs: product_id (required), code (required), discount (required), start_date, +3 more. Returns: result
hotmart_coupon_deleteB
Delete Coupon. Example: hotmart_coupon_delete(coupon_id=12345).
Inputs: coupon_id (required). Returns: result
hotmart_coupon_manager_appA
Painel de cupons de um produto — listagem com validade/desconto/usos.
DataTable de cupons + Metric. Use pra 'listar cupons do produto X',
'ver cupons ativos', 'gerenciar cupons'. Pra CRIAR cupom use a tool
hotmart_coupon_create direta.
Inputs: product_id (required).
hotmart_coupons_listC
Get Coupons. Example: hotmart_coupons_list(product_id=12345).
Inputs: product_id (required), code, page_token, select. Returns: result
hotmart_event_dashboard_appA
Painel de evento — info + lista de participantes + breakdown lotes.
Card com info + DataTable participantes + PieChart por lote. Funciona apenas pra produtos formato ETICKET (não ONLINE_EVENT). Use pra 'ver dados do evento X', 'quem comprou ingresso pro evento'.
Inputs: event_id (required).
hotmart_event_info_getC
Event Info. Example: hotmart_event_info_get(event_id=12345).
Inputs: event_id (required), select. Returns: result
hotmart_event_participants_listC
Event Participants. Example: hotmart_event_participants_list(event_id=12345, max_results=10).
Inputs: event_id (required), max_results, page_token, buyer_email, +9 more. Returns: result
hotmart_module_analytics_appA
Análise por módulo da área de membros — qty aulas por módulo.
BarChart aulas/módulo + DataTable. Use pra 'estrutura da área de membros', 'quantas aulas por módulo'.
Inputs: subdomain (required).
hotmart_module_pages_listC
Get Pages. Example: hotmart_module_pages_list(module_id='…'). Requires module_id from hotmart_modules_list first.
Inputs: module_id (required), subdomain (required), select. Returns: result
hotmart_modules_listA
Get Modules. Lists module containers only. To get pages inside a module, use hotmart_module_pages_list with the module_id.
Inputs: subdomain (required), is_extra, select. Returns: result
hotmart_negotiation_generateC
Generate Negotiation.
Inputs: subscription_id (required), recurrences (required), payment_type (required), discount, +1 more. Returns: result
hotmart_negotiation_preview_appA
Preview de proposta de negociação antes de gerar.
Mostra os parâmetros e dispara o hotmart_negotiation_generate se
confirmado. Use pra 'simular negociação pro assinante X', 'preview
parcelamento'. NÃO gera por padrão — só prévia visual.
Inputs: subscription_id (required), payment_type, recurrences, discount.
hotmart_product_catalog_appA
Catálogo de produtos — visão geral com formato/status/preço/info.
Cards de metrics + PieChart status + DataTable. Use pra 'lista de produtos', 'catálogo', 'meus produtos ativos'.
Inputs: no named parameters.
hotmart_product_offers_listB
Get Product Offers. Example: hotmart_product_offers_list(product_id=12345, max_results=10).
Inputs: product_id (required), max_results, page_token, offer_key, +1 more. Returns: result
hotmart_product_plans_listC
Get Product Plans. Example: hotmart_product_plans_list(product_id=12345, max_results=10).
Inputs: product_id (required), max_results, page_token, id_, +1 more. Returns: result
hotmart_products_listC
List Products. Example: hotmart_products_list(max_results=10).
Inputs: max_results, page_token, id_, status, +2 more. Returns: result
hotmart_sale_refundB
Sales Refund. Example: hotmart_sale_refund(transaction_code='ABC123XY').
Inputs: transaction_code (required). Returns: result
hotmart_sales_breakdown_appA
Breakdown de vendas — top produtos + top compradores.
BarChart de produtos por receita + DataTable de compradores únicos. Use pra 'quais produtos vendem mais', 'top compradores', 'analise de quem está comprando'.
Inputs: start_date, end_date.
hotmart_sales_commissions_listD
Sales Commissions. Example: hotmart_sales_commissions_list(max_results=10).
Inputs: max_results, page_token, product_id, start_date, +5 more. Returns: result
hotmart_sales_dashboard_appA
Painel visual de vendas Hotmart no período.
Cards de métricas (receita total, ticket médio, qtd) + LineChart vendas/dia + PieChart por payment_type + DataTable. Use quando o usuário pedir 'dashboard de vendas', 'painel de vendas', 'visão geral das vendas do mês'.
Inputs: start_date, end_date, product_id.
hotmart_sales_history_listA
Sales History. Example: hotmart_sales_history_list(max_results=10). Don't use this for aggregated metrics — use hotmart_sales_summary_list for totals/counts.
Inputs: max_results, page_token, product_id, start_date, +10 more. Returns: result
hotmart_sales_participants_listC
Sales Participants. Example: hotmart_sales_participants_list(transaction_status='APPROVED').
Inputs: transaction, transaction_status, max_results, page_token, +9 more. Returns: result
hotmart_sales_price_details_listC
Sales Price Details. Example: hotmart_sales_price_details_list(transaction_status='APPROVED').
Inputs: transaction, transaction_status, max_results, page_token, +5 more. Returns: result
hotmart_sales_summary_listA
Sales Summary. Example: hotmart_sales_summary_list(transaction_status='APPROVED'). Don't use this for per-transaction details — use hotmart_sales_history_list for the raw list.
Inputs: transaction, transaction_status, max_results, page_token, +8 more. Returns: result
hotmart_student_progress_getC
Get Student Progress. Example: hotmart_student_progress_get(user_id='…').
Inputs: user_id (required), subdomain (required), select. Returns: result
hotmart_students_listC
Get Students.
Inputs: subdomain (required), email, select. Returns: result
hotmart_students_overview_appA
Visão geral dos alunos na área de membros — counts + progresso.
Cards (total, ativos, bloqueados) + PieChart engajamento + DataTable ranking. Use pra 'lista de alunos', 'progresso médio', 'quantos alunos completaram'.
Inputs: subdomain (required).
hotmart_subscriber_360_appA
Visão 360 de um assinante — perfil + histórico de compras.
Cards de LTV/qty/ticket + DataTable com purchases. Use pra 'ver dados do assinante X', 'histórico completo do código Y'.
Inputs: subscriber_code (required).
hotmart_subscriber_purchases_listC
Subscriber Purchases. Example: hotmart_subscriber_purchases_list(subscriber_code='ABC123XY').
Inputs: subscriber_code (required). Returns: result
hotmart_subscription_cancelA
Cancel Subscription. Example: hotmart_subscription_cancel(subscriber_code='ABC123XY'). Use this for ONE subscriber_code. For 2+ subscriptions, use hotmart_batch_subscriptions_cancel.
Inputs: subscriber_code (required), send_mail. Returns: result
hotmart_subscription_due_day_updateB
Change Due Day. Example: hotmart_subscription_due_day_update(subscriber_code='ABC123XY').
Inputs: subscriber_code (required), due_day (required). Returns: result
hotmart_subscription_reactivateA
Reactivate Subscription. Example: hotmart_subscription_reactivate(subscriber_code='ABC123XY'). Use this for ONE subscriber_code. For 2+, use hotmart_batch_subscriptions_reactivate.
Inputs: subscriber_code (required), charge. Returns: result
hotmart_subscriptions_health_appA
Painel de saúde das assinaturas — counts por status + lista.
Grid com cards (ativos, atrasados, cancelados) + PieChart breakdown
DataTable. Use pra 'saúde das assinaturas', 'visão geral das assinaturas', 'quantos assinantes ativos'.
Inputs: product_id.
hotmart_subscriptions_listA
Get Subscriptions. Example: hotmart_subscriptions_list(max_results=10). Don't use this for payment events — use hotmart_subscription_transactions_list for charges/refunds per subscription.
Inputs: max_results, page_token, product_id, plan, +13 more. Returns: result
hotmart_subscriptions_summary_listC
Subscription Summary. Example: hotmart_subscriptions_summary_list(max_results=10).
Inputs: max_results, page_token, product_id, subscriber_code, +4 more. Returns: result
hotmart_subscription_transactions_listA
Subscription Transactions. Example: hotmart_subscription_transactions_list(max_results=10). Don't use this for the subscription list itself — use hotmart_subscriptions_list.
Inputs: max_results, page_token, product_id, transaction, +12 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 40 tools
Most tools target distinct resources and actions, and descriptions explicitly disambiguate similar ones (e.g., sales_history_list vs sales_summary_list, subscription_cancel vs batch_subscriptions_cancel). The main overlap risk is among the many `_app` dashboard tools, but each has a clear analytical scope.
Naming generally follows `hotmart_<resource>_<action>` (e.g., hotmart_coupon_create, hotmart_subscription_cancel) and is quite consistent. Minor deviations include `hotmart_event_info_get` (get at end), batch variants like `hotmart_batch_subscriptions_cancel`, and many `_app` suffixes for dashboard tools, which feel like a separate convention.
At 40 tools, this is far beyond the 3–15 typical well-scoped range and above the 25+ threshold. Many overlapping app dashboards, listing variants, and batch/single pairs inflate the count beyond what seems necessary for the core Hotmart domain.
The surface covers a wide range: products, offers, subscriptions, sales, students, coupons, and events. However, there are notable gaps like no product create/update/delete, no page management, and no individual sale fetch/update, leaving some workflows incomplete.
Maintenance
Related MCP Connectors
Run your Sellfy store from your AI assistant: products, discounts, orders, sales and email drafts.
Run your Zepsell store from AI: sales, orders, products, stock, customers and discount codes.
Manage your NanoCart store from any AI agent: products, orders, coupons, subscribers, reports.
WooCommerce MCP server for ChatGPT, Claude and any AI agent: list orders, update order status, create refund, create coupon, update product and get sales report in your own WooCommerce account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to WooCommerce yourself; Cotlet does not store your password and you need no WooCommerce API key. About the official WooCommerce API: Yes. WooCommerce has a full REST API (wc/v3) for orders, products, customers, coupons, refunds and reports, and a store owner creates consumer keys for it per store (checked 16 Oct 2026). Setup and FAQ: https://cotlet.dev/integrations/woocommerce-api-mcp-server
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables AI to view and manage e-commerce data such as products, orders, and coupons, and perform actions like updating prices, stock, and generating sales reports.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage WooCommerce stores, including products, orders, customers, categories, coupons, attributes, variations, order notes, refunds, reports, payment gateways, meta data, reviews, settings, data, posts, and system status through natural language.MIT
- AlicenseAqualityDmaintenanceEnables AI agents to manage Hotmart products, sales, and other operations through a standardized Model Context Protocol interface, integrating with Claude and other LLMs.2MIT
- AlicenseNot gradedqualityCmaintenanceEnables interaction with ActiveCampaign email marketing and CRM via API v3 through natural language.95 npmMIT