Hotmart

io.github.mcp-dirPublished by GitHub account mcp-dirv0.1.0Updated Oct 24, 2026

Hotmart digital-products platform, sales (history, summary, commissions), subscriptions (list, cance

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an assistant query Hotmart digital-product sales, commissions, subscriptions and products through the official API.

What you can do
Connects an assistant to the Hotmart digital-products platform via its official API. It covers sales data such as history, summaries and commissions, subscription management including listing, cancelling and reactivating, and product information. The README states the server is read-only and lists no tools in its table.
When to use it
Useful when you want an assistant to answer questions about Hotmart sales performance, commission totals or active subscriptions, or to look up products, without opening the Hotmart dashboard. It suits creators and sellers who already run a Hotmart account and work from an MCP-capable client.
Requirements
A remote MCP endpoint over HTTP; no local package or runtime is declared. Hotmart API credentials (Client ID and Client Secret) generated in the Hotmart panel under Tools, API Credentials, are required. The README also mentions login via magic-link. Network access to the hosted endpoint is needed.
Before you install
The README says the server is read-only and that no tool changes source data, yet it also shows an example of cancelling a subscription, so verify actual write behaviour before relying on it. Returned data is sent to whichever LLM host you use, a sub-processor outside the provider's control. The hosted server is proprietary; the public repository is only the wrapper. Credentials are referenced as Client ID and Client Secret.

Installation

In SourceWeft

  1. Open Hotmart in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mcp-dir%2Fhotmart-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "hotmart": {
      "type": "http",
      "url": "https://api.mcp.ai/p_hotmart"
    }
  }
}

README

This repository has no README.

Tools

42

hotmart_list_accounts

Lista contas Hotmart (creators) vinculadas a este install — id, label e apelido.

Parametersaccount

hotmart_sales_history

Leitura de vendas na Hotmart (Payments API). Ações: - history: histórico de transações (filtros: start_date/end_date YYYY-MM-DD, product_id, transaction_status, buyer_email, max_results, page_token). - summary: totais agregados de vendas no período. - users: participantes das vendas (compradores, afiliados, coprodutores). - commissions: comissões por venda (você como produtor/coprodutor/afiliado). - price_details: detalhes de preço/taxas por venda. Retorna os dados crus da Hotmart (items + page_info de paginação). [Flattened action: history] Bulk support: accepts product_ids for batched execution.

Parametersaccountend_datepage_tokenproduct_idstart_datebuyer_emailmax_resultsproduct_idstransaction_status

hotmart_sales_summary

Leitura de vendas na Hotmart (Payments API). Ações: - history: histórico de transações (filtros: start_date/end_date YYYY-MM-DD, product_id, transaction_status, buyer_email, max_results, page_token). - summary: totais agregados de vendas no período. - users: participantes das vendas (compradores, afiliados, coprodutores). - commissions: comissões por venda (você como produtor/coprodutor/afiliado). - price_details: detalhes de preço/taxas por venda. Retorna os dados crus da Hotmart (items + page_info de paginação). [Flattened action: summary] Bulk support: accepts product_ids for batched execution.

Parametersaccountend_datepage_tokenproduct_idstart_datebuyer_emailmax_resultsproduct_idstransaction_status

hotmart_sales_users

Leitura de vendas na Hotmart (Payments API). Ações: - history: histórico de transações (filtros: start_date/end_date YYYY-MM-DD, product_id, transaction_status, buyer_email, max_results, page_token). - summary: totais agregados de vendas no período. - users: participantes das vendas (compradores, afiliados, coprodutores). - commissions: comissões por venda (você como produtor/coprodutor/afiliado). - price_details: detalhes de preço/taxas por venda. Retorna os dados crus da Hotmart (items + page_info de paginação). [Flattened action: users] Bulk support: accepts product_ids for batched execution.

Parametersaccountend_datepage_tokenproduct_idstart_datebuyer_emailmax_resultsproduct_idstransaction_status

hotmart_sales_commissions

Leitura de vendas na Hotmart (Payments API). Ações: - history: histórico de transações (filtros: start_date/end_date YYYY-MM-DD, product_id, transaction_status, buyer_email, max_results, page_token). - summary: totais agregados de vendas no período. - users: participantes das vendas (compradores, afiliados, coprodutores). - commissions: comissões por venda (você como produtor/coprodutor/afiliado). - price_details: detalhes de preço/taxas por venda. Retorna os dados crus da Hotmart (items + page_info de paginação). [Flattened action: commissions] Bulk support: accepts product_ids for batched execution.

