@atawai/mcp

ATAWAI MCP server — captures the reasoning behind every AI-assisted code change and exposes it to any MCP-compatible client.

Anytime. Anywhere. Any AI.

This package is the cross-IDE engine of ATAWAI. It runs locally as a stdio MCP server, captures every prompt and file change, and exposes 24 tools in the Version Graph v1 taxonomy (timeline, file history, replay, restore, lineage, reversals, team sharing, etc.) that your AI can call to remember why things were done.

No bundled UI — just the data plane and the tools. Pair with the atawai VS Code / Cursor extension if you want a sidebar.

Install

Option 1 — Zero install via npx (recommended)

Add ATAWAI to your client's MCP config. The Node bundle (~465 KB) is downloaded on first use and cached by npx.

Cursor — .cursor/mcp.json

{
  "mcpServers": {
    "atawai": {
      "command": "npx",
      "args": ["-y", "@atawai/mcp", "${workspaceFolder}"]
    }
  }
}

VS Code (≥ 1.99 with Copilot Chat) — .vscode/mcp.json

{
  "servers": {
    "atawai": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@atawai/mcp", "${workspaceFolder}"]
    }
  }
}

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
  "mcpServers": {
    "atawai": {
      "command": "npx",
      "args": ["-y", "@atawai/mcp", "/absolute/path/to/your/workspace"]
    }
  }
}

Claude Code CLI — ~/.claude.json

{
  "mcpServers": {
    "atawai": {
      "command": "npx",
      "args": ["-y", "@atawai/mcp", "."]
    }
  }
}

Codex CLI — ~/.codex/config.toml

[mcp_servers.atawai]
command = "npx"
args = ["-y", "@atawai/mcp", "."]

Option 2 — Global install

npm install -g @atawai/mcp
# then use `atawai-mcp` instead of `npx -y @atawai/mcp` in the configs above

Option 3 — Full IDE bootstrap (one command)

npx -y @atawai/install <device-code-from-rl4.ai>

Installs the atawai VSIX (bundled inside the npm package — no network fetch), sideloads it into your IDE, and links your account.

What the tools do

Once connected, your AI gets 24 MCP tools in the Version Graph v1 taxonomy:

• atawai_graph_* (11) — read the Version Graph (the product): graph_summary, graph_timeline, graph_reversals, graph_chat_search, graph_edit_context, graph_file_history, graph_replay, graph_blob, graph_file_read, graph_restore, graph_lineage
• atawai_capture_* (4) — ingestion / sync: capture_flush, capture_git, capture_recover_chats, capture_sync_health
• atawai_admin_* (6) — workspace / auth / diagnostics: admin_workspaces, admin_workspace_probe, admin_debug, admin_verify, admin_live_activity, admin_login
• atawai_team_* (3) — share the Version Graph with collaborators: team_share, team_revoke, team_list. access="chain_only" shares the reconstruction (prompts, chains, timeline, lineage) while the content store stays refused at the database level — never the source bytes.

All tools operate on the workspace's .rl4/ directory. No data leaves your machine unless you opt into cloud sync.

Requirements

• Node.js ≥ 20
• An MCP-compatible client (Cursor, VS Code with Copilot Chat ≥ 1.99, Claude Desktop, Claude Code, Codex, Continue.dev)

License

MIT — see LICENSE.