# Hotmart — how to use (mcp.ai)

Plataforma de produtos digitais Hotmart via API oficial: vendas (histórico, resumo, participantes, comissões, reembolso), assinaturas (listar, cancelar, reativar, mudar dia de cobrança), cupons, produtos/ofertas/planos, eventos e área de membros (módulos, aulas, alunos, progresso). Gere suas credenciais (Client ID + Client Secret) em Ferramentas → Credenciais de API no painel Hotmart.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_hotmart?ms=1788884460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `hotmart_account`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/hotmart`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/hotmart/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/hotmart/account` — Dados da conta Hotmart conectada (nome, documento, configurações).
  - body: { account?: string }
- `POST https://api.mcp.ai/api/hotmart/club/lessons` — Área de membros (Hotmart Club). Inventaria e acompanha o conteúdo de um curso.
  - body: { subdomain: string, module_id?: string, user_id?: string, student_email?: string, is_extra?: boolean, account?: string, module_ids?: string[], user_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/club/modules` — Área de membros (Hotmart Club). Inventaria e acompanha o conteúdo de um curso.
  - body: { subdomain: string, module_id?: string, user_id?: string, student_email?: string, is_extra?: boolean, account?: string, module_ids?: string[], user_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/club/pages` — Área de membros (Hotmart Club). Inventaria e acompanha o conteúdo de um curso.
  - body: { subdomain: string, module_id?: string, user_id?: string, student_email?: string, is_extra?: boolean, account?: string, module_ids?: string[], user_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/club/students` — Área de membros (Hotmart Club). Inventaria e acompanha o conteúdo de um curso.
  - body: { subdomain: string, module_id?: string, user_id?: string, student_email?: string, is_extra?: boolean, account?: string, module_ids?: string[], user_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/coupons` — Lista cupons de desconto de um produto (requer product_id; filtros: code, page_token).
  - body: { product_id: string, code?: string, page_token?: string, account?: string, product_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/coupons/write/create` — Mutações em cupons de desconto Hotmart.
  - body: { product_id?: string, code?: string, discount?: number, coupon_id?: string, account?: string, product_ids?: string[], coupon_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/coupons/write/delete` — Mutações em cupons de desconto Hotmart.
  - body: { product_id?: string, code?: string, discount?: number, coupon_id?: string, account?: string, product_ids?: string[], coupon_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/events/info` — Eventos presenciais (Hotmart Events).
  - body: { event_id: string, max_results?: integer, page_token?: string, account?: string, event_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/events/participants` — Eventos presenciais (Hotmart Events).
  - body: { event_id: string, max_results?: integer, page_token?: string, account?: string, event_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/list/accounts` — Lista contas Hotmart (creators) vinculadas a este install — id, label e apelido.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/hotmart/negotiation` — Cria uma negociação (recuperação) de uma assinatura em atraso (requer subscriber_code).
  - body: { subscriber_code: string, account?: string }
- `POST https://api.mcp.ai/api/hotmart/payment/links` — Lista os links de pagamento (payment links) da conta Hotmart.
  - body: { max_results?: integer, page_token?: string, account?: string }
- `POST https://api.mcp.ai/api/hotmart/payment/links/write/add/offer` — Mutações em links de pagamento Hotmart (gera cobrança, mexe em dinheiro).
  - body: { payment_link_ucode?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/hotmart/payment/links/write/add/plan` — Mutações em links de pagamento Hotmart (gera cobrança, mexe em dinheiro).
  - body: { payment_link_ucode?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/hotmart/payment/links/write/charge/offer` — Mutações em links de pagamento Hotmart (gera cobrança, mexe em dinheiro).
  - body: { payment_link_ucode?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/hotmart/payment/links/write/charge/value` — Mutações em links de pagamento Hotmart (gera cobrança, mexe em dinheiro).
  - body: { payment_link_ucode?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/hotmart/payment/links/write/create` — Mutações em links de pagamento Hotmart (gera cobrança, mexe em dinheiro).
  - body: { payment_link_ucode?: string, data?: object, account?: string }
- `POST https://api.mcp.ai/api/hotmart/products/list` — Catálogo de produtos do creator na Hotmart (Products API).
  - body: { ucode?: string, max_results?: integer, page_token?: string, account?: string }
- `POST https://api.mcp.ai/api/hotmart/products/offers` — Catálogo de produtos do creator na Hotmart (Products API).
  - body: { ucode?: string, max_results?: integer, page_token?: string, account?: string }
- `POST https://api.mcp.ai/api/hotmart/products/plans` — Catálogo de produtos do creator na Hotmart (Products API).
  - body: { ucode?: string, max_results?: integer, page_token?: string, account?: string }
- `POST https://api.mcp.ai/api/hotmart/sales/commissions` — Leitura de vendas na Hotmart (Payments API).
  - body: { start_date?: string, end_date?: string, product_id?: string, transaction_status?: string, buyer_email?: string, max_results?: integer, page_token?: string, account?: string, product_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/sales/history` — Leitura de vendas na Hotmart (Payments API).
  - body: { start_date?: string, end_date?: string, product_id?: string, transaction_status?: string, buyer_email?: string, max_results?: integer, page_token?: string, account?: string, product_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/sales/price/details` — Leitura de vendas na Hotmart (Payments API).
  - body: { start_date?: string, end_date?: string, product_id?: string, transaction_status?: string, buyer_email?: string, max_results?: integer, page_token?: string, account?: string, product_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/sales/summary` — Leitura de vendas na Hotmart (Payments API).
  - body: { start_date?: string, end_date?: string, product_id?: string, transaction_status?: string, buyer_email?: string, max_results?: integer, page_token?: string, account?: string, product_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/sales/users` — Leitura de vendas na Hotmart (Payments API).
  - body: { start_date?: string, end_date?: string, product_id?: string, transaction_status?: string, buyer_email?: string, max_results?: integer, page_token?: string, account?: string, product_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/sales/write/refund` — Mutações em vendas Hotmart.
  - body: { transaction_code: string, account?: string }
- `POST https://api.mcp.ai/api/hotmart/subscriptions/list` — Leitura de assinaturas na Hotmart.
  - body: { subscriber_code?: string, product_id?: string, subscriber_email?: string, status?: string, max_results?: integer, page_token?: string, account?: string, product_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/subscriptions/purchases` — Leitura de assinaturas na Hotmart.
  - body: { subscriber_code?: string, product_id?: string, subscriber_email?: string, status?: string, max_results?: integer, page_token?: string, account?: string, product_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/subscriptions/summary` — Leitura de assinaturas na Hotmart.
  - body: { subscriber_code?: string, product_id?: string, subscriber_email?: string, status?: string, max_results?: integer, page_token?: string, account?: string, product_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/subscriptions/switch/plan/plans` — Leitura de assinaturas na Hotmart.
  - body: { subscriber_code?: string, product_id?: string, subscriber_email?: string, status?: string, max_results?: integer, page_token?: string, account?: string, product_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/subscriptions/transactions` — Leitura de assinaturas na Hotmart.
  - body: { subscriber_code?: string, product_id?: string, subscriber_email?: string, status?: string, max_results?: integer, page_token?: string, account?: string, product_ids?: string[] }
- `POST https://api.mcp.ai/api/hotmart/subscriptions/write/cancel` — Mutações em assinaturas Hotmart.
  - body: { data?: object, subscriber_codes?: string[], subscriber_code?: string, due_day?: integer, send_mail?: boolean, charge?: boolean, account?: string }
- `POST https://api.mcp.ai/api/hotmart/subscriptions/write/change/due/day` — Mutações em assinaturas Hotmart.
  - body: { data?: object, subscriber_codes?: string[], subscriber_code?: string, due_day?: integer, send_mail?: boolean, charge?: boolean, account?: string }
- `POST https://api.mcp.ai/api/hotmart/subscriptions/write/reactivate` — Mutações em assinaturas Hotmart.
  - body: { data?: object, subscriber_codes?: string[], subscriber_code?: string, due_day?: integer, send_mail?: boolean, charge?: boolean, account?: string }
- `POST https://api.mcp.ai/api/hotmart/subscriptions/write/switch/plan` — Mutações em assinaturas Hotmart.
  - body: { data?: object, subscriber_codes?: string[], subscriber_code?: string, due_day?: integer, send_mail?: boolean, charge?: boolean, account?: string }

## Example prompts
- "Quanto vendi na Hotmart nos últimos 30 dias?"
- "Liste os módulos e aulas da minha área de membros (subdomain X)"
- "Qual o progresso dos alunos no meu curso?"

## More
- Page: https://mcp.ai/hotmart
- Agent spec (llms.txt): https://mcp.ai/hotmart/llms.txt
- Postman collection: https://mcp.ai/hotmart/postman.json