Parametersaccountend_datepage_tokenproduct_idstart_datebuyer_emailmax_resultsproduct_idstransaction_status

hotmart_sales_price_details

Leitura de vendas na Hotmart (Payments API). Ações: - history: histórico de transações (filtros: start_date/end_date YYYY-MM-DD, product_id, transaction_status, buyer_email, max_results, page_token). - summary: totais agregados de vendas no período. - users: participantes das vendas (compradores, afiliados, coprodutores). - commissions: comissões por venda (você como produtor/coprodutor/afiliado). - price_details: detalhes de preço/taxas por venda. Retorna os dados crus da Hotmart (items + page_info de paginação). [Flattened action: price_details] Bulk support: accepts product_ids for batched execution.

Parametersaccountend_datepage_tokenproduct_idstart_datebuyer_emailmax_resultsproduct_idstransaction_status

hotmart_sales_write_refund

Mutações em vendas Hotmart. Ações: - refund: reembolsa uma transação (transaction_code). Operação irreversível, devolve o valor ao comprador. [Flattened action: refund]

Parametersaccounttransaction_coderequired

hotmart_subscriptions_list

Leitura de assinaturas na Hotmart. Ações: - list: assinaturas (filtros: product_id, subscriber_email, status ACTIVE|INACTIVE|CANCELLED_BY_*|OVERDUE, max_results, page_token). - summary: totais agregados de assinaturas. - purchases: compras/faturas de UMA assinatura (requer subscriber_code). - transactions: transações de UMA assinatura (requer subscriber_code). - switch_plan_plans: planos disponíveis pra troca (requer subscriber_code). [Flattened action: list] Bulk support: accepts product_ids for batched execution.

Parametersstatusaccountpage_tokenproduct_idmax_resultsproduct_idssubscriber_codesubscriber_email

hotmart_subscriptions_summary

Leitura de assinaturas na Hotmart. Ações: - list: assinaturas (filtros: product_id, subscriber_email, status ACTIVE|INACTIVE|CANCELLED_BY_*|OVERDUE, max_results, page_token). - summary: totais agregados de assinaturas. - purchases: compras/faturas de UMA assinatura (requer subscriber_code). - transactions: transações de UMA assinatura (requer subscriber_code). - switch_plan_plans: planos disponíveis pra troca (requer subscriber_code). [Flattened action: summary] Bulk support: accepts product_ids for batched execution.

Parametersstatusaccountpage_tokenproduct_idmax_resultsproduct_idssubscriber_codesubscriber_email

hotmart_subscriptions_purchases

Leitura de assinaturas na Hotmart. Ações: - list: assinaturas (filtros: product_id, subscriber_email, status ACTIVE|INACTIVE|CANCELLED_BY_*|OVERDUE, max_results, page_token). - summary: totais agregados de assinaturas. - purchases: compras/faturas de UMA assinatura (requer subscriber_code). - transactions: transações de UMA assinatura (requer subscriber_code). - switch_plan_plans: planos disponíveis pra troca (requer subscriber_code). [Flattened action: purchases] Bulk support: accepts product_ids for batched execution.

Parametersstatusaccountpage_tokenproduct_idmax_resultsproduct_idssubscriber_codesubscriber_email

hotmart_subscriptions_transactions

Leitura de assinaturas na Hotmart. Ações: - list: assinaturas (filtros: product_id, subscriber_email, status ACTIVE|INACTIVE|CANCELLED_BY_*|OVERDUE, max_results, page_token). - summary: totais agregados de assinaturas. - purchases: compras/faturas de UMA assinatura (requer subscriber_code). - transactions: transações de UMA assinatura (requer subscriber_code). - switch_plan_plans: planos disponíveis pra troca (requer subscriber_code). [Flattened action: transactions] Bulk support: accepts product_ids for batched execution.

Parametersstatusaccountpage_tokenproduct_idmax_resultsproduct_idssubscriber_codesubscriber_email

hotmart_subscriptions_switch_plan_plans

Leitura de assinaturas na Hotmart. Ações: - list: assinaturas (filtros: product_id, subscriber_email, status ACTIVE|INACTIVE|CANCELLED_BY_*|OVERDUE, max_results, page_token). - summary: totais agregados de assinaturas. - purchases: compras/faturas de UMA assinatura (requer subscriber_code). - transactions: transações de UMA assinatura (requer subscriber_code). - switch_plan_plans: planos disponíveis pra troca (requer subscriber_code). [Flattened action: switch_plan_plans] Bulk support: accepts product_ids for batched execution.

