Citadel MCP

A Code Mode MCP server that gives AI coding agents curated, per-stack documentation as typed tools.

Citadel is built to be forked and tailored. The hosted package ships with a small starter set of stacks, but the real value comes from packaging the docs your agents actually need. Each stack is a tiny module — adding one is mostly mechanical.

Getting Started

Requirements

• Node.js v20.19 or a newer latest maintenance LTS version
• npm or pnpm

Install with add-mcp

Install the MCP server for all your coding agents:

npx add-mcp citadel-mcp@latest

Add -y to skip the confirmation prompt and install to all detected agents already in use in the project directory. Add -g to install globally across all projects.

Manual installation

Add the following config to your MCP client:

{
  "mcpServers": {
    "citadel": {
      "command": "npx",
      "args": ["-y", "citadel-mcp@latest"]
    }
  }
}

[!NOTE] Using citadel-mcp@latest ensures that your MCP client will always use the latest version of the Citadel MCP server.

MCP Client Configuration

amp mcp add citadel -- npx citadel-mcp@latest

claude mcp add -s user citadel -- npx -y citadel-mcp@latest

codex mcp add citadel -- npx citadel-mcp@latest

gemini mcp add citadel npx citadel-mcp@latest

gemini mcp add -s user citadel npx citadel-mcp@latest

code --add-mcp '{"name":"citadel","command":"npx","args":["-y","citadel-mcp@latest"]}'

What you get out of the box

The hosted package includes a starter set of stacks so you can try it immediately:

• Next.js (App Router, Next.js 16)
• React
• Turborepo
• Supabase guides

This list is intentionally small. For the best results, fork this repo and add the stacks your agents care about — your internal libraries, the framework version you actually use, or any docs site that publishes machine-readable markdown. See docs/adding-a-docs-tool.md.

How it works

Citadel is a Code Mode server: instead of advertising one tool per docs source, it advertises a single docs tool. The agent writes one async () => { ... } per turn that calls codemode.<stack>_docs(...) and `codemode._index

... View full README on GitHub