@kezlahd/atlas-mcp 0.1.0

package/README.md

@@ -0,0 +1,77 @@
+# @kezlahd/atlas-mcp
+
+MCP server that lets Claude Code (and other MCP-aware AI agents) edit Atlas doc templates, files, and gear directly. Sibling of `@kezlahd/atlas-cli` – same auth (Bearer token), same endpoints, same optimistic-concurrency safety (get-then-put with etag).
+
+## Setup in Claude Code
+
+1. Mint a token: [Atlas](https://atlas.mjsons.net) → workspace → Settings → API keys → Mint token. Copy the plaintext.
+2. Add the server to your Claude Code MCP config (usually `~/.claude/config.json` or `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "atlas": {
+      "command": "npx",
+      "args": ["-y", "@kezlahd/atlas-mcp"],
+      "env": {
+        "ATLAS_TOKEN": "atlas_pat_…",
+        "ATLAS_WORKSPACE": "acme-inc"
+      }
+    }
+  }
+}
+```
+
+3. Restart Claude Code. You should see the `atlas` server connect on stderr.
+
+For dev – run out of the workspace instead:
+
+```json
+{
+  "mcpServers": {
+    "atlas": {
+      "command": "pnpm",
+      "args": ["--filter", "@kezlahd/atlas-mcp", "dev"],
+      "cwd": "/path/to/the-studio",
+      "env": {
+        "ATLAS_TOKEN": "atlas_pat_…",
+        "ATLAS_WORKSPACE": "acme-inc"
+      }
+    }
+  }
+}
+```
+
+## Tools exposed
+
+| Tool | Purpose | Scope |
+|---|---|---|
+| `atlas_list_docs` | List docs in the workspace | `templates:list` |
+| `atlas_get_template` | Fetch full template content (returns etag) | `templates:get` |
+| `atlas_list_sections` | Summarise section ids + types + titles (cheap) | `templates:get` |
+| `atlas_describe_section_type` | Look up what fields a section type takes | none |
+| `atlas_update_section` | Edit one section by id – safe, scoped, auto-etag | `templates:update` |
+| `atlas_update_template` | Replace the whole template – for restructuring | `templates:update` |
+| `atlas_list_revisions` | List revision history for a template | `templates:list-revisions` |
+| `atlas_restore_revision` | Restore a template to an earlier revision | `templates:restore-revision` |
+| `atlas_list_files` | List workspace files with signed URLs | `files:list` |
+| `atlas_get_file_url` | Fetch a signed URL for a single file | `files:list` |
+| `atlas_upload_file` | Upload a local file to workspace storage | `files:upload` |
+| `atlas_rename_file` | Rename a workspace file | `files:rename` |
+| `atlas_set_file_alt` | Update the alt-text metadata for a file | `files:edit-alt` |
+| `atlas_delete_file` | Delete a workspace file | `files:delete` |
+| `atlas_list_gear` | List gear items in the workspace | `gear:list` |
+| `atlas_add_gear` | Add a new gear item | `gear:add` |
+| `atlas_update_gear` | Patch an existing gear item | `gear:update` |
+| `atlas_delete_gear` | Delete a gear item | `gear:delete` |
+| `atlas_import_gear` | Bulk import gear from CSV | `gear:import` |
+
+Every template write is journaled to `doc_template_revisions` server-side, so any bad push from a chat can be reverted from the UI.
+
+## The pattern to teach Claude
+
+> Pull `atlas_list_sections` first (cheap), then `atlas_describe_section_type` for the section you're editing, then `atlas_update_section` with the correct shape. Only reach for `atlas_update_template` when you're restructuring the doc.
+
+## License
+
+MIT

package/dist/api.js

@@ -0,0 +1,70 @@
+/**
+ * HTTP client shared by every MCP tool. Same shape as the CLI's api.ts —
+ * couldn't reuse it directly because the CLI reads config from disk +
+ * env; MCP reads from env only (Claude Code's MCP config passes ATLAS_*).
+ */
+const DEFAULT_API_URL = "https://atlas.mjsons.net";
+export function resolveConfig() {
+    const token = process.env.ATLAS_TOKEN;
+    const workspace = process.env.ATLAS_WORKSPACE;
+    const apiUrl = (process.env.ATLAS_API_URL ?? DEFAULT_API_URL).replace(/\/$/, "");
+    if (!token) {
+        throw new Error("ATLAS_TOKEN env var is required. Add it to your MCP server config in Claude Code (see the atlas-mcp README).");
+    }
+    if (!workspace) {
+        throw new Error("ATLAS_WORKSPACE env var is required (workspace slug — lowercase alnum + dashes).");
+    }
+    return { apiUrl, token, workspace };
+}
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(status, body, message) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = "ApiError";
+    }
+}
+export async function apiRequest(cfg, path, opts = {}) {
+    const url = new URL(path, cfg.apiUrl);
+    if (opts.query) {
+        for (const [k, v] of Object.entries(opts.query)) {
+            if (v !== undefined)
+                url.searchParams.set(k, String(v));
+        }
+    }
+    const headers = {
+        Authorization: `Bearer ${cfg.token}`,
+        Accept: "application/json",
+    };
+    if (opts.body !== undefined)
+        headers["Content-Type"] = "application/json";
+    if (opts.ifMatch)
+        headers["If-Match"] = opts.ifMatch;
+    const res = await fetch(url, {
+        method: opts.method ?? "GET",
+        headers,
+        body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,
+    });
+    const text = await res.text();
+    const body = text ? safeJson(text) : null;
+    if (!res.ok) {
+        const message = (isRecord(body) && typeof body.error === "string" && body.error) ||
+            `HTTP ${res.status}`;
+        throw new ApiError(res.status, body, message);
+    }
+    return { data: body, etag: res.headers.get("etag") };
+}
+function safeJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function isRecord(v) {
+    return typeof v === "object" && v !== null;
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/index.js

@@ -0,0 +1,685 @@
+#!/usr/bin/env node
+/**
+ * Atlas MCP server.
+ *
+ * Exposes doc-template read/write tools to Claude Code (or any MCP client)
+ * via stdio. Uses the exact same /api/v1 endpoints the CLI + web settings
+ * page use — one source of truth for auth, rate limiting, revisions.
+ *
+ * Config: env only (Claude Code's MCP config passes these as `env`):
+ *   ATLAS_TOKEN     — Bearer token from workspace → Settings → API keys
+ *   ATLAS_WORKSPACE — workspace slug
+ *   ATLAS_API_URL   — optional override, default https://atlas.mjsons.net
+ *
+ * All writes use get-then-put with the fresh etag, so a concurrent
+ * autosave from the web editor can't be silently overwritten — a 409
+ * bubbles up to Claude as a tool error and the model can re-fetch.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { apiRequest, ApiError, resolveConfig } from "./api.js";
+import { SECTION_CATALOG, findSection } from "./section-catalog.js";
+/* ─── Tool definitions ─────────────────────────────────────────────── */
+const TOOLS = [
+    {
+        name: "atlas_list_docs",
+        description: "List docs in the current Atlas workspace. Returns { docs, next_cursor }. Use this to find a docId before pulling a template. To page through more, pass the previous next_cursor back in as `cursor`.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                kind: {
+                    type: "string",
+                    enum: ["template", "freeform"],
+                    description: "Optional filter — templates are the doc-crafter kind.",
+                },
+                limit: { type: "number", description: "Max results (default 50, max 500)." },
+                cursor: {
+                    type: "string",
+                    description: "Opaque next_cursor from a previous response. Omit for the first page.",
+                },
+            },
+        },
+    },
+    {
+        name: "atlas_get_template",
+        description: "Fetch a doc template's full content (cover + sections). Returns { id, title, template_content, etag }. Use this before editing so you can pass sections to atlas_update_section.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                docId: { type: "string", description: "Doc id from atlas_list_docs." },
+            },
+            required: ["docId"],
+        },
+    },
+    {
+        name: "atlas_list_sections",
+        description: "Summarise the sections in a doc without pulling the full data payloads. Returns [{ id, type, title }]. Cheaper than atlas_get_template when you only need to know what's in the doc.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                docId: { type: "string" },
+            },
+            required: ["docId"],
+        },
+    },
+    {
+        name: "atlas_update_section",
+        description: "Edit a single section by id. Fetches current template, splices in the new section.data (and optionally style), writes back with the fresh etag. Safer than atlas_update_template for scoped edits — won't touch other sections.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                docId: { type: "string" },
+                sectionId: { type: "string", description: "Section id to update." },
+                data: {
+                    type: "object",
+                    description: "New section.data payload — replaces the existing data object entirely. Use atlas_describe_section_type first to learn the shape.",
+                },
+                style: {
+                    type: "object",
+                    description: "Optional section.style overrides (titleFont, titleSize, breakBefore, etc). Merged into existing style.",
+                },
+            },
+            required: ["docId", "sectionId", "data"],
+        },
+    },
+    {
+        name: "atlas_update_template",
+        description: "Replace a doc's full template_content (cover + sections). Use this for large restructuring — reordering sections, replacing the cover, batch edits. For a single-section change, prefer atlas_update_section. Uses get-then-put with etag so it won't silently overwrite concurrent web edits.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                docId: { type: "string" },
+                template_content: {
+                    type: "object",
+                    description: "Full { cover?, docSettings?, sections: [] } payload. Preserve section ids unless you're intentionally deleting/inserting.",
+                },
+                title: { type: "string", description: "Optional — rename the doc at the same time." },
+            },
+            required: ["docId", "template_content"],
+        },
+    },
+    {
+        name: "atlas_describe_section_type",
+        description: "Look up what fields a section type takes. Use this before atlas_update_section so you send the right shape. If called with no `type`, returns the full catalogue of known section types.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                type: {
+                    type: "string",
+                    description: "e.g. 'moodboard', 'gear', 'text'. Omit to list all types.",
+                },
+            },
+        },
+    },
+    {
+        name: "atlas_list_files",
+        description: "List files in the workspace-photos bucket (images, PDFs, videos). Returns { files, next_cursor } with storage paths + 1-hour signed URLs + alt text. To page through more, pass the previous next_cursor back in as `cursor`.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                folder_id: { type: "string", description: "Optional folder id to filter by." },
+                limit: { type: "number", description: "Max rows (default 50, max 500)." },
+                cursor: {
+                    type: "string",
+                    description: "Opaque next_cursor from a previous response. Omit for the first page.",
+                },
+            },
+        },
+    },
+    {
+        name: "atlas_upload_file",
+        description: "Upload a local file (path on the user's machine) to the workspace bucket. Three-step signed-URL flow. Returns the storage path + a 1-hour signed URL. Extension whitelist enforced (images/video/audio/pdf/txt/md/json/csv); executables/archives refused.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                local_path: {
+                    type: "string",
+                    description: "Absolute or CWD-relative path to a file on the machine running this MCP server.",
+                },
+                alt: { type: "string", description: "Alt text (≤ 300 chars)." },
+            },
+            required: ["local_path"],
+        },
+    },
+    {
+        name: "atlas_get_file_url",
+        description: "Return the 1-hour signed URL for one file by its storage path. Use this before dropping a URL into a gear row or moodboard tile.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Full storage key returned by atlas_list_files or atlas_upload_file." },
+            },
+            required: ["path"],
+        },
+    },
+    {
+        name: "atlas_set_file_alt",
+        description: "Update the alt text on a file. Pass null (or empty string) to clear.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string" },
+                alt: { type: "string", description: "New alt text. Empty string or omit to clear." },
+            },
+            required: ["path"],
+        },
+    },
+    {
+        name: "atlas_delete_file",
+        description: "Delete a file from the workspace bucket AND its metadata row. Destructive – no soft-delete.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string" },
+            },
+            required: ["path"],
+        },
+    },
+    {
+        name: "atlas_list_gear",
+        description: "List gear items (brand, name, quantity, photo) in the workspace. Returns { items, next_cursor }. Each item has a 1-hour signed image_url when it has an image. To page through more, pass the previous next_cursor back in as `cursor`.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: { type: "number", description: "Default 50, max 500." },
+                cursor: {
+                    type: "string",
+                    description: "Opaque next_cursor from a previous response. Omit for the first page.",
+                },
+            },
+        },
+    },
+    {
+        name: "atlas_add_gear",
+        description: "Add a single gear item. For many items at once, use atlas_import_gear.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Required. ≤ 160 chars." },
+                brand: { type: "string", description: "Optional. ≤ 80 chars." },
+                quantity: { type: "number", description: "Default 1, max 99999." },
+                image_path: {
+                    type: "string",
+                    description: "Optional. Storage key from atlas_upload_file. Must be in this workspace's prefix.",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "atlas_import_gear",
+        description: "Bulk-import gear rows in one shot. Faster than calling atlas_add_gear per item. `mode: 'replace'` clears the workspace's gear before inserting; `'append'` (default) adds on top.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                mode: { type: "string", enum: ["append", "replace"] },
+                rows: {
+                    type: "array",
+                    description: "Up to 2000 rows. Each: { name (required), brand?, quantity?, image_path? }.",
+                    items: {
+                        type: "object",
+                        properties: {
+                            name: { type: "string" },
+                            brand: { type: "string" },
+                            quantity: { type: "number" },
+                            image_path: { type: "string" },
+                        },
+                        required: ["name"],
+                    },
+                },
+            },
+            required: ["rows"],
+        },
+    },
+    {
+        name: "atlas_delete_gear",
+        description: "Delete a gear item by id.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                gearId: { type: "string" },
+            },
+            required: ["gearId"],
+        },
+    },
+    {
+        name: "atlas_update_gear",
+        description: "Update an existing gear item. Requires gear:update. Only provided fields are patched — send just the fields you want to change (name, brand, quantity, image_path).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                gearId: { type: "string", description: "Gear item id from atlas_list_gear." },
+                name: { type: "string", description: "New item name (≤ 160 chars)." },
+                brand: { type: "string", description: "New brand (≤ 80 chars). Empty string clears." },
+                quantity: { type: "number", description: "New quantity (0–99999)." },
+                image_path: {
+                    type: "string",
+                    description: "Storage path from atlas_upload_file. Must live in this workspace's prefix. Empty string clears the image.",
+                },
+            },
+            required: ["gearId"],
+        },
+    },
+    {
+        name: "atlas_rename_file",
+        description: "Rename a workspace file. Requires files:rename. Pass just the new filename — the workspace prefix + folder are preserved. Extension changes are refused server-side.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Full storage key returned by atlas_list_files." },
+                new_name: { type: "string", description: "New filename only, no folder path. Keep the same extension." },
+            },
+            required: ["path", "new_name"],
+        },
+    },
+    {
+        name: "atlas_list_revisions",
+        description: "List revision history for a doc template. Requires templates:list-revisions. Returns revisions newest first with id, source (ui/api/cli), author, based_on_updated_at, created_at.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                docId: { type: "string", description: "Doc id from atlas_list_docs." },
+                limit: { type: "number", description: "Max rows (default 50, max 200)." },
+            },
+            required: ["docId"],
+        },
+    },
+    {
+        name: "atlas_restore_revision",
+        description: "Restore a doc template to an earlier revision. Requires templates:restore-revision. Overwrites the current template_content. The pre-restore state is journaled first so the restore is itself reversible.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                docId: { type: "string", description: "Doc id from atlas_list_docs." },
+                revisionId: { type: "string", description: "Revision id from atlas_list_revisions." },
+            },
+            required: ["docId", "revisionId"],
+        },
+    },
+];
+/* ─── Server setup ─────────────────────────────────────────────────── */
+const server = new Server({ name: "atlas-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: TOOLS,
+}));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const name = req.params.name;
+    const args = (req.params.arguments ?? {});
+    try {
+        const result = await dispatch(name, args);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return {
+            isError: true,
+            content: [{ type: "text", text: `error: ${msg}` }],
+        };
+    }
+});
+async function dispatch(name, args) {
+    switch (name) {
+        case "atlas_list_docs":
+            return listDocs(args);
+        case "atlas_get_template":
+            return getTemplate(args);
+        case "atlas_list_sections":
+            return listSections(args);
+        case "atlas_update_section":
+            return updateSection(args);
+        case "atlas_list_files":
+            return listFiles(args);
+        case "atlas_upload_file":
+            return uploadFile(args);
+        case "atlas_get_file_url":
+            return getFileUrl(args);
+        case "atlas_set_file_alt":
+            return setFileAlt(args);
+        case "atlas_delete_file":
+            return deleteFile(args);
+        case "atlas_list_gear":
+            return listGear(args);
+        case "atlas_add_gear":
+            return addGear(args);
+        case "atlas_import_gear":
+            return importGear(args);
+        case "atlas_delete_gear":
+            return deleteGear(args);
+        case "atlas_update_template":
+            return updateTemplate(args);
+        case "atlas_describe_section_type":
+            return describeSectionType(args);
+        case "atlas_update_gear":
+            return updateGear(args);
+        case "atlas_rename_file":
+            return renameFile(args);
+        case "atlas_list_revisions":
+            return listRevisions(args);
+        case "atlas_restore_revision":
+            return restoreRevision(args);
+        default:
+            throw new Error(`Unknown tool: ${name}`);
+    }
+}
+/* ─── Tool implementations ─────────────────────────────────────────── */
+async function listDocs(args) {
+    const cfg = resolveConfig();
+    const query = {};
+    if (typeof args.kind === "string")
+        query.kind = args.kind;
+    if (typeof args.limit === "number")
+        query.limit = args.limit;
+    if (typeof args.cursor === "string")
+        query.cursor = args.cursor;
+    const { data } = await apiRequest(cfg, "/api/v1/docs", { query });
+    return data;
+}
+async function getTemplate(args) {
+    const cfg = resolveConfig();
+    const docId = requireString(args, "docId");
+    const { data } = await apiRequest(cfg, `/api/v1/docs/${docId}/template`);
+    return data;
+}
+async function listSections(args) {
+    const tpl = await getTemplate(args);
+    const sections = tpl.template_content?.sections ?? [];
+    const summary = sections.map((s) => ({
+        id: s.id,
+        type: s.type,
+        // Best-effort title extraction — most sections stash a title on data.title.
+        title: (s.data && typeof s.data.title === "string"
+            ? s.data.title
+            : null) ?? "",
+        hidden: !!s.hidden,
+    }));
+    return { docId: tpl.id, title: tpl.title, section_count: summary.length, sections: summary };
+}
+async function updateSection(args) {
+    const cfg = resolveConfig();
+    const docId = requireString(args, "docId");
+    const sectionId = requireString(args, "sectionId");
+    const newData = args.data;
+    if (!isRecord(newData))
+        throw new Error("`data` must be an object.");
+    const newStyle = isRecord(args.style) ? args.style : null;
+    const current = await getTemplate({ docId });
+    const template = current.template_content;
+    const sections = template.sections ?? [];
+    const idx = sections.findIndex((s) => s.id === sectionId);
+    if (idx === -1) {
+        throw new Error(`Section '${sectionId}' not found in doc '${docId}'. Call atlas_list_sections to see current section ids.`);
+    }
+    const patched = { ...sections[idx], data: newData };
+    if (newStyle) {
+        patched.style = { ...(sections[idx].style ?? {}), ...newStyle };
+    }
+    const nextSections = [...sections];
+    nextSections[idx] = patched;
+    const { data } = await apiRequest(cfg, `/api/v1/docs/${docId}/template`, {
+        method: "PUT",
+        body: { template_content: { ...template, sections: nextSections } },
+        ifMatch: current.etag,
+    });
+    return {
+        updated_section: sectionId,
+        etag: data.etag,
+        updated_at: data.updated_at,
+    };
+}
+async function updateTemplate(args) {
+    const cfg = resolveConfig();
+    const docId = requireString(args, "docId");
+    const templateContent = args.template_content;
+    if (!isRecord(templateContent)) {
+        throw new Error("`template_content` must be an object matching TemplateContent shape.");
+    }
+    const title = typeof args.title === "string" ? args.title : undefined;
+    // Get-then-put for etag freshness.
+    const current = await getTemplate({ docId });
+    try {
+        const { data } = await apiRequest(cfg, `/api/v1/docs/${docId}/template`, {
+            method: "PUT",
+            body: { template_content: templateContent, ...(title ? { title } : {}) },
+            ifMatch: current.etag,
+        });
+        return {
+            docId: data.id,
+            title: data.title,
+            etag: data.etag,
+            updated_at: data.updated_at,
+        };
+    }
+    catch (e) {
+        if (e instanceof ApiError && e.status === 409) {
+            throw new Error("Doc was modified since we fetched it — re-run atlas_get_template to pick up the concurrent change, then retry.");
+        }
+        throw e;
+    }
+}
+async function describeSectionType(args) {
+    const type = args.type;
+    if (typeof type === "string") {
+        const entry = findSection(type);
+        if (!entry) {
+            throw new Error(`Unknown section type '${type}'. Known types: ${SECTION_CATALOG.map((s) => s.type).join(", ")}.`);
+        }
+        return entry;
+    }
+    return { types: SECTION_CATALOG };
+}
+/* ─── Files tools ──────────────────────────────────────────────────── */
+async function listFiles(args) {
+    const cfg = resolveConfig();
+    const query = {};
+    if (typeof args.folder_id === "string")
+        query.folder_id = args.folder_id;
+    if (typeof args.limit === "number")
+        query.limit = args.limit;
+    if (typeof args.cursor === "string")
+        query.cursor = args.cursor;
+    const { data } = await apiRequest(cfg, "/api/v1/files", { query });
+    return data;
+}
+async function uploadFile(args) {
+    const cfg = resolveConfig();
+    const localPath = requireString(args, "local_path");
+    const alt = typeof args.alt === "string" ? args.alt : undefined;
+    const { readFile, stat } = await import("node:fs/promises");
+    const { basename, extname } = await import("node:path");
+    const info = await stat(localPath);
+    if (!info.isFile())
+        throw new Error(`Not a file: ${localPath}`);
+    const filename = basename(localPath);
+    const ext = extname(filename).toLowerCase();
+    const contentTypes = {
+        ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg",
+        ".gif": "image/gif", ".webp": "image/webp", ".svg": "image/svg+xml",
+        ".mp4": "video/mp4", ".mov": "video/quicktime", ".pdf": "application/pdf",
+        ".txt": "text/plain", ".md": "text/markdown", ".json": "application/json",
+        ".csv": "text/csv",
+    };
+    const contentType = contentTypes[ext] ?? "application/octet-stream";
+    // Step 1: signed URL
+    const { data: signRes } = await apiRequest(cfg, "/api/v1/files/upload-url", {
+        method: "POST",
+        body: { filename },
+    });
+    // Step 2: PUT bytes
+    const bytes = await readFile(localPath);
+    const putRes = await fetch(signRes.upload_url, {
+        method: "PUT",
+        headers: { "Content-Type": contentType, "x-upsert": "false" },
+        body: bytes,
+    });
+    if (!putRes.ok) {
+        const text = await putRes.text().catch(() => "");
+        throw new Error(`Storage upload failed (HTTP ${putRes.status}): ${text.slice(0, 200)}`);
+    }
+    // Step 3: register metadata
+    const { data: reg } = await apiRequest(cfg, "/api/v1/files", {
+        method: "POST",
+        body: { path: signRes.path, alt },
+    });
+    return {
+        path: signRes.path,
+        size: info.size,
+        content_type: contentType,
+        metadata: reg.file,
+    };
+}
+async function getFileUrl(args) {
+    const cfg = resolveConfig();
+    const path = requireString(args, "path");
+    const { data } = await apiRequest(cfg, "/api/v1/files", { query: { limit: 500 } });
+    const match = data.files.find((f) => f.path === path);
+    if (!match)
+        throw new Error(`File not found or no metadata row: ${path}`);
+    return { path: match.path, url: match.signed_url, alt: match.alt };
+}
+async function setFileAlt(args) {
+    const cfg = resolveConfig();
+    const path = requireString(args, "path");
+    const alt = typeof args.alt === "string" ? args.alt : null;
+    const { data } = await apiRequest(cfg, "/api/v1/files/alt", {
+        method: "POST",
+        body: { path, alt },
+    });
+    return data;
+}
+async function deleteFile(args) {
+    const cfg = resolveConfig();
+    const path = requireString(args, "path");
+    const { data } = await apiRequest(cfg, "/api/v1/files", {
+        method: "DELETE",
+        query: { path },
+    });
+    return data;
+}
+/* ─── Gear tools ───────────────────────────────────────────────────── */
+async function listGear(args) {
+    const cfg = resolveConfig();
+    const query = {};
+    if (typeof args.limit === "number")
+        query.limit = args.limit;
+    if (typeof args.cursor === "string")
+        query.cursor = args.cursor;
+    const { data } = await apiRequest(cfg, "/api/v1/gear", { query });
+    return data;
+}
+async function addGear(args) {
+    const cfg = resolveConfig();
+    const body = { name: requireString(args, "name") };
+    if (typeof args.brand === "string")
+        body.brand = args.brand;
+    if (typeof args.quantity === "number")
+        body.quantity = args.quantity;
+    if (typeof args.image_path === "string")
+        body.image_path = args.image_path;
+    const { data } = await apiRequest(cfg, "/api/v1/gear", {
+        method: "POST",
+        body,
+    });
+    return data;
+}
+async function importGear(args) {
+    const cfg = resolveConfig();
+    const rows = args.rows;
+    if (!Array.isArray(rows))
+        throw new Error("`rows` must be an array.");
+    const mode = args.mode === "replace" ? "replace" : "append";
+    const { data } = await apiRequest(cfg, "/api/v1/gear/import", {
+        method: "POST",
+        body: { mode, rows },
+    });
+    return data;
+}
+async function deleteGear(args) {
+    const cfg = resolveConfig();
+    const gearId = requireString(args, "gearId");
+    const { data } = await apiRequest(cfg, `/api/v1/gear/${gearId}`, {
+        method: "DELETE",
+    });
+    return data;
+}
+async function updateGear(args) {
+    const cfg = resolveConfig();
+    const gearId = requireString(args, "gearId");
+    const body = {};
+    if (typeof args.name === "string")
+        body.name = args.name;
+    if (typeof args.brand === "string")
+        body.brand = args.brand;
+    if (typeof args.quantity === "number")
+        body.quantity = args.quantity;
+    if (typeof args.image_path === "string")
+        body.image_path = args.image_path;
+    if (Object.keys(body).length === 0) {
+        throw new Error("At least one of name, brand, quantity, image_path is required.");
+    }
+    const { data } = await apiRequest(cfg, `/api/v1/gear/${gearId}`, {
+        method: "PUT",
+        body,
+    });
+    return data;
+}
+/* ─── Files rename ─────────────────────────────────────────────────── */
+async function renameFile(args) {
+    const cfg = resolveConfig();
+    const path = requireString(args, "path");
+    const newName = requireString(args, "new_name");
+    const { data } = await apiRequest(cfg, "/api/v1/files/rename", {
+        method: "POST",
+        body: { path, new_name: newName },
+    });
+    return data;
+}
+/* ─── Revisions ────────────────────────────────────────────────────── */
+async function listRevisions(args) {
+    const cfg = resolveConfig();
+    const docId = requireString(args, "docId");
+    const query = {};
+    if (typeof args.limit === "number")
+        query.limit = args.limit;
+    const { data } = await apiRequest(cfg, `/api/v1/docs/${docId}/revisions`, { query });
+    return data;
+}
+async function restoreRevision(args) {
+    const cfg = resolveConfig();
+    const docId = requireString(args, "docId");
+    const revisionId = requireString(args, "revisionId");
+    const { data } = await apiRequest(cfg, `/api/v1/docs/${docId}/revisions/${revisionId}/restore`, {
+        method: "POST",
+    });
+    return {
+        docId: data.id,
+        title: data.title,
+        updated_at: data.updated_at,
+        etag: data.etag,
+        restored_from: data.restored_from,
+    };
+}
+/* ─── Helpers ──────────────────────────────────────────────────────── */
+function requireString(args, key) {
+    const v = args[key];
+    if (typeof v !== "string" || !v)
+        throw new Error(`\`${key}\` is required.`);
+    return v;
+}
+function isRecord(v) {
+    return typeof v === "object" && v !== null;
+}
+/* ─── Boot ─────────────────────────────────────────────────────────── */
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // MCP: stderr is safe to log to; stdout is the framed protocol channel.
+    process.stderr.write("atlas-mcp: connected (stdio)\n");
+}
+main().catch((e) => {
+    process.stderr.write(`atlas-mcp: fatal: ${e instanceof Error ? e.message : String(e)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/section-catalog.js

@@ -0,0 +1,131 @@
+/**
+ * Human-readable catalogue of Atlas doc-section types. Powers the
+ * `describe_section_type` MCP tool so Claude can look up what fields a
+ * section takes before editing it. Keep in lockstep with the app's
+ * `SectionType` union in `lib/doc-types.ts` — if a new type is added
+ * there, add it here so agents don't fly blind.
+ *
+ * These descriptions are deliberately terse: the model is smart enough
+ * to reason about the shape; what it needs is a nudge on the field
+ * *names* and *ranges*, not a full API doc.
+ */
+export const SECTION_CATALOG = [
+    {
+        type: "cover",
+        purpose: "Full-bleed cover page: title, subtitle, date, workspace lockup, optional hero image.",
+        data_shape: "Held on TemplateContent.cover, not on a section.data.",
+        common_fields: [
+            "subtitle: string",
+            "date: string (free-form or ISO)",
+            "bgImageUrl: string | null",
+            "titlePosition: '(top|middle|bottom)-(left|center|right)'",
+            "accentColor: hex",
+            "presentedBy: { enabled, showLogo, logoUrl, size, position, ... }",
+        ],
+    },
+    {
+        type: "toc",
+        purpose: "Table of contents with per-row labels, borders, alignment.",
+        data_shape: "section.data — { title, showNumbers, hideRows: string[], borders, columnStyle }",
+        common_fields: [
+            "title: string",
+            "hideRows: string[] (section ids to omit)",
+            "columnStyle: 'fixed' | 'flexible'",
+        ],
+    },
+    {
+        type: "text",
+        purpose: "Unified text block (title + subtitle + body) with optional callout treatment.",
+        data_shape: "section.data — see lib/doc-types.ts. Legacy 'container' auto-migrates to this.",
+        common_fields: [
+            "title, subtitle, body: string",
+            "align/font/size/color per element",
+            "callout: bool + calloutTone: 'primary'|'accent'|'muted'|'custom'",
+            "bgColor, padding, radius",
+        ],
+    },
+    {
+        type: "notes",
+        purpose: "Bullet list section (title + subtitle + bullets) with configurable markers.",
+        data_shape: "section.data — { title, subtitle, bullets: string[], bulletMarker, textSize, markerSize }",
+        common_fields: [
+            "bullets: string[]",
+            "bulletMarker: 'disc'|'circle'|'square'|'decimal'|'dash'|'arrow'|'check'|'custom'",
+            "bulletMarkerCustom: string (1-4 chars)",
+        ],
+    },
+    {
+        type: "gear",
+        purpose: "Reference to workspace gear items — renders as table / bullets / images grid.",
+        data_shape: "section.data — { title, itemIds: string[], format: 'table'|'bullets'|'images', columns, ... }",
+        common_fields: [
+            "itemIds: uuid[] (from workspace gear library)",
+            "format: 'table' | 'bullets' | 'images'",
+            "columns: { photo, brand, quantity }",
+        ],
+    },
+    {
+        type: "shot-list",
+        purpose: "Table of shots (name / kind / lens / notes).",
+        data_shape: "section.data — { title, rows: [{ name, kind, lens, notes }] }",
+        common_fields: ["rows: object[]"],
+    },
+    {
+        type: "team",
+        purpose: "Crew grid (name + role). Optional join to workspace_members.",
+        data_shape: "section.data — { title, people: [{ name, role }] }",
+        common_fields: ["people: object[]"],
+    },
+    {
+        type: "products",
+        purpose: "Shopify product references (placeholder — real integration is Phase 2).",
+        data_shape: "section.data — { title, products: ProductRef[] }",
+        common_fields: ["products: object[]"],
+    },
+    {
+        type: "locations",
+        purpose: "Location list — address + optional map URL.",
+        data_shape: "section.data — { title, locations: LocationItem[] }",
+        common_fields: [
+            "locations: [{ label, address, notes?, mapUrl? }]",
+        ],
+    },
+    {
+        type: "people-link",
+        purpose: "Mixed list of workspace members and external contacts.",
+        data_shape: "section.data — { title, people: LinkedPerson[] }",
+        common_fields: [
+            "people: [{ userId?, name, role?, email?, phone?, external? }]",
+        ],
+    },
+    {
+        type: "table",
+        purpose: "Freeform header + rows.",
+        data_shape: "section.data — { title, header: string[], rows: { cells: string[] }[] }",
+        common_fields: ["rows: TableRow[]"],
+    },
+    {
+        type: "moodboard",
+        purpose: "Image grid with configurable rows/cols/spacing/radius/aspect.",
+        data_shape: "section.data — { title, images: (MoodBoardImage|null)[], rows, cols, aspect, spacing, radius, ... }",
+        common_fields: [
+            "images: length === rows * cols (missing slots are null)",
+            "aspect: 'square' | 'portrait' | 'landscape'",
+            "rows, cols: number",
+        ],
+    },
+    {
+        type: "palette",
+        purpose: "Colour palette extracted from a source moodboard (or manually curated).",
+        data_shape: "section.data — { title, sourceSectionId, rows, cols, extractedColours, ... }",
+        common_fields: [
+            "sourceSectionId: string (id of a moodboard section)",
+            "rows, cols: number",
+            "extractedColours: PaletteColour[]",
+        ],
+    },
+];
+export function findSection(type) {
+    return SECTION_CATALOG.find((s) => s.type === type) ?? null;
+}
+//# sourceMappingURL=section-catalog.js.map

package/dist/section-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-catalog.js","sourceRoot":"","sources":["../src/section-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,MAAM,CAAC,MAAM,eAAe,GAA0B;IACpD;QACE,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,sFAAsF;QAC/F,UAAU,EAAE,uDAAuD;QACnE,aAAa,EAAE;YACb,kBAAkB;YAClB,iCAAiC;YACjC,2BAA2B;YAC3B,0DAA0D;YAC1D,kBAAkB;YAClB,kEAAkE;SACnE;KACF;IACD;QACE,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,4DAA4D;QACrE,UAAU,EAAE,iFAAiF;QAC7F,aAAa,EAAE;YACb,eAAe;YACf,0CAA0C;YAC1C,mCAAmC;SACpC;KACF;IACD;QACE,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,+EAA+E;QACxF,UAAU,EAAE,gFAAgF;QAC5F,aAAa,EAAE;YACb,+BAA+B;YAC/B,mCAAmC;YACnC,kEAAkE;YAClE,0BAA0B;SAC3B;KACF;IACD;QACE,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,6EAA6E;QACtF,UAAU,EAAE,2FAA2F;QACvG,aAAa,EAAE;YACb,mBAAmB;YACnB,kFAAkF;YAClF,wCAAwC;SACzC;KACF;IACD;QACE,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,+EAA+E;QACxF,UAAU,EAAE,+FAA+F;QAC3G,aAAa,EAAE;YACb,+CAA+C;YAC/C,wCAAwC;YACxC,qCAAqC;SACtC;KACF;IACD;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,8CAA8C;QACvD,UAAU,EAAE,+DAA+D;QAC3E,aAAa,EAAE,CAAC,gBAAgB,CAAC;KAClC;IACD;QACE,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,8DAA8D;QACvE,UAAU,EAAE,oDAAoD;QAChE,aAAa,EAAE,CAAC,kBAAkB,CAAC;KACpC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,yEAAyE;QAClF,UAAU,EAAE,kDAAkD;QAC9D,aAAa,EAAE,CAAC,oBAAoB,CAAC;KACtC;IACD;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,6CAA6C;QACtD,UAAU,EAAE,qDAAqD;QACjE,aAAa,EAAE;YACb,kDAAkD;SACnD;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,wDAAwD;QACjE,UAAU,EAAE,kDAAkD;QAC9D,aAAa,EAAE;YACb,+DAA+D;SAChE;KACF;IACD;QACE,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,yBAAyB;QAClC,UAAU,EAAE,yEAAyE;QACrF,aAAa,EAAE,CAAC,kBAAkB,CAAC;KACpC;IACD;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,+DAA+D;QACxE,UAAU,EAAE,qGAAqG;QACjH,aAAa,EAAE;YACb,yDAAyD;YACzD,6CAA6C;YAC7C,oBAAoB;SACrB;KACF;IACD;QACE,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,yEAAyE;QAClF,UAAU,EAAE,8EAA8E;QAC1F,aAAa,EAAE;YACb,qDAAqD;YACrD,oBAAoB;YACpB,mCAAmC;SACpC;KACF;CACF,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC;AAC9D,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@kezlahd/atlas-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for the Atlas creative-team platform – lets Claude Code and other AI agents edit doc templates, files, and gear.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Kieran Jackson",
+  "homepage": "https://atlas.mjsons.net",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KezLahd/atlas.git",
+    "directory": "packages/atlas-mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/KezLahd/atlas/issues"
+  },
+  "keywords": [
+    "atlas",
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai-tools",
+    "creative-team"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "atlas-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "tsc"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "tsx": "^4.19.2",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}