@creativeproject/creative-plann-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Creative Project
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,148 @@
+# @creativeproject/creative-plann-mcp
+
+Servidor [MCP](https://modelcontextprotocol.io) do **Creative Plann**. Conecta uma IA
+(Claude Code, Codex, Cursor) ao seu planejamento de redes sociais: ela lê o
+calendário, cria posts, escreve briefing e roteiro, e move os cards do fluxo.
+
+## Instalação
+
+Não precisa instalar nada — o cliente baixa o pacote sob demanda.
+
+### Claude Code
+
+```bash
+claude mcp add creative-plann \
+  -e CREATIVE_PLANN_TOKEN=seu_token \
+  -- npx -y @creativeproject/creative-plann-mcp
+```
+
+### Outros clientes
+
+```json
+{
+  "mcpServers": {
+    "creative-plann": {
+      "command": "npx",
+      "args": ["-y", "@creativeproject/creative-plann-mcp"],
+      "env": { "CREATIVE_PLANN_TOKEN": "seu_token" }
+    }
+  }
+}
+```
+
+## Token
+
+Gere no menu da conta (avatar no topo) → **API e IA**. O token define:
+
+- **papel** — de leitor a admin, nunca acima de quem o criou;
+- **empresas** — todas, ou apenas as que você escolher;
+- **permissão de publicar** — desligada por padrão.
+
+O valor aparece uma única vez: guardamos apenas o hash. Se vazar, revogue e
+gere outro — leva um clique, e revogar um token não afeta os demais.
+
+## Variáveis de ambiente
+
+| Variável | Obrigatória | Descrição |
+| --- | --- | --- |
+| `CREATIVE_PLANN_TOKEN` | sim | Token gerado na aplicação. |
+| `CREATIVE_PLANN_URL` | não | Base da instância. Padrão: `https://plann.creativeproject.com.br`. |
+
+## Publicar não é automático
+
+Por padrão o token **não publica**. A IA planeja, escreve, organiza e agenda a
+data — mas mover o post para publicação exige uma pessoa na interface.
+
+Isso é deliberado: publicar não tem desfazer. Um horário ou um texto errado vai
+ao ar no perfil do cliente, e nenhuma correção posterior desfaz quem já viu.
+Quando quiser automação completa, marque *"pode publicar"* ao gerar o token.
+
+## Anotações de comportamento
+
+Cada ferramenta declara ao cliente MCP se apenas lê, se altera, e se é
+destrutiva. É o que permite ao cliente auto-aprovar `list_posts` e pedir
+confirmação em `delete_post`, `set_stage` e `set_status` — as três que apagam
+trabalho ou disparam publicação.
+
+São hints de interface, não fronteira de segurança: a autorização real está no
+servidor, ligada ao papel e ao escopo do token.
+
+## Ferramentas
+
+**Contexto** — `whoami`, `list_companies`, `list_accounts`,
+`describe_vocabulary`, `list_members`, `list_media`, `list_campaigns`,
+`create_campaign`
+
+**Visão do trabalho** — `get_board`, `get_calendar`, `list_posts`, `get_post`,
+`get_post_history`
+
+**Criação e edição** — `create_post`, `update_post`, `schedule_post`,
+`set_stage`, `set_status`, `comment_on_post`, `delete_post`
+
+Comece por `whoami`: ele diz quais empresas o token alcança e o que ele pode
+fazer. Depois `list_accounts`, porque cada rede aceita formatos diferentes,
+com limites próprios de texto e de mídia.
+
+## Dois eixos independentes
+
+O mesmo post tem **etapa** e **status**, e eles não são a mesma coisa:
+
+- **etapa** (`set_stage`) é o fluxo editorial no Kanban: `IDEA` → `BRIEFING` →
+  `SCRIPT` → `PRODUCTION` → `INTERNAL_REVIEW` → `CLIENT_REVIEW` →
+  `APPROVED_STAGE` → `READY`;
+- **status** (`set_status`) é o ciclo de publicação: `DRAFT` → `IN_REVIEW` →
+  `APPROVED` → `SCHEDULED` → `PUBLISHED`.
+
+`PUBLISHING`, `PUBLISHED` e `FAILED` são escritos pelo motor de publicação e
+não podem ser definidos pela API — deixá-los editáveis faria o histórico mentir.
+
+## Horários
+
+Datas de trabalho são sempre **locais à empresa**, no formato
+`"2026-09-01T10:30"` — sem `Z`, sem offset. Cada empresa tem seu fuso, e a
+conversão acontece no servidor.
+
+As respostas trazem os dois: `{ "utc": "...", "local": "..." }`.
+
+## Um post, várias redes
+
+Um post tem um conteúdo e vários destinos, cada um com seu formato. O mesmo
+material pode sair como Reel no Instagram, vídeo no Facebook e artigo no
+LinkedIn — com legenda própria por rede quando fizer sentido:
+
+```json
+{
+  "company": "minha-empresa",
+  "contentKind": "VIDEO",
+  "caption": "Legenda base para todas as redes.",
+  "targets": [
+    { "socialAccountId": "...", "format": "REEL" },
+    { "socialAccountId": "...", "format": "VIDEO" },
+    {
+      "socialAccountId": "...",
+      "format": "LINKEDIN_ARTICLE",
+      "title": "Título do artigo",
+      "body": "<p>Corpo longo, só no LinkedIn.</p>"
+    }
+  ]
+}
+```
+
+## Desenvolvimento
+
+```bash
+npm install
+npm run build      # compila e marca o executável
+npm test           # testes do cliente e contrato das ferramentas
+npm run typecheck  # inclui os testes
+```
+
+`CREATIVE_PLANN_URL` aponta para outra instância — é como se testa contra um
+servidor local.
+
+O executável (`cli.ts`) é separado da biblioteca (`index.ts`): importar o
+pacote não inicia servidor nem toma o stdio do processo.
+
+## Licença
+
+MIT — veja [LICENSE](./LICENSE).

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { serveStdio } from "@modelcontextprotocol/server/stdio";
+import { CreativePlannClient } from "./client.js";
+import { createServer } from "./server.js";
+import { VERSION } from "./version.js";
+/**
+ * Executável do servidor MCP, sobre stdio.
+ *
+ * Em stdio o stdout é o canal JSON-RPC: qualquer `console.log` corromperia o
+ * protocolo. Diagnóstico vai sempre para stderr.
+ */
+console.error(`creative-plann mcp ${VERSION} — stdio`);
+const handle = serveStdio(() => createServer(new CreativePlannClient({
+    token: process.env.CREATIVE_PLANN_TOKEN ?? "",
+    baseUrl: process.env.CREATIVE_PLANN_URL,
+})));
+/**
+ * Encerra limpo em SIGINT/SIGTERM — é o que acontece quando o usuário fecha o
+ * cliente MCP. Sem isto, requisições em vôo são abortadas na marra.
+ */
+async function shutdown(signal) {
+    console.error(`creative-plann mcp: recebido ${signal}, encerrando`);
+    try {
+        await handle.close();
+    }
+    catch (error) {
+        console.error("creative-plann mcp: falha ao encerrar:", error);
+    }
+    process.exit(0);
+}
+process.on("SIGINT", () => void shutdown("SIGINT"));
+process.on("SIGTERM", () => void shutdown("SIGTERM"));
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;GAKG;AACH,OAAO,CAAC,KAAK,CAAC,sBAAsB,OAAO,UAAU,CAAC,CAAC;AAEvD,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,CAC7B,YAAY,CACV,IAAI,mBAAmB,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE;IAC7C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;CACxC,CAAC,CACH,CACF,CAAC;AAEF;;;GAGG;AACH,KAAK,UAAU,QAAQ,CAAC,MAAc;IACpC,OAAO,CAAC,KAAK,CAAC,gCAAgC,MAAM,cAAc,CAAC,CAAC;IACpE,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACpD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Cliente da API do Creative Plann. Fino de propósito: a regra de negócio vive
+ * no servidor, e duplicá-la aqui só criaria duas verdades que divergem a cada
+ * atualização da aplicação.
+ */
+export type ApiErrorBody = {
+    error: {
+        code: string;
+        message: string;
+        hint?: string;
+        details?: unknown;
+    };
+};
+export declare class CreativePlannError extends Error {
+    readonly code: string;
+    readonly hint?: string;
+    readonly details?: unknown;
+    constructor(body: ApiErrorBody["error"], status: number);
+    /** Texto para o modelo: mensagem, o que fazer e o detalhe por campo. */
+    toModelText(): string;
+}
+export type ClientOptions = {
+    token: string;
+    baseUrl?: string;
+};
+export declare class CreativePlannClient {
+    private readonly token;
+    private readonly baseUrl;
+    constructor({ token, baseUrl }: ClientOptions);
+    /** Mensagem acionável em vez de um 401 cru quando falta configuração. */
+    private assertConfigured;
+    request<T = unknown>(method: "GET" | "POST" | "PATCH" | "DELETE", path: string, options?: {
+        body?: unknown;
+        query?: Record<string, string | number | undefined>;
+    }): Promise<T>;
+    get<T>(path: string, query?: Record<string, string | number | undefined>): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    patch<T>(path: string, body: unknown): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+}

package/dist/client.js

@@ -0,0 +1,99 @@
+/**
+ * Cliente da API do Creative Plann. Fino de propósito: a regra de negócio vive
+ * no servidor, e duplicá-la aqui só criaria duas verdades que divergem a cada
+ * atualização da aplicação.
+ */
+const DEFAULT_BASE_URL = "https://plann.creativeproject.com.br";
+export class CreativePlannError extends Error {
+    code;
+    hint;
+    details;
+    constructor(body, status) {
+        super(body.message);
+        this.name = "CreativePlannError";
+        this.code = body.code || `http_${status}`;
+        this.hint = body.hint;
+        this.details = body.details;
+    }
+    /** Texto para o modelo: mensagem, o que fazer e o detalhe por campo. */
+    toModelText() {
+        const lines = [this.message];
+        if (this.hint)
+            lines.push(`Como resolver: ${this.hint}`);
+        if (this.details !== undefined) {
+            lines.push(`Detalhes: ${JSON.stringify(this.details, null, 2)}`);
+        }
+        return lines.join("\n");
+    }
+}
+export class CreativePlannClient {
+    token;
+    baseUrl;
+    constructor({ token, baseUrl }) {
+        // Token vazio não impede o servidor de subir. Se lançássemos aqui, o
+        // processo morreria antes do handshake e o cliente MCP mostraria apenas
+        // "desconectado" — a instrução de configuração ficaria enterrada no log.
+        // Assim ela chega como resultado da primeira ferramenta chamada.
+        this.token = token;
+        this.baseUrl = (baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    }
+    /** Mensagem acionável em vez de um 401 cru quando falta configuração. */
+    assertConfigured() {
+        if (!this.token) {
+            throw new CreativePlannError({
+                code: "missing_token",
+                message: "Token ausente: a variável CREATIVE_PLANN_TOKEN não está definida.",
+                hint: "Gere um token no menu da conta → API e IA e defina-o na configuração " +
+                    "do servidor MCP (env CREATIVE_PLANN_TOKEN).",
+            }, 401);
+        }
+    }
+    async request(method, path, options = {}) {
+        this.assertConfigured();
+        const url = new URL(`${this.baseUrl}/api/v1${path}`);
+        for (const [key, value] of Object.entries(options.query ?? {})) {
+            if (value !== undefined && value !== "")
+                url.searchParams.set(key, String(value));
+        }
+        const response = await fetch(url, {
+            method,
+            headers: {
+                authorization: `Bearer ${this.token}`,
+                ...(options.body !== undefined ? { "content-type": "application/json" } : {}),
+            },
+            ...(options.body !== undefined ? { body: JSON.stringify(options.body) } : {}),
+            // Uma operação que trava é pior que uma que falha: o agente fica esperando.
+            signal: AbortSignal.timeout(30_000),
+        });
+        const text = await response.text();
+        const payload = text.trim() ? safeParse(text) : {};
+        if (!response.ok) {
+            const body = payload.error;
+            throw new CreativePlannError(body ?? { code: `http_${response.status}`, message: text.slice(0, 500) || response.statusText }, response.status);
+        }
+        return payload;
+    }
+    get(path, query) {
+        return this.request("GET", path, { query });
+    }
+    post(path, body) {
+        return this.request("POST", path, { body });
+    }
+    patch(path, body) {
+        return this.request("PATCH", path, { body });
+    }
+    delete(path) {
+        return this.request("DELETE", path);
+    }
+}
+function safeParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        // Resposta não-JSON costuma ser página de erro de proxy ou de login: o
+        // texto cru ajuda mais a diagnosticar que um "parse failed".
+        return { error: { code: "invalid_response", message: text.slice(0, 500) } };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Entrada de biblioteca. Importar este módulo **não** inicia o servidor — quem
+ * faz isso é `cli.ts`, o executável. Manter os dois separados evita que um
+ * `import` do pacote tome o stdio do processo hospedeiro.
+ */
+export { CreativePlannClient, CreativePlannError } from "./client.js";
+export type { ApiErrorBody, ClientOptions } from "./client.js";
+export { createServer } from "./server.js";
+export { registerTools } from "./tools/index.js";
+export { VERSION } from "./version.js";

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * Entrada de biblioteca. Importar este módulo **não** inicia o servidor — quem
+ * faz isso é `cli.ts`, o executável. Manter os dois separados evita que um
+ * `import` do pacote tome o stdio do processo hospedeiro.
+ */
+export { CreativePlannClient, CreativePlannError } from "./client.js";
+export { createServer } from "./server.js";
+export { registerTools } from "./tools/index.js";
+export { VERSION } from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/server";
+import { CreativePlannClient } from "./client.js";
+/**
+ * Monta o servidor. Separado do executável para poder ser instanciado em teste
+ * sem tomar o stdio do processo.
+ */
+export declare function createServer(client: CreativePlannClient): McpServer;

package/dist/server.js

@@ -0,0 +1,38 @@
+import { McpServer } from "@modelcontextprotocol/server";
+import { registerTools } from "./tools/index.js";
+import { VERSION } from "./version.js";
+/**
+ * Monta o servidor. Separado do executável para poder ser instanciado em teste
+ * sem tomar o stdio do processo.
+ */
+export function createServer(client) {
+    const server = new McpServer({ name: "creative-plann", version: VERSION }, {
+        capabilities: { tools: {} },
+        // O modelo lê isto antes de escolher ferramentas. Dizer o que a
+        // ferramenta NÃO faz evita que ele leia a recusa de publicar como bug e
+        // saia tentando caminhos alternativos.
+        //
+        // Não confiamos só nisto: clientes podem truncar ou ignorar
+        // `instructions`, então o que é crítico se repete na descrição de cada
+        // ferramenta.
+        instructions: [
+            "Creative Plann: planejamento e agendamento de posts em redes sociais,",
+            "organizado por empresa dentro de uma organização.",
+            "",
+            "Comece sempre por `whoami`: ele diz quais empresas você alcança e o que",
+            "este token pode fazer. Depois use `list_accounts` na empresa escolhida —",
+            "cada rede aceita formatos diferentes, com limites próprios de texto e mídia.",
+            "",
+            "Fluxo editorial (Kanban) e ciclo de publicação são eixos distintos:",
+            "`set_stage` move o card no fluxo (IDEA → BRIEFING → … → READY);",
+            "`set_status` controla a publicação (DRAFT → IN_REVIEW → APPROVED → SCHEDULED).",
+            "",
+            "Publicar é irreversível. Se o token não tiver permissão de publicar,",
+            "deixe o post pronto e agendado e informe que a liberação é humana —",
+            "não tente contornar a recusa por outro caminho.",
+        ].join("\n"),
+    });
+    registerTools(server, client);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA2B;IACtD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC5C;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B,gEAAgE;QAChE,wEAAwE;QACxE,uCAAuC;QACvC,EAAE;QACF,4DAA4D;QAC5D,uEAAuE;QACvE,cAAc;QACd,YAAY,EAAE;YACZ,uEAAuE;YACvE,mDAAmD;YACnD,EAAE;YACF,yEAAyE;YACzE,0EAA0E;YAC1E,8EAA8E;YAC9E,EAAE;YACF,qEAAqE;YACrE,iEAAiE;YACjE,gFAAgF;YAChF,EAAE;YACF,sEAAsE;YACtE,qEAAqE;YACrE,iDAAiD;SAClD,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CACF,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/shared.d.ts

@@ -0,0 +1,81 @@
+import * as z from "zod/v4";
+/**
+ * Vocabulário e utilidades compartilhados pelos módulos de ferramentas.
+ *
+ * Duas convenções valem em tudo:
+ * - `company` aceita id **ou** slug, porque é o slug que aparece nas listagens
+ *   e forçar a tradução para id só adicionaria uma chamada e uma chance de erro.
+ * - Horários são sempre locais à empresa. Fuso é a causa mais comum de post
+ *   publicado na hora errada, e isso não tem desfazer.
+ */
+export declare const COMPANY_ARG: z.ZodString;
+export declare const LOCAL_DATETIME: z.ZodString;
+export declare const STAGES: readonly ["IDEA", "BRIEFING", "SCRIPT", "PRODUCTION", "INTERNAL_REVIEW", "CLIENT_REVIEW", "APPROVED_STAGE", "READY", "ARCHIVED"];
+export declare const FORMATS: readonly ["FEED", "CAROUSEL", "STORY", "REEL", "VIDEO", "SHORT", "LINKEDIN_POST", "LINKEDIN_ARTICLE", "BLOG_POST", "NEWSLETTER", "THREAD"];
+export declare const CONTENT_KINDS: readonly ["IMAGE", "CAROUSEL", "VIDEO", "TEXT", "ARTICLE"];
+export declare const OBJECTIVES: readonly ["AWARENESS", "ENGAGEMENT", "CONVERSION", "AUTHORITY", "RETENTION", "RECRUITING"];
+export declare const PILLARS: readonly ["EDUCATIONAL", "SOCIAL_PROOF", "PRODUCT", "BEHIND_SCENES", "INSTITUTIONAL", "ENTERTAINMENT", "NEWS", "PROMOTION"];
+export declare const PRIORITIES: readonly ["LOW", "NORMAL", "HIGH", "URGENT"];
+export declare const SETTABLE_STATUSES: readonly ["DRAFT", "IN_REVIEW", "APPROVED", "SCHEDULED"];
+export declare const ALL_STATUSES: readonly ["DRAFT", "IN_REVIEW", "APPROVED", "SCHEDULED", "PUBLISHING", "PUBLISHED", "FAILED"];
+/**
+ * Anotações de comportamento. O cliente MCP usa estes hints para decidir o que
+ * auto-aprovar e o que confirmar com a pessoa: sem eles, `delete_post` parece
+ * igual a `whoami`.
+ *
+ * São hints de interface, não fronteira de segurança — a autorização real está
+ * no servidor, ligada ao papel e ao escopo do token.
+ */
+export declare const READ_ONLY: {
+    readonly readOnlyHint: true;
+    readonly idempotentHint: true;
+    readonly openWorldHint: false;
+};
+/** Cria ou altera, sem apagar trabalho. */
+export declare const MUTATING: {
+    readonly readOnlyHint: false;
+    readonly destructiveHint: false;
+    readonly idempotentHint: false;
+    readonly openWorldHint: false;
+};
+/** Mesma alteração repetida deixa o mesmo estado final. */
+export declare const IDEMPOTENT_MUTATING: {
+    readonly readOnlyHint: false;
+    readonly destructiveHint: false;
+    readonly idempotentHint: true;
+    readonly openWorldHint: false;
+};
+/** Apaga trabalho, ou dispara efeito externo irreversível. */
+export declare const DESTRUCTIVE: {
+    readonly readOnlyHint: false;
+    readonly destructiveHint: true;
+    readonly idempotentHint: false;
+    readonly openWorldHint: true;
+};
+/** Resposta em JSON — o modelo lida melhor com estrutura que com prosa. */
+export declare function json(value: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * Erro da API vira texto útil em vez de exceção de transporte: o modelo lê a
+ * mensagem e a dica, e pode se corrigir sozinho na tentativa seguinte.
+ */
+export declare function failure(error: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+};
+/** Envolve o handler para nunca deixar exceção escapar como erro de protocolo. */
+export declare function guard<T>(handler: (args: T) => Promise<unknown>): (args: T) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+/** Ids vão em path: escapar evita que uma barra vire outra rota. */
+export declare const path: (value: string) => string;

package/dist/shared.js

@@ -0,0 +1,141 @@
+import * as z from "zod/v4";
+import { CreativePlannError } from "./client.js";
+/**
+ * Vocabulário e utilidades compartilhados pelos módulos de ferramentas.
+ *
+ * Duas convenções valem em tudo:
+ * - `company` aceita id **ou** slug, porque é o slug que aparece nas listagens
+ *   e forçar a tradução para id só adicionaria uma chamada e uma chance de erro.
+ * - Horários são sempre locais à empresa. Fuso é a causa mais comum de post
+ *   publicado na hora errada, e isso não tem desfazer.
+ */
+export const COMPANY_ARG = z
+    .string()
+    .describe("Empresa: id ou slug (veja `whoami` ou `list_companies`).");
+export const LOCAL_DATETIME = z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$/, 'Use "YYYY-MM-DDTHH:mm"')
+    .describe('Data e hora NO FUSO DA EMPRESA, formato "2026-09-01T10:30". Não envie UTC nem sufixo Z.');
+export const STAGES = [
+    "IDEA",
+    "BRIEFING",
+    "SCRIPT",
+    "PRODUCTION",
+    "INTERNAL_REVIEW",
+    "CLIENT_REVIEW",
+    "APPROVED_STAGE",
+    "READY",
+    "ARCHIVED",
+];
+export const FORMATS = [
+    "FEED",
+    "CAROUSEL",
+    "STORY",
+    "REEL",
+    "VIDEO",
+    "SHORT",
+    "LINKEDIN_POST",
+    "LINKEDIN_ARTICLE",
+    "BLOG_POST",
+    "NEWSLETTER",
+    "THREAD",
+];
+export const CONTENT_KINDS = ["IMAGE", "CAROUSEL", "VIDEO", "TEXT", "ARTICLE"];
+export const OBJECTIVES = [
+    "AWARENESS",
+    "ENGAGEMENT",
+    "CONVERSION",
+    "AUTHORITY",
+    "RETENTION",
+    "RECRUITING",
+];
+export const PILLARS = [
+    "EDUCATIONAL",
+    "SOCIAL_PROOF",
+    "PRODUCT",
+    "BEHIND_SCENES",
+    "INSTITUTIONAL",
+    "ENTERTAINMENT",
+    "NEWS",
+    "PROMOTION",
+];
+export const PRIORITIES = ["LOW", "NORMAL", "HIGH", "URGENT"];
+export const SETTABLE_STATUSES = ["DRAFT", "IN_REVIEW", "APPROVED", "SCHEDULED"];
+export const ALL_STATUSES = [
+    "DRAFT",
+    "IN_REVIEW",
+    "APPROVED",
+    "SCHEDULED",
+    "PUBLISHING",
+    "PUBLISHED",
+    "FAILED",
+];
+/**
+ * Anotações de comportamento. O cliente MCP usa estes hints para decidir o que
+ * auto-aprovar e o que confirmar com a pessoa: sem eles, `delete_post` parece
+ * igual a `whoami`.
+ *
+ * São hints de interface, não fronteira de segurança — a autorização real está
+ * no servidor, ligada ao papel e ao escopo do token.
+ */
+export const READ_ONLY = {
+    readOnlyHint: true,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+/** Cria ou altera, sem apagar trabalho. */
+export const MUTATING = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: false,
+};
+/** Mesma alteração repetida deixa o mesmo estado final. */
+export const IDEMPOTENT_MUTATING = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+/** Apaga trabalho, ou dispara efeito externo irreversível. */
+export const DESTRUCTIVE = {
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: true,
+};
+/** Resposta em JSON — o modelo lida melhor com estrutura que com prosa. */
+export function json(value) {
+    return { content: [{ type: "text", text: JSON.stringify(value, null, 2) }] };
+}
+/**
+ * Erro da API vira texto útil em vez de exceção de transporte: o modelo lê a
+ * mensagem e a dica, e pode se corrigir sozinho na tentativa seguinte.
+ */
+export function failure(error) {
+    if (error instanceof CreativePlannError) {
+        return {
+            content: [{ type: "text", text: error.toModelText() }],
+            isError: true,
+        };
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        content: [{ type: "text", text: `Falha na chamada: ${message}` }],
+        isError: true,
+    };
+}
+/** Envolve o handler para nunca deixar exceção escapar como erro de protocolo. */
+export function guard(handler) {
+    return async (args) => {
+        try {
+            return json(await handler(args));
+        }
+        catch (error) {
+            return failure(error);
+        }
+    };
+}
+/** Ids vão em path: escapar evita que uma barra vire outra rota. */
+export const path = (value) => encodeURIComponent(value);
+//# sourceMappingURL=shared.js.map

package/dist/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"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"}

package/dist/tools/authoring.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+import type { CreativePlannClient } from "../client.js";
+/** Criação, edição e movimentação — tudo que altera o trabalho. */
+export declare function registerAuthoringTools(server: McpServer, client: CreativePlannClient): void;

package/dist/tools/authoring.js

@@ -0,0 +1,173 @@
+import * as z from "zod/v4";
+import { CONTENT_KINDS, COMPANY_ARG, DESTRUCTIVE, FORMATS, guard, IDEMPOTENT_MUTATING, LOCAL_DATETIME, MUTATING, OBJECTIVES, path, PILLARS, PRIORITIES, SETTABLE_STATUSES, STAGES, } from "../shared.js";
+/** Criação, edição e movimentação — tudo que altera o trabalho. */
+export function registerAuthoringTools(server, client) {
+    server.registerTool("create_post", {
+        title: "Criar post",
+        description: "Cria um post. Um mesmo post pode sair em várias redes ao mesmo tempo, " +
+            "cada destino com seu formato — por exemplo Reel no Instagram e artigo " +
+            "no LinkedIn. Consulte `list_accounts` antes, para usar formatos válidos. " +
+            "O post nasce como rascunho na coluna de idealização: criar nunca publica.",
+        inputSchema: z.object({
+            company: COMPANY_ARG,
+            contentKind: z
+                .enum(CONTENT_KINDS)
+                .describe("Natureza do conteúdo; o formato por rede vai em cada destino."),
+            title: z.string().max(200).optional().describe("Título curto para o card do fluxo."),
+            caption: z.string().max(200_000).optional().describe("Legenda base, sem as hashtags."),
+            targets: z
+                .array(z.object({
+                socialAccountId: z.string().min(1),
+                format: z.enum(FORMATS),
+                captionOverride: z
+                    .string()
+                    .max(200_000)
+                    .optional()
+                    .describe("Legenda só desta rede."),
+                title: z
+                    .string()
+                    .max(300)
+                    .optional()
+                    .describe("Obrigatório em artigo/blog/newsletter."),
+                body: z
+                    .string()
+                    .max(200_000)
+                    .optional()
+                    .describe("Corpo do artigo/blog/newsletter."),
+            }))
+                .min(1)
+                .describe("Ao menos um destino. Cada um define em qual rede e formato o post sai."),
+            media: z
+                .array(z.object({
+                mediaAssetId: z.string().min(1),
+                altText: z
+                    .string()
+                    .max(1000)
+                    .optional()
+                    .describe("Descrição para leitores de tela."),
+                credit: z.string().max(200).optional(),
+            }))
+                .max(10)
+                .optional()
+                .describe("Da biblioteca (`list_media`), na ordem desejada."),
+            scheduledAtLocal: LOCAL_DATETIME.optional().describe("Data desejada de publicação (só marca; não publica)."),
+            dueAtLocal: LOCAL_DATETIME.optional().describe("Prazo interno da equipe."),
+            briefing: z
+                .string()
+                .max(200_000)
+                .optional()
+                .describe("Contexto e mensagem-chave (aceita HTML)."),
+            script: z
+                .string()
+                .max(200_000)
+                .optional()
+                .describe("Roteiro ou copy longa (aceita HTML)."),
+            visualElements: z
+                .string()
+                .max(200_000)
+                .optional()
+                .describe("O que aparece na peça: pessoas, produto, cenário, texto na tela."),
+            references: z
+                .string()
+                .max(200_000)
+                .optional()
+                .describe("Links de referência (aceita HTML)."),
+            audience: z.string().max(500).optional(),
+            objective: z.enum(OBJECTIVES).optional(),
+            pillar: z.enum(PILLARS).optional(),
+            campaignId: z.string().optional(),
+            tags: z.array(z.string()).max(20).optional(),
+            hashtags: z
+                .array(z.string())
+                .max(30)
+                .optional()
+                .describe("Sem o #. Ficam fora da legenda até a publicação."),
+            hashtagsInFirstComment: z
+                .boolean()
+                .optional()
+                .describe("Publica as hashtags no primeiro comentário, deixando a legenda limpa."),
+            callToAction: z.string().max(300).optional(),
+            linkUrl: z.string().optional(),
+            assigneeId: z.string().optional().describe("Responsável (veja `list_members`)."),
+            priority: z.enum(PRIORITIES).optional(),
+        }),
+        annotations: MUTATING,
+    }, guard((body) => client.post("/posts", body)));
+    server.registerTool("update_post", {
+        title: "Atualizar post",
+        description: "Atualiza campos de um post. Só o que você enviar muda — destinos e mídia " +
+            "ficam intactos, então é seguro preencher só o briefing.",
+        inputSchema: z.object({
+            postId: z.string().min(1),
+            title: z.string().max(200).optional(),
+            caption: z.string().max(200_000).optional(),
+            briefing: z.string().max(200_000).optional(),
+            script: z.string().max(200_000).optional(),
+            visualElements: z.string().max(200_000).optional(),
+            references: z.string().max(200_000).optional(),
+            audience: z.string().max(500).optional(),
+            callToAction: z.string().max(300).optional(),
+            priority: z.enum(PRIORITIES).optional(),
+            assigneeId: z.string().nullable().optional().describe("null remove o responsável."),
+            dueAtLocal: z.string().nullable().optional().describe("null remove o prazo."),
+            tags: z.array(z.string()).max(20).optional(),
+            hashtags: z.array(z.string()).max(30).optional(),
+        }),
+        // Reenviar o mesmo patch deixa o post no mesmo estado.
+        annotations: IDEMPOTENT_MUTATING,
+    }, guard(({ postId, ...body }) => client.patch(`/posts/${path(postId)}`, body)));
+    server.registerTool("schedule_post", {
+        title: "Definir data de publicação",
+        description: "Define a data e hora de publicação, no fuso da empresa. Só marca a data: " +
+            "o disparo acontece quando o post entra em SCHEDULED ou na coluna READY.",
+        inputSchema: z.object({
+            postId: z.string().min(1),
+            scheduledAtLocal: LOCAL_DATETIME,
+        }),
+        annotations: IDEMPOTENT_MUTATING,
+    }, guard(({ postId, scheduledAtLocal }) => client.post(`/posts/${path(postId)}/schedule`, { scheduledAtLocal })));
+    server.registerTool("set_stage", {
+        title: "Mover no fluxo",
+        description: "Move o card no fluxo editorial (Kanban). Mover para READY dispara a " +
+            "publicação real e exige token com permissão de publicar; se ela faltar, " +
+            "pare em APPROVED_STAGE e avise que a liberação é humana.",
+        inputSchema: z.object({
+            postId: z.string().min(1),
+            stage: z.enum(STAGES),
+        }),
+        // READY publica de verdade, num perfil público e sem desfazer: o cliente
+        // deve tratar esta chamada como irreversível, não auto-aprovar.
+        annotations: DESTRUCTIVE,
+    }, guard(({ postId, stage }) => client.post(`/posts/${path(postId)}/stage`, { stage })));
+    server.registerTool("set_status", {
+        title: "Mover no ciclo de publicação",
+        description: "Move o post no ciclo de publicação. SCHEDULED enfileira a publicação de " +
+            "verdade e exige permissão de publicar. PUBLISHED e FAILED não são " +
+            "definíveis aqui: quem os escreve é o motor de publicação.",
+        inputSchema: z.object({
+            postId: z.string().min(1),
+            status: z.enum(SETTABLE_STATUSES),
+            note: z.string().max(2000).optional().describe("Obrigatório ao reprovar."),
+        }),
+        annotations: DESTRUCTIVE,
+    }, guard(({ postId, ...body }) => client.post(`/posts/${path(postId)}/status`, body)));
+    server.registerTool("comment_on_post", {
+        title: "Comentar no post",
+        description: "Deixa um comentário interno no post — visível à equipe na interface. " +
+            "Não é o comentário publicado na rede social.",
+        inputSchema: z.object({
+            postId: z.string().min(1),
+            body: z.string().min(1).max(2000),
+        }),
+        annotations: MUTATING,
+    }, guard(({ postId, body }) => client.post(`/posts/${path(postId)}/comments`, { body })));
+    server.registerTool("delete_post", {
+        title: "Excluir post",
+        description: "Exclui um post e tudo nele: legenda, briefing, roteiro, comentários e " +
+            "histórico. Não afeta a mídia na biblioteca, e posts já publicados não " +
+            "podem ser excluídos. Confirme com a pessoa antes de usar.",
+        inputSchema: z.object({ postId: z.string().min(1) }),
+        annotations: DESTRUCTIVE,
+    }, guard(({ postId }) => client.delete(`/posts/${path(postId)}`)));
+}
+//# sourceMappingURL=authoring.js.map

package/dist/tools/authoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.js","sourceRoot":"","sources":["../../src/tools/authoring.ts"],"names":[],"mappings":"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"}

package/dist/tools/context.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+import type { CreativePlannClient } from "../client.js";
+/** Descoberta: onde posso atuar, com quais contas e sob quais limites. */
+export declare function registerContextTools(server: McpServer, client: CreativePlannClient): void;

package/dist/tools/context.js

@@ -0,0 +1,71 @@
+import * as z from "zod/v4";
+import { COMPANY_ARG, guard, MUTATING, path, READ_ONLY } from "../shared.js";
+/** Descoberta: onde posso atuar, com quais contas e sob quais limites. */
+export function registerContextTools(server, client) {
+    server.registerTool("whoami", {
+        title: "Quem sou eu",
+        description: "Primeira chamada de qualquer sessão: mostra a organização, as empresas " +
+            "que este token alcança e o que ele pode fazer (inclusive se pode publicar).",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, guard(() => client.get("/me")));
+    server.registerTool("list_companies", {
+        title: "Listar empresas",
+        description: "Empresas da organização, com fuso horário, contas conectadas e total de posts.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, guard(() => client.get("/companies")));
+    server.registerTool("list_accounts", {
+        title: "Listar contas conectadas",
+        description: "Contas conectadas de uma empresa e, para cada uma, os formatos aceitos " +
+            "com limite de texto e de mídia. Consulte antes de criar um post: enviar " +
+            "um formato que a rede não aceita falha na validação.",
+        inputSchema: z.object({ company: COMPANY_ARG }),
+        annotations: READ_ONLY,
+    }, guard(({ company }) => client.get(`/companies/${path(company)}/accounts`)));
+    server.registerTool("describe_vocabulary", {
+        title: "Vocabulário da ferramenta",
+        description: "Catálogo da ferramenta: formatos e seus limites, estágios do fluxo, " +
+            "status de publicação, objetivos e pilares de conteúdo. Use para saber " +
+            "quais valores são aceitos, em vez de descobrir por tentativa e erro.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, guard(() => client.get("/formats")));
+    server.registerTool("list_members", {
+        title: "Listar membros",
+        description: "Membros da organização — necessário para atribuir responsável (assigneeId) a um post.",
+        inputSchema: z.object({ company: COMPANY_ARG }),
+        annotations: READ_ONLY,
+    }, guard(({ company }) => client.get(`/companies/${path(company)}/members`)));
+    server.registerTool("list_media", {
+        title: "Listar mídia",
+        description: "Biblioteca de mídia da empresa. Use o `id` retornado como `mediaAssetId` " +
+            "ao criar um post. Não é possível enviar arquivo novo por aqui: o upload " +
+            "é feito na interface.",
+        inputSchema: z.object({
+            company: COMPANY_ARG,
+            type: z.enum(["IMAGE", "VIDEO"]).optional(),
+            limit: z.number().int().min(1).max(100).optional(),
+            cursor: z.string().optional().describe("Cursor devolvido pela página anterior."),
+        }),
+        annotations: READ_ONLY,
+    }, guard(({ company, ...query }) => client.get(`/companies/${path(company)}/media`, query)));
+    server.registerTool("list_campaigns", {
+        title: "Listar campanhas",
+        description: "Campanhas da empresa, para agrupar posts sob uma mesma ação.",
+        inputSchema: z.object({ company: COMPANY_ARG }),
+        annotations: READ_ONLY,
+    }, guard(({ company }) => client.get(`/companies/${path(company)}/campaigns`)));
+    server.registerTool("create_campaign", {
+        title: "Criar campanha",
+        description: "Cria uma campanha na empresa.",
+        inputSchema: z.object({
+            company: COMPANY_ARG,
+            name: z.string().min(1).max(120),
+            startsAt: z.string().optional().describe("Data ISO de início."),
+            endsAt: z.string().optional().describe("Data ISO de término."),
+        }),
+        annotations: MUTATING,
+    }, guard(({ company, ...body }) => client.post(`/companies/${path(company)}/campaigns`, body)));
+}
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+import type { CreativePlannClient } from "../client.js";
+/**
+ * Ferramentas agrupadas por domínio: descobrir onde atuar, ver o trabalho,
+ * alterá-lo. Separar por arquivo mantém cada módulo legível conforme a API
+ * cresce, e deixa claro onde entra uma ferramenta nova.
+ */
+export declare function registerTools(server: McpServer, client: CreativePlannClient): void;

package/dist/tools/index.js

@@ -0,0 +1,14 @@
+import { registerContextTools } from "./context.js";
+import { registerPlanningTools } from "./planning.js";
+import { registerAuthoringTools } from "./authoring.js";
+/**
+ * Ferramentas agrupadas por domínio: descobrir onde atuar, ver o trabalho,
+ * alterá-lo. Separar por arquivo mantém cada módulo legível conforme a API
+ * cresce, e deixa claro onde entra uma ferramenta nova.
+ */
+export function registerTools(server, client) {
+    registerContextTools(server, client);
+    registerPlanningTools(server, client);
+    registerAuthoringTools(server, client);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,MAA2B;IAC1E,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/tools/planning.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+import type { CreativePlannClient } from "../client.js";
+/** Visão do trabalho: o que está agendado, parado ou atrasado. */
+export declare function registerPlanningTools(server: McpServer, client: CreativePlannClient): void;

package/dist/tools/planning.js

@@ -0,0 +1,61 @@
+import * as z from "zod/v4";
+import { ALL_STATUSES, COMPANY_ARG, guard, path, READ_ONLY, STAGES } from "../shared.js";
+/** Visão do trabalho: o que está agendado, parado ou atrasado. */
+export function registerPlanningTools(server, client) {
+    server.registerTool("get_board", {
+        title: "Ver o fluxo (Kanban)",
+        description: "O Kanban da empresa: colunas na ordem do fluxo com os cards de cada uma. " +
+            "Inclui colunas vazias, para você saber para onde é possível mover.",
+        inputSchema: z.object({ company: COMPANY_ARG }),
+        annotations: READ_ONLY,
+    }, guard(({ company }) => client.get(`/companies/${path(company)}/board`)));
+    server.registerTool("get_calendar", {
+        title: "Ver o calendário",
+        description: "Agenda de uma janela de datas, mais o que precisa de atenção: posts sem " +
+            "data marcada e posts com prazo interno vencido.",
+        inputSchema: z.object({
+            company: COMPANY_ARG,
+            from: z
+                .string()
+                .regex(/^\d{4}-\d{2}-\d{2}$/)
+                .describe("Início, YYYY-MM-DD (data local da empresa)."),
+            to: z
+                .string()
+                .regex(/^\d{4}-\d{2}-\d{2}$/)
+                .describe("Fim, YYYY-MM-DD (inclusive)."),
+        }),
+        annotations: READ_ONLY,
+    }, guard(({ company, ...query }) => client.get(`/companies/${path(company)}/calendar`, query)));
+    server.registerTool("list_posts", {
+        title: "Buscar posts",
+        description: "Busca posts com filtros. Use `unscheduled: true` para achar o que ainda " +
+            "não tem data, ou `stage`/`status` para ver o que está travado numa etapa.",
+        inputSchema: z.object({
+            company: COMPANY_ARG.optional().describe("Sem isto, busca em todas as empresas do token."),
+            stage: z.enum(STAGES).optional(),
+            status: z.enum(ALL_STATUSES).optional(),
+            from: z.string().optional().describe("Agendados a partir de YYYY-MM-DD."),
+            to: z.string().optional().describe("Agendados até YYYY-MM-DD."),
+            unscheduled: z.enum(["true", "false"]).optional(),
+            search: z.string().optional().describe("Texto no título ou na legenda."),
+            limit: z.number().int().min(1).max(100).optional(),
+            cursor: z.string().optional(),
+        }),
+        annotations: READ_ONLY,
+    }, guard((query) => client.get("/posts", query)));
+    server.registerTool("get_post", {
+        title: "Ver um post",
+        description: "Post completo: briefing, roteiro, mídia, destinos por rede e resultado " +
+            "de cada publicação (permalink ou erro).",
+        inputSchema: z.object({ postId: z.string().min(1) }),
+        annotations: READ_ONLY,
+    }, guard(({ postId }) => client.get(`/posts/${path(postId)}`)));
+    server.registerTool("get_post_history", {
+        title: "Ver histórico do post",
+        description: "Comentários e histórico do post: movimentações de etapa e eventos de " +
+            "aprovação, em ordem. Útil para entender por que um post está parado.",
+        inputSchema: z.object({ postId: z.string().min(1) }),
+        annotations: READ_ONLY,
+    }, guard(({ postId }) => client.get(`/posts/${path(postId)}/comments`)));
+}
+//# sourceMappingURL=planning.js.map

package/dist/tools/planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.js","sourceRoot":"","sources":["../../src/tools/planning.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEzF,kEAAkE;AAClE,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAA2B;IAClF,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,2EAA2E;YAC3E,oEAAoE;QACtE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QAC/C,WAAW,EAAE,SAAS;KACvB,EACD,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CACxE,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,0EAA0E;YAC1E,iDAAiD;QACnD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,WAAW;YACpB,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,KAAK,CAAC,qBAAqB,CAAC;iBAC5B,QAAQ,CAAC,6CAA6C,CAAC;YAC1D,EAAE,EAAE,CAAC;iBACF,MAAM,EAAE;iBACR,KAAK,CAAC,qBAAqB,CAAC;iBAC5B,QAAQ,CAAC,8BAA8B,CAAC;SAC5C,CAAC;QACF,WAAW,EAAE,SAAS;KACvB,EACD,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAC5F,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,0EAA0E;YAC1E,2EAA2E;QAC7E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACtC,gDAAgD,CACjD;YACD,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;YAChC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE;YACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACzE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YAC/D,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;YACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YACxE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;YAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC9B,CAAC;QACF,WAAW,EAAE,SAAS;KACvB,EACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAC9C,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,UAAU,EACV;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,yEAAyE;YACzE,yCAAyC;QAC3C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,WAAW,EAAE,SAAS;KACvB,EACD,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAC5D,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,uEAAuE;YACvE,sEAAsE;QACxE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,WAAW,EAAE,SAAS;KACvB,EACD,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CACrE,CAAC;AACJ,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION: string;

package/dist/version.js

@@ -0,0 +1,10 @@
+import { createRequire } from "node:module";
+/**
+ * Versão lida do package.json, não duplicada aqui: duas fontes divergem na
+ * primeira release, e é justamente esta versão que o cliente MCP mostra no
+ * diagnóstico de problema.
+ */
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+export const VERSION = pkg.version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;GAIG;AACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@creativeproject/creative-plann-mcp",
+  "version": "0.1.0",
+  "description": "Servidor MCP do Creative Plann — permite que uma IA planeje, escreva e organize posts nas redes sociais das empresas da sua organização.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "creative-plann-mcp": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "social-media",
+    "instagram",
+    "scheduling",
+    "creative-plann"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc && chmod +x dist/cli.js",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.test.json"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/server": "^2.0.0",
+    "zod": "^4.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.0"
+  },
+  "author": "Creative Project",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/creativeproject/creative-plann-web.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/creativeproject/creative-plann-web/tree/main/packages/mcp#readme",
+  "bugs": "https://github.com/creativeproject/creative-plann-web/issues",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  }
+}