MCP Hotmart API

MCP Server para integração com a API da Hotmart, permitindo acesso a produtos, vendas e assinaturas.

🚀 Instalação

cd mcp/mcp-hotmart-api
npm install
npm run build

🔧 Configuração

1. Copie o arquivo .env.example para .env:

cp .env.example .env

2. Configure suas credenciais Hotmart no arquivo .env:

HOTMART_CLIENT_ID=seu_client_id
HOTMART_CLIENT_SECRET=seu_client_secret

📋 Ferramentas Disponíveis

1. get_products

Retorna lista de produtos da conta Hotmart.

Parâmetros: Nenhum

Exemplo de uso:

{
  "name": "get_products",
  "arguments": {}
}

2. get_subscribers

Retorna lista de assinaturas (subscribers) da conta Hotmart.

Parâmetros:

• product_id (opcional): ID do produto para filtrar assinaturas

Exemplo de uso:

{
  "name": "get_subscribers",
  "arguments": {
    "product_id": "123456"
  }
}

3. get_subscription

Retorna detalhes de uma assinatura específica.

Parâmetros:

• subscriber_code (obrigatório): Código do assinante

Exemplo de uso:

{
  "name": "get_subscription",
  "arguments": {
    "subscriber_code": "SUB123456"
  }
}

4. get_sales

Retorna lista de vendas da conta Hotmart com filtros opcionais.

Parâmetros:

• start_date (opcional): Data inicial em timestamp (milissegundos)
• end_date (opcional): Data final em timestamp (milissegundos)
• product_id (opcional): ID do produto para filtrar vendas

Exemplo de uso:

{
  "name": "get_sales",
  "arguments": {
    "start_date": 1672531200000,
    "end_date": 1704067199000,
    "product_id": "123456"
  }
}

5. get_sale_by_transaction

Busca uma venda específica pelo ID da transação.

Parâmetros:

• transaction_id (obrigatório): ID da transação

Exemplo de uso:

{
  "name": "get_sale_by_transaction",
  "arguments": {
    "transaction_id": "HP12345678901234567890"
  }
}

6. test_connection

Testa a conexão com a API Hotmart.

Parâmetros: Nenhum

Exemplo de uso:

{
  "name": "test_connection",
  "arguments": {}
}

🔗 Configuração no Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "hotmart-api": {
      "command": "node",
      "args": ["/caminho/completo/para/mcp/mcp-hotmart-api/dist/index.js"],
      "env": {
        "HOTMART_CLIENT_ID": "seu_client_id",
        "HOTMART_CLIENT_SECRET": "seu_client_secret"
      }
    }
  }
}

📚 Documentação

• Documentação Hotmart API
• MCP SDK Documentation

🛠️ Desenvolvimento

# Build
npm run build

# Watch mode
npm run watch

# Start
npm start

📝 Licença

MIT