Skip to main content
Glama

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.git

Related MCP server: WooCommerce MCP Server

Configure

  1. Get your credentials at developers.hotmart.com → create app → copy Client ID, Client Secret and Basic.

  2. Paste them into .mcp.json (or claude_desktop_config.json):

{
  "mcpServers": {
    "hotmart": {
      "command": "hotmart-mcp",
      "env": {
        "HOTMART_CLIENT_ID": "cole_aqui",
        "HOTMART_CLIENT_SECRET": "cole_aqui",
        "HOTMART_BASIC_AUTH": "cole_aqui"
      }
    }
  }
}
  1. 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 tools
hotmart_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

    C2.9/5.0

    Scored across 40 tools

    Disambiguation4/5

    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 Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness3/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables 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.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables interaction with ActiveCampaign email marketing and CRM via API v3 through natural language.
      95 npm
      MIT