Parametersstatusaccountpage_tokenproduct_idmax_resultsproduct_idssubscriber_codesubscriber_email

hotmart_subscriptions_write_cancel

Mutações em assinaturas Hotmart. Ações: - cancel: cancela 1+ assinaturas (subscriber_codes[]). send_mail (default true) avisa o assinante. - reactivate: reativa 1+ assinaturas (subscriber_codes[]). charge (default false) cobra na hora. - change_due_day: muda o dia de cobrança de UMA assinatura (subscriber_code + due_day 1-31). - switch_plan: troca o plano de uma assinatura (data com subscriber_code + novo plano, conforme doc). [Flattened action: cancel]

Parametersdatachargeaccountdue_daysend_mailsubscriber_codesubscriber_codes

hotmart_subscriptions_write_reactivate

Mutações em assinaturas Hotmart. Ações: - cancel: cancela 1+ assinaturas (subscriber_codes[]). send_mail (default true) avisa o assinante. - reactivate: reativa 1+ assinaturas (subscriber_codes[]). charge (default false) cobra na hora. - change_due_day: muda o dia de cobrança de UMA assinatura (subscriber_code + due_day 1-31). - switch_plan: troca o plano de uma assinatura (data com subscriber_code + novo plano, conforme doc). [Flattened action: reactivate]

Parametersdatachargeaccountdue_daysend_mailsubscriber_codesubscriber_codes

hotmart_subscriptions_write_change_due_day

Mutações em assinaturas Hotmart. Ações: - cancel: cancela 1+ assinaturas (subscriber_codes[]). send_mail (default true) avisa o assinante. - reactivate: reativa 1+ assinaturas (subscriber_codes[]). charge (default false) cobra na hora. - change_due_day: muda o dia de cobrança de UMA assinatura (subscriber_code + due_day 1-31). - switch_plan: troca o plano de uma assinatura (data com subscriber_code + novo plano, conforme doc). [Flattened action: change_due_day]

Parametersdatachargeaccountdue_daysend_mailsubscriber_codesubscriber_codes

hotmart_subscriptions_write_switch_plan

Mutações em assinaturas Hotmart. Ações: - cancel: cancela 1+ assinaturas (subscriber_codes[]). send_mail (default true) avisa o assinante. - reactivate: reativa 1+ assinaturas (subscriber_codes[]). charge (default false) cobra na hora. - change_due_day: muda o dia de cobrança de UMA assinatura (subscriber_code + due_day 1-31). - switch_plan: troca o plano de uma assinatura (data com subscriber_code + novo plano, conforme doc). [Flattened action: switch_plan]

Parametersdatachargeaccountdue_daysend_mailsubscriber_codesubscriber_codes

hotmart_products_list

Catálogo de produtos do creator na Hotmart (Products API). Ações: - list: lista produtos (filtros: max_results, page_token). - offers: ofertas de UM produto (requer ucode). - plans: planos de assinatura de UM produto (requer ucode). [Flattened action: list]

Parametersucodeaccountpage_tokenmax_results

hotmart_products_offers

Catálogo de produtos do creator na Hotmart (Products API). Ações: - list: lista produtos (filtros: max_results, page_token). - offers: ofertas de UM produto (requer ucode). - plans: planos de assinatura de UM produto (requer ucode). [Flattened action: offers]

Parametersucodeaccountpage_tokenmax_results

hotmart_products_plans

Catálogo de produtos do creator na Hotmart (Products API). Ações: - list: lista produtos (filtros: max_results, page_token). - offers: ofertas de UM produto (requer ucode). - plans: planos de assinatura de UM produto (requer ucode). [Flattened action: plans]

Parametersucodeaccountpage_tokenmax_results

hotmart_club_modules

Área de membros (Hotmart Club). Inventaria e acompanha o conteúdo de um curso. Ações: - modules: módulos da área de membros (is_extra opcional filtra módulos extras). - pages: páginas/aulas de UM módulo (requer module_id). - students: alunos matriculados (student_email opcional filtra um aluno). - lessons: aulas/progresso de UM aluno (requer user_id). Todas exigem o subdomain da área de membros. [Flattened action: modules] Bulk support: accepts module_ids, user_ids for batched execution.

