jotae-mcp 1.0.0

package/README.md

@@ -0,0 +1,101 @@
+# jotae-mcp
+
+MCP Server oficial do [Jotae](https://app.jotae.me) para Claude Desktop e Claude.ai.
+
+Conecta o Claude ao Jotae para criar eventos, configurar automações de WhatsApp e e-mail, e ler métricas — tudo por texto ou voz.
+
+## O que o agente consegue fazer
+
+- Criar e editar eventos ao vivo
+- Configurar data, link do YouTube, pitch e CTA
+- Aplicar timelines de automação completas a um evento
+- Criar automações individuais segmentadas (participantes, no-show, compradores)
+- Ler métricas: presença, pitch, cliques no CTA, taxa de conversão
+- Ver integrações ativas (WhatsApp, e-mail, CRM)
+- Acessar contatos e listas geradas por evento
+
+## Instalação
+
+### 1. Gere sua chave de API
+
+Acesse **Configurações > Integrações > Claude AI (MCP)** no Jotae e gere uma chave `jotae_sk_...`.
+
+### 2. Configure o Claude Desktop
+
+Edite `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "jotae": {
+      "command": "npx",
+      "args": ["jotae-mcp"],
+      "env": {
+        "JOTAE_API_KEY": "jotae_sk_SUA_CHAVE_AQUI"
+      }
+    }
+  }
+}
+```
+
+Reinicie o Claude Desktop. O ícone de ferramentas aparece nas conversas.
+
+### 3. (Opcional) URL customizada
+
+Se você usa domínio próprio:
+
+```json
+"env": {
+  "JOTAE_API_KEY": "jotae_sk_...",
+  "JOTAE_BASE_URL": "https://app.seudominio.com"
+}
+```
+
+## Como usar
+
+Abra o Claude Desktop e use os prompts prontos:
+
+- **"Configurar novo evento"** — guia completo do zero
+- **"Follow-up pós-evento"** — automações segmentadas pós-live
+
+Ou chame diretamente:
+
+> "Cria um evento chamado 'Masterclass de Vendas' para 15 de setembro às 20h com CTA para minha página de vendas"
+
+> "Quais eventos tenho cadastrados e qual a taxa de conversão do último?"
+
+> "Aplica a timeline 'Lançamento Padrão' no evento X"
+
+## Ferramentas disponíveis
+
+| Tool | O que faz |
+|---|---|
+| `get_setup_status` | Diagnóstico completo da conta |
+| `list_events` | Lista eventos |
+| `get_event` | Detalhes de um evento |
+| `get_event_stats` | Métricas de presença e conversão |
+| `create_event` | Cria evento |
+| `update_event` | Edita evento |
+| `list_timelines` | Lista timelines com etapas |
+| `apply_timeline` | Aplica timeline a um evento |
+| `list_automations` | Lista automações de um evento |
+| `create_automation` | Cria automação individual |
+| `update_automation` | Edita/ativa/desativa automação |
+| `delete_automation` | Remove automação |
+| `list_templates` | Lista templates WhatsApp e e-mail |
+| `list_contacts` | Lista contatos |
+| `list_contact_lists` | Lista de segmentos pós-evento |
+| `list_integrations` | Integrações ativas e capacidades |
+
+## Desenvolvimento local
+
+```bash
+git clone https://github.com/jackemerick/jotae-mcp
+cd jotae-mcp
+npm install
+JOTAE_API_KEY=jotae_sk_... npm run dev
+```
+
+## Licença
+
+MIT

package/dist/index.js

@@ -0,0 +1,365 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const BASE_URL = process.env.JOTAE_BASE_URL ?? 'https://app.jotae.me';
+const API_KEY = process.env.JOTAE_API_KEY ?? '';
+if (!API_KEY) {
+    process.stderr.write('JOTAE_API_KEY não configurada. Defina a variável de ambiente.\n');
+    process.exit(1);
+}
+async function api(method, path, body) {
+    const res = await fetch(`${BASE_URL}/api/v1${path}`, {
+        method,
+        headers: {
+            'Authorization': `Bearer ${API_KEY}`,
+            'Content-Type': 'application/json',
+        },
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    const json = await res.json();
+    if (!res.ok)
+        throw new Error(json.error ?? `HTTP ${res.status}`);
+    return json;
+}
+// ── Tools ────────────────────────────────────────────────────────────────────
+const TOOLS = [
+    // ── Diagnóstico ──
+    {
+        name: 'get_setup_status',
+        description: 'Retorna o estado geral da conta: eventos recentes, integrações ativas, timelines configuradas e próximos passos recomendados. Chame sempre primeiro antes de qualquer outra ação.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                event_id: { type: 'string', description: 'ID do evento para diagnóstico específico (opcional)' },
+            },
+        },
+    },
+    // ── Eventos ──
+    {
+        name: 'list_events',
+        description: 'Lista todos os eventos do produtor com status, datas e configurações básicas.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'get_event',
+        description: 'Retorna todos os detalhes de um evento específico.',
+        inputSchema: {
+            type: 'object',
+            properties: { event_id: { type: 'string', description: 'ID do evento' } },
+            required: ['event_id'],
+        },
+    },
+    {
+        name: 'get_event_stats',
+        description: 'Retorna métricas do evento: inscrições, presença, pitch, cliques no CTA e taxa de conversão.',
+        inputSchema: {
+            type: 'object',
+            properties: { event_id: { type: 'string', description: 'ID do evento' } },
+            required: ['event_id'],
+        },
+    },
+    {
+        name: 'create_event',
+        description: 'Cria um novo evento ao vivo. Campos obrigatórios: title. Recomendado preencher youtube_url, event_start e cta_url.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: { type: 'string', description: 'Título do evento' },
+                youtube_url: { type: 'string', description: 'URL do vídeo no YouTube (ex: https://youtu.be/xxx)' },
+                event_start: { type: 'string', description: 'Data/hora de início ISO 8601 (ex: 2025-09-10T20:00:00-03:00)' },
+                event_end: { type: 'string', description: 'Data/hora de encerramento ISO 8601' },
+                pitch_start: { type: 'string', description: 'Início do pitch de vendas ISO 8601' },
+                pitch_end: { type: 'string', description: 'Fim do pitch ISO 8601' },
+                cta_url: { type: 'string', description: 'URL do botão de compra/CTA' },
+                cta_label: { type: 'string', description: 'Texto do botão CTA (ex: "Garantir minha vaga")' },
+            },
+            required: ['title'],
+        },
+    },
+    {
+        name: 'update_event',
+        description: 'Edita campos de um evento existente. Passe apenas os campos que deseja alterar.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                event_id: { type: 'string' },
+                title: { type: 'string' },
+                youtube_url: { type: 'string' },
+                event_start: { type: 'string' },
+                event_end: { type: 'string' },
+                pitch_start: { type: 'string' },
+                pitch_end: { type: 'string' },
+                cta_url: { type: 'string' },
+                cta_label: { type: 'string' },
+                cta_enabled: { type: 'boolean', description: 'Ativa ou desativa o CTA' },
+                status: { type: 'string', enum: ['active', 'ended'] },
+            },
+            required: ['event_id'],
+        },
+    },
+    // ── Comunicações ──
+    {
+        name: 'list_timelines',
+        description: 'Lista todas as timelines de automação configuradas, com suas etapas.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'apply_timeline',
+        description: 'Aplica uma timeline a um evento, criando todas as automações de uma vez. Use após criar o evento.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                event_id: { type: 'string', description: 'ID do evento' },
+                timeline_id: { type: 'string', description: 'ID da timeline' },
+            },
+            required: ['event_id', 'timeline_id'],
+        },
+    },
+    {
+        name: 'list_automations',
+        description: 'Lista automações de um evento. Filtre por event_id para ver o que está ativo.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                event_id: { type: 'string', description: 'Filtra por evento (opcional)' },
+            },
+        },
+    },
+    {
+        name: 'create_automation',
+        description: 'Cria uma automação individual em um evento. Prefira apply_timeline para configurar tudo de uma vez.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                event_id: { type: 'string' },
+                label: { type: 'string', description: 'Nome descritivo da automação' },
+                channel: { type: 'string', enum: ['whatsapp', 'email'] },
+                trigger: { type: 'string', enum: ['registration', 'event_start', 'event_end', 'attended', 'no_show', 'watched_pitch', 'clicked_cta', 'purchased', 'scheduled'] },
+                delay_minutes: { type: 'number', description: 'Minutos após o gatilho (negativo = antes)' },
+                template_id: { type: 'string', description: 'ID do template WhatsApp' },
+                broadcast_template_id: { type: 'string', description: 'ID do template de e-mail' },
+                send_time: { type: 'string', description: 'Ancora horário HH:MM (ex: "08:00")' },
+                scheduled_at: { type: 'string', description: 'Data/hora absoluta ISO 8601 (para trigger=scheduled)' },
+                audience_list_id: { type: 'string', description: 'ID da lista de destinatários' },
+                exclude_list_id: { type: 'string', description: 'ID da lista de exclusão' },
+            },
+            required: ['event_id', 'channel', 'trigger'],
+        },
+    },
+    {
+        name: 'update_automation',
+        description: 'Edita uma automação existente. Use para ativar/desativar ou ajustar timing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                automation_id: { type: 'string' },
+                label: { type: 'string' },
+                delay_minutes: { type: 'number' },
+                send_time: { type: 'string' },
+                scheduled_at: { type: 'string' },
+                active: { type: 'boolean' },
+            },
+            required: ['automation_id'],
+        },
+    },
+    {
+        name: 'delete_automation',
+        description: 'Remove uma automação de um evento.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                automation_id: { type: 'string' },
+            },
+            required: ['automation_id'],
+        },
+    },
+    {
+        name: 'list_templates',
+        description: 'Lista templates disponíveis de WhatsApp e e-mail. Filtre por channel se necessário.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                channel: { type: 'string', enum: ['whatsapp', 'email'], description: 'Filtra por canal (opcional)' },
+            },
+        },
+    },
+    // ── Dados ──
+    {
+        name: 'list_contacts',
+        description: 'Lista contatos do produtor com paginação.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: { type: 'number', description: 'Máximo de resultados (padrão 100, máximo 500)' },
+                offset: { type: 'number', description: 'Paginação' },
+            },
+        },
+    },
+    {
+        name: 'list_contact_lists',
+        description: 'Lista as listas de contatos geradas automaticamente após eventos (participantes, pitch, CTA, no-show).',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'list_integrations',
+        description: 'Mostra quais integrações estão ativas (WhatsApp, e-mail, CRM, analytics) e as capacidades disponíveis.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+];
+// ── Prompts (guias de fluxo) ─────────────────────────────────────────────────
+const PROMPTS = [
+    {
+        name: 'setup_event',
+        description: 'Guia completo para configurar um evento do zero: dados, CTA, automações.',
+        arguments: [
+            { name: 'event_name', description: 'Nome do evento a criar', required: true },
+        ],
+    },
+    {
+        name: 'post_event_followup',
+        description: 'Configura automações de follow-up após um evento encerrado (no-show, participantes, compradores).',
+        arguments: [
+            { name: 'event_id', description: 'ID do evento encerrado', required: true },
+        ],
+    },
+];
+// ── Server ───────────────────────────────────────────────────────────────────
+const server = new index_js_1.Server({ name: 'jotae-mcp', version: '1.0.0' }, { capabilities: { tools: {}, prompts: {} } });
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(types_js_1.ListPromptsRequestSchema, async () => ({ prompts: PROMPTS }));
+server.setRequestHandler(types_js_1.GetPromptRequestSchema, async (req) => {
+    const { name, arguments: args } = req.params;
+    if (name === 'setup_event') {
+        const eventName = args?.event_name ?? 'novo evento';
+        return {
+            messages: [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `Quero configurar o evento "${eventName}" no Jotae.
+
+Siga estas etapas em ordem:
+1. Chame get_setup_status para entender o estado atual da conta
+2. Crie o evento com create_event (título, data, YouTube, CTA)
+3. Chame list_integrations para saber quais canais estão disponíveis
+4. Chame list_timelines para ver timelines existentes
+5. Se houver timeline adequada, aplique com apply_timeline
+6. Se não, chame list_templates e crie automações individuais com create_automation
+7. Confirme o resultado com get_event e list_automations
+
+Seja direto: pergunte apenas o que não consegue inferir.`,
+                    },
+                }],
+        };
+    }
+    if (name === 'post_event_followup') {
+        const eventId = args?.event_id ?? '';
+        return {
+            messages: [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `Quero configurar o follow-up pós-evento para o evento ${eventId}.
+
+Etapas:
+1. Chame get_event_stats para ver quem participou, quem viu o pitch e quem clicou no CTA
+2. Chame list_contact_lists para ver as listas geradas (participantes, no-show, pitch, CTA)
+3. Chame list_integrations para confirmar canais disponíveis
+4. Chame list_templates para ver mensagens disponíveis
+5. Crie automações segmentadas com create_automation:
+   - Participantes que NÃO clicaram no CTA → lembrete de oferta
+   - No-show → mensagem de replay ou segunda chance
+   - Compradores (se tiver integração Hotmart) → boas-vindas
+6. Confirme com list_automations
+
+Não pergunte o que já sabe pelas chamadas.`,
+                    },
+                }],
+        };
+    }
+    throw new Error(`Prompt "${name}" não encontrado`);
+});
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (req) => {
+    const { name, arguments: args } = req.params;
+    const a = (args ?? {});
+    try {
+        let result;
+        switch (name) {
+            case 'get_setup_status':
+                result = await api('GET', `/setup-status${a.event_id ? `?event_id=${a.event_id}` : ''}`);
+                break;
+            case 'list_events':
+                result = await api('GET', '/events');
+                break;
+            case 'get_event':
+                result = await api('GET', `/events/${a.event_id}`);
+                break;
+            case 'get_event_stats':
+                result = await api('GET', `/events/${a.event_id}/stats`);
+                break;
+            case 'create_event':
+                result = await api('POST', '/events', a);
+                break;
+            case 'update_event': {
+                const { event_id, ...patch } = a;
+                result = await api('PATCH', `/events/${event_id}`, patch);
+                break;
+            }
+            case 'list_timelines':
+                result = await api('GET', '/timelines');
+                break;
+            case 'apply_timeline':
+                result = await api('POST', `/events/${a.event_id}/apply-timeline`, { timeline_id: a.timeline_id });
+                break;
+            case 'list_automations':
+                result = await api('GET', `/automations${a.event_id ? `?event_id=${a.event_id}` : ''}`);
+                break;
+            case 'create_automation':
+                result = await api('POST', '/automations', a);
+                break;
+            case 'update_automation': {
+                const { automation_id, ...patch } = a;
+                result = await api('PATCH', `/automations/${automation_id}`, patch);
+                break;
+            }
+            case 'delete_automation':
+                result = await api('DELETE', `/automations/${a.automation_id}`);
+                break;
+            case 'list_templates':
+                result = await api('GET', `/templates${a.channel ? `?channel=${a.channel}` : ''}`);
+                break;
+            case 'list_contacts':
+                result = await api('GET', `/contacts?limit=${a.limit ?? 100}&offset=${a.offset ?? 0}`);
+                break;
+            case 'list_contact_lists':
+                result = await api('GET', '/lists');
+                break;
+            case 'list_integrations':
+                result = await api('GET', '/integrations');
+                break;
+            default:
+                throw new Error(`Tool desconhecida: ${name}`);
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (e) {
+        return {
+            content: [{ type: 'text', text: `Erro: ${e.message}` }],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write('Jotae MCP Server iniciado\n');
+}
+main().catch(e => {
+    process.stderr.write(`Erro fatal: ${e}\n`);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "jotae-mcp",
+  "version": "1.0.0",
+  "description": "MCP Server para o Jotae — cria eventos, configura automações e lê métricas via Claude",
+  "main": "dist/index.js",
+  "bin": {
+    "jotae-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.0"
+  },
+  "keywords": ["mcp", "jotae", "claude", "ai", "events", "whatsapp"],
+  "license": "MIT"
+}

package/src/index.ts

@@ -0,0 +1,394 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js'
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  ListPromptsRequestSchema,
+  GetPromptRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js'
+import { z } from 'zod'
+
+const BASE_URL = process.env.JOTAE_BASE_URL ?? 'https://app.jotae.me'
+const API_KEY  = process.env.JOTAE_API_KEY ?? ''
+
+if (!API_KEY) {
+  process.stderr.write('JOTAE_API_KEY não configurada. Defina a variável de ambiente.\n')
+  process.exit(1)
+}
+
+async function api(method: string, path: string, body?: unknown) {
+  const res = await fetch(`${BASE_URL}/api/v1${path}`, {
+    method,
+    headers: {
+      'Authorization': `Bearer ${API_KEY}`,
+      'Content-Type': 'application/json',
+    },
+    body: body ? JSON.stringify(body) : undefined,
+  })
+  const json = await res.json() as Record<string, unknown>
+  if (!res.ok) throw new Error((json.error as string) ?? `HTTP ${res.status}`)
+  return json
+}
+
+// ── Tools ────────────────────────────────────────────────────────────────────
+
+const TOOLS = [
+  // ── Diagnóstico ──
+  {
+    name: 'get_setup_status',
+    description: 'Retorna o estado geral da conta: eventos recentes, integrações ativas, timelines configuradas e próximos passos recomendados. Chame sempre primeiro antes de qualquer outra ação.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        event_id: { type: 'string', description: 'ID do evento para diagnóstico específico (opcional)' },
+      },
+    },
+  },
+
+  // ── Eventos ──
+  {
+    name: 'list_events',
+    description: 'Lista todos os eventos do produtor com status, datas e configurações básicas.',
+    inputSchema: { type: 'object' as const, properties: {} },
+  },
+  {
+    name: 'get_event',
+    description: 'Retorna todos os detalhes de um evento específico.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: { event_id: { type: 'string', description: 'ID do evento' } },
+      required: ['event_id'],
+    },
+  },
+  {
+    name: 'get_event_stats',
+    description: 'Retorna métricas do evento: inscrições, presença, pitch, cliques no CTA e taxa de conversão.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: { event_id: { type: 'string', description: 'ID do evento' } },
+      required: ['event_id'],
+    },
+  },
+  {
+    name: 'create_event',
+    description: 'Cria um novo evento ao vivo. Campos obrigatórios: title. Recomendado preencher youtube_url, event_start e cta_url.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        title:       { type: 'string',  description: 'Título do evento' },
+        youtube_url: { type: 'string',  description: 'URL do vídeo no YouTube (ex: https://youtu.be/xxx)' },
+        event_start: { type: 'string',  description: 'Data/hora de início ISO 8601 (ex: 2025-09-10T20:00:00-03:00)' },
+        event_end:   { type: 'string',  description: 'Data/hora de encerramento ISO 8601' },
+        pitch_start: { type: 'string',  description: 'Início do pitch de vendas ISO 8601' },
+        pitch_end:   { type: 'string',  description: 'Fim do pitch ISO 8601' },
+        cta_url:     { type: 'string',  description: 'URL do botão de compra/CTA' },
+        cta_label:   { type: 'string',  description: 'Texto do botão CTA (ex: "Garantir minha vaga")' },
+      },
+      required: ['title'],
+    },
+  },
+  {
+    name: 'update_event',
+    description: 'Edita campos de um evento existente. Passe apenas os campos que deseja alterar.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        event_id:    { type: 'string' },
+        title:       { type: 'string' },
+        youtube_url: { type: 'string' },
+        event_start: { type: 'string' },
+        event_end:   { type: 'string' },
+        pitch_start: { type: 'string' },
+        pitch_end:   { type: 'string' },
+        cta_url:     { type: 'string' },
+        cta_label:   { type: 'string' },
+        cta_enabled: { type: 'boolean', description: 'Ativa ou desativa o CTA' },
+        status:      { type: 'string',  enum: ['active', 'ended'] },
+      },
+      required: ['event_id'],
+    },
+  },
+
+  // ── Comunicações ──
+  {
+    name: 'list_timelines',
+    description: 'Lista todas as timelines de automação configuradas, com suas etapas.',
+    inputSchema: { type: 'object' as const, properties: {} },
+  },
+  {
+    name: 'apply_timeline',
+    description: 'Aplica uma timeline a um evento, criando todas as automações de uma vez. Use após criar o evento.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        event_id:    { type: 'string', description: 'ID do evento' },
+        timeline_id: { type: 'string', description: 'ID da timeline' },
+      },
+      required: ['event_id', 'timeline_id'],
+    },
+  },
+  {
+    name: 'list_automations',
+    description: 'Lista automações de um evento. Filtre por event_id para ver o que está ativo.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        event_id: { type: 'string', description: 'Filtra por evento (opcional)' },
+      },
+    },
+  },
+  {
+    name: 'create_automation',
+    description: 'Cria uma automação individual em um evento. Prefira apply_timeline para configurar tudo de uma vez.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        event_id:             { type: 'string' },
+        label:                { type: 'string', description: 'Nome descritivo da automação' },
+        channel:              { type: 'string', enum: ['whatsapp', 'email'] },
+        trigger:              { type: 'string', enum: ['registration', 'event_start', 'event_end', 'attended', 'no_show', 'watched_pitch', 'clicked_cta', 'purchased', 'scheduled'] },
+        delay_minutes:        { type: 'number', description: 'Minutos após o gatilho (negativo = antes)' },
+        template_id:          { type: 'string', description: 'ID do template WhatsApp' },
+        broadcast_template_id:{ type: 'string', description: 'ID do template de e-mail' },
+        send_time:            { type: 'string', description: 'Ancora horário HH:MM (ex: "08:00")' },
+        scheduled_at:         { type: 'string', description: 'Data/hora absoluta ISO 8601 (para trigger=scheduled)' },
+        audience_list_id:     { type: 'string', description: 'ID da lista de destinatários' },
+        exclude_list_id:      { type: 'string', description: 'ID da lista de exclusão' },
+      },
+      required: ['event_id', 'channel', 'trigger'],
+    },
+  },
+  {
+    name: 'update_automation',
+    description: 'Edita uma automação existente. Use para ativar/desativar ou ajustar timing.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        automation_id:  { type: 'string' },
+        label:          { type: 'string' },
+        delay_minutes:  { type: 'number' },
+        send_time:      { type: 'string' },
+        scheduled_at:   { type: 'string' },
+        active:         { type: 'boolean' },
+      },
+      required: ['automation_id'],
+    },
+  },
+  {
+    name: 'delete_automation',
+    description: 'Remove uma automação de um evento.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        automation_id: { type: 'string' },
+      },
+      required: ['automation_id'],
+    },
+  },
+  {
+    name: 'list_templates',
+    description: 'Lista templates disponíveis de WhatsApp e e-mail. Filtre por channel se necessário.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        channel: { type: 'string', enum: ['whatsapp', 'email'], description: 'Filtra por canal (opcional)' },
+      },
+    },
+  },
+
+  // ── Dados ──
+  {
+    name: 'list_contacts',
+    description: 'Lista contatos do produtor com paginação.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        limit:  { type: 'number', description: 'Máximo de resultados (padrão 100, máximo 500)' },
+        offset: { type: 'number', description: 'Paginação' },
+      },
+    },
+  },
+  {
+    name: 'list_contact_lists',
+    description: 'Lista as listas de contatos geradas automaticamente após eventos (participantes, pitch, CTA, no-show).',
+    inputSchema: { type: 'object' as const, properties: {} },
+  },
+  {
+    name: 'list_integrations',
+    description: 'Mostra quais integrações estão ativas (WhatsApp, e-mail, CRM, analytics) e as capacidades disponíveis.',
+    inputSchema: { type: 'object' as const, properties: {} },
+  },
+]
+
+// ── Prompts (guias de fluxo) ─────────────────────────────────────────────────
+
+const PROMPTS = [
+  {
+    name: 'setup_event',
+    description: 'Guia completo para configurar um evento do zero: dados, CTA, automações.',
+    arguments: [
+      { name: 'event_name', description: 'Nome do evento a criar', required: true },
+    ],
+  },
+  {
+    name: 'post_event_followup',
+    description: 'Configura automações de follow-up após um evento encerrado (no-show, participantes, compradores).',
+    arguments: [
+      { name: 'event_id', description: 'ID do evento encerrado', required: true },
+    ],
+  },
+]
+
+// ── Server ───────────────────────────────────────────────────────────────────
+
+const server = new Server(
+  { name: 'jotae-mcp', version: '1.0.0' },
+  { capabilities: { tools: {}, prompts: {} } }
+)
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }))
+
+server.setRequestHandler(ListPromptsRequestSchema, async () => ({ prompts: PROMPTS }))
+
+server.setRequestHandler(GetPromptRequestSchema, async (req) => {
+  const { name, arguments: args } = req.params
+
+  if (name === 'setup_event') {
+    const eventName = args?.event_name ?? 'novo evento'
+    return {
+      messages: [{
+        role: 'user' as const,
+        content: {
+          type: 'text' as const,
+          text: `Quero configurar o evento "${eventName}" no Jotae.
+
+Siga estas etapas em ordem:
+1. Chame get_setup_status para entender o estado atual da conta
+2. Crie o evento com create_event (título, data, YouTube, CTA)
+3. Chame list_integrations para saber quais canais estão disponíveis
+4. Chame list_timelines para ver timelines existentes
+5. Se houver timeline adequada, aplique com apply_timeline
+6. Se não, chame list_templates e crie automações individuais com create_automation
+7. Confirme o resultado com get_event e list_automations
+
+Seja direto: pergunte apenas o que não consegue inferir.`,
+        },
+      }],
+    }
+  }
+
+  if (name === 'post_event_followup') {
+    const eventId = args?.event_id ?? ''
+    return {
+      messages: [{
+        role: 'user' as const,
+        content: {
+          type: 'text' as const,
+          text: `Quero configurar o follow-up pós-evento para o evento ${eventId}.
+
+Etapas:
+1. Chame get_event_stats para ver quem participou, quem viu o pitch e quem clicou no CTA
+2. Chame list_contact_lists para ver as listas geradas (participantes, no-show, pitch, CTA)
+3. Chame list_integrations para confirmar canais disponíveis
+4. Chame list_templates para ver mensagens disponíveis
+5. Crie automações segmentadas com create_automation:
+   - Participantes que NÃO clicaram no CTA → lembrete de oferta
+   - No-show → mensagem de replay ou segunda chance
+   - Compradores (se tiver integração Hotmart) → boas-vindas
+6. Confirme com list_automations
+
+Não pergunte o que já sabe pelas chamadas.`,
+        },
+      }],
+    }
+  }
+
+  throw new Error(`Prompt "${name}" não encontrado`)
+})
+
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+  const { name, arguments: args } = req.params
+  const a = (args ?? {}) as Record<string, unknown>
+
+  try {
+    let result: unknown
+
+    switch (name) {
+      case 'get_setup_status':
+        result = await api('GET', `/setup-status${a.event_id ? `?event_id=${a.event_id}` : ''}`)
+        break
+      case 'list_events':
+        result = await api('GET', '/events')
+        break
+      case 'get_event':
+        result = await api('GET', `/events/${a.event_id}`)
+        break
+      case 'get_event_stats':
+        result = await api('GET', `/events/${a.event_id}/stats`)
+        break
+      case 'create_event':
+        result = await api('POST', '/events', a)
+        break
+      case 'update_event': {
+        const { event_id, ...patch } = a
+        result = await api('PATCH', `/events/${event_id}`, patch)
+        break
+      }
+      case 'list_timelines':
+        result = await api('GET', '/timelines')
+        break
+      case 'apply_timeline':
+        result = await api('POST', `/events/${a.event_id}/apply-timeline`, { timeline_id: a.timeline_id })
+        break
+      case 'list_automations':
+        result = await api('GET', `/automations${a.event_id ? `?event_id=${a.event_id}` : ''}`)
+        break
+      case 'create_automation':
+        result = await api('POST', '/automations', a)
+        break
+      case 'update_automation': {
+        const { automation_id, ...patch } = a
+        result = await api('PATCH', `/automations/${automation_id}`, patch)
+        break
+      }
+      case 'delete_automation':
+        result = await api('DELETE', `/automations/${a.automation_id}`)
+        break
+      case 'list_templates':
+        result = await api('GET', `/templates${a.channel ? `?channel=${a.channel}` : ''}`)
+        break
+      case 'list_contacts':
+        result = await api('GET', `/contacts?limit=${a.limit ?? 100}&offset=${a.offset ?? 0}`)
+        break
+      case 'list_contact_lists':
+        result = await api('GET', '/lists')
+        break
+      case 'list_integrations':
+        result = await api('GET', '/integrations')
+        break
+      default:
+        throw new Error(`Tool desconhecida: ${name}`)
+    }
+
+    return {
+      content: [{ type: 'text' as const, text: JSON.stringify(result, null, 2) }],
+    }
+  } catch (e) {
+    return {
+      content: [{ type: 'text' as const, text: `Erro: ${(e as Error).message}` }],
+      isError: true,
+    }
+  }
+})
+
+async function main() {
+  const transport = new StdioServerTransport()
+  await server.connect(transport)
+  process.stderr.write('Jotae MCP Server iniciado\n')
+}
+
+main().catch(e => {
+  process.stderr.write(`Erro fatal: ${e}\n`)
+  process.exit(1)
+})

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}