@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 → 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):

{
  "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:

{
  "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.

Related packages

• @kezlahd/atlas-cli – terminal client that hits the same endpoints, for humans instead of agents.

Source for both packages lives in the Atlas monorepo.

License

MIT