MCP in your editor

@atlas/mcp connects your AI coding assistant to a project you've already connected on Atlas — over the hosted API, authenticated with a key you generate in the dashboard. Your assistant queries the live architecture instead of guessing.

Atlas is hosted — there's nothing to clone or run locally. The MCP server talks to the Atlas API over the internet and points at the hosted endpoint by default, so all it needs is your ATLAS_API_KEY.

1. Create an API key

In the dashboard open Settings → API keys → New key, name it and choose the project it should reach. Copy the key — it's shown once and looks like atlas_sk_….

Treat the key like a password: it grants read access to that project's graph and audits. Revoke or rotate it from the same screen at any time.

2. Claude Code

Add to ~/.claude.json or a project .mcp.json and paste your key into env:

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": ["-y", "@atlas/mcp"],
      "env": {
        "ATLAS_API_KEY": "atlas_sk_your_key_here"
      }
    }
  }
}

Cursor / Windsurf

In Cursor: Settings → MCP, same shape (command: npx, args ["-y", "@atlas/mcp"]) with ATLAS_API_KEY in env. Any stdio MCP client works — the key alone tells Atlas which project to answer for, so there's no path or working directory to configure.

Configuration

ATLAS_API_KEY — required. The project-scoped key from the dashboard.
ATLAS_AUDIT_INTERVAL_MIN — optional, default 30 (0 disables periodic audits).

Tools

atlas_status	Which project the key is scoped to, and when it last audited.
atlas_should_recheck	Convention trigger — re-audit when the project changed.
atlas_scan	Ask Atlas to re-pull the connected repo and rebuild its graph.
atlas_audit	Full AI audit: health score 0–100, top risks, file:line citations.
atlas_last_audit	Read the most recent audit from cache (free, no AI call).
atlas_list_issues	Deterministic structural issues + security findings.
atlas_search_symbol	Locate a symbol in the project graph by substring.
atlas_examine_node	AI-examine one symbol with its source + neighbours.
atlas_impact	Blast-radius (direct + transitive dependents) before a refactor.