Parametersaccountuser_idis_extrauser_idsmodule_idsubdomainrequiredmodule_idsstudent_email

hotmart_club_pages

Área de membros (Hotmart Club). Inventaria e acompanha o conteúdo de um curso. Ações: - modules: módulos da área de membros (is_extra opcional filtra módulos extras). - pages: páginas/aulas de UM módulo (requer module_id). - students: alunos matriculados (student_email opcional filtra um aluno). - lessons: aulas/progresso de UM aluno (requer user_id). Todas exigem o subdomain da área de membros. [Flattened action: pages] Bulk support: accepts module_ids, user_ids for batched execution.

Parametersaccountuser_idis_extrauser_idsmodule_idsubdomainrequiredmodule_idsstudent_email

hotmart_club_students

Área de membros (Hotmart Club). Inventaria e acompanha o conteúdo de um curso. Ações: - modules: módulos da área de membros (is_extra opcional filtra módulos extras). - pages: páginas/aulas de UM módulo (requer module_id). - students: alunos matriculados (student_email opcional filtra um aluno). - lessons: aulas/progresso de UM aluno (requer user_id). Todas exigem o subdomain da área de membros. [Flattened action: students] Bulk support: accepts module_ids, user_ids for batched execution.

Parametersaccountuser_idis_extrauser_idsmodule_idsubdomainrequiredmodule_idsstudent_email

hotmart_club_lessons

Área de membros (Hotmart Club). Inventaria e acompanha o conteúdo de um curso. Ações: - modules: módulos da área de membros (is_extra opcional filtra módulos extras). - pages: páginas/aulas de UM módulo (requer module_id). - students: alunos matriculados (student_email opcional filtra um aluno). - lessons: aulas/progresso de UM aluno (requer user_id). Todas exigem o subdomain da área de membros. [Flattened action: lessons] Bulk support: accepts module_ids, user_ids for batched execution.

Parametersaccountuser_idis_extrauser_idsmodule_idsubdomainrequiredmodule_idsstudent_email

hotmart_coupons

Lista cupons de desconto de um produto (requer product_id; filtros: code, page_token). Bulk support: accepts product_ids for batched execution.

Parameterscodeaccountpage_tokenproduct_idrequiredproduct_ids

hotmart_coupons_write_create

Mutações em cupons de desconto Hotmart. Ações: - create: cria um cupom num produto (product_id + code + discount decimal 0-1, ex.: 0.1 = 10%). - delete: remove um cupom (coupon_id). [Flattened action: create] Bulk support: accepts product_ids, coupon_ids for batched execution.

Parameterscodeaccountdiscountcoupon_idcoupon_idsproduct_idproduct_ids

hotmart_coupons_write_delete

Mutações em cupons de desconto Hotmart. Ações: - create: cria um cupom num produto (product_id + code + discount decimal 0-1, ex.: 0.1 = 10%). - delete: remove um cupom (coupon_id). [Flattened action: delete] Bulk support: accepts product_ids, coupon_ids for batched execution.

Parameterscodeaccountdiscountcoupon_idcoupon_idsproduct_idproduct_ids

hotmart_events_info

Eventos presenciais (Hotmart Events). Ações: - info: dados do evento e tipos de ingresso (requer event_id). - participants: ingressos, compradores e participantes do evento (requer event_id). [Flattened action: info] Bulk support: accepts event_ids for batched execution.

Parametersaccountevent_idrequiredevent_idspage_tokenmax_results

hotmart_events_participants

Eventos presenciais (Hotmart Events). Ações: - info: dados do evento e tipos de ingresso (requer event_id). - participants: ingressos, compradores e participantes do evento (requer event_id). [Flattened action: participants] Bulk support: accepts event_ids for batched execution.

Parametersaccountevent_idrequiredevent_idspage_tokenmax_results

hotmart_account

Dados da conta Hotmart conectada (nome, documento, configurações).

Parametersaccount

hotmart_negotiation

Cria uma negociação (recuperação) de uma assinatura em atraso (requer subscriber_code).

Parametersaccountsubscriber_coderequired

show_version

Show Version

Show the current MCP platform and adapter versions.

Takes no parameters.

report_bug

Report Bug

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Parameterscontextmessagerequiredconversation

connect

Connection Status

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

Takes no parameters.

toolkit_info

Toolkit Info

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

Takes no parameters.

marketplace

Marketplace

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

Parameterslimitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool+11 more

authenticate

Authenticate

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

Parameterstoken

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.