@marcelocorrea/mcp-hotmart-api/README.md

MCP Server para integração com API Hotmart

# MCP Hotmart API

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

## 🚀 Instalação

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

## 🔧 Configuração

1. Copie o arquivo `.env.example` para `.env`:
```bash
cp .env.example .env
```

2. Configure suas credenciais Hotmart no arquivo `.env`:
```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:**
```json
{
  "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:**
```json
{
  "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:**
```json
{
  "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:**
```json
{
  "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:**
```json
{
  "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:**
```json
{
  "name": "test_connection",
  "arguments": {}
}
```

## 🔗 Configuração no Claude Desktop

Adicione ao seu `claude_desktop_config.json`:

```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](https://developers.hotmart.com/docs/pt-BR/)
- [MCP SDK Documentation](https://modelcontextprotocol.io/)

## 🛠️ Desenvolvimento

```bash
# Build
npm run build

# Watch mode
npm run watch

# Start
npm start
```

## 📝 Licença

MIT