Check that ATLAS is up and report what this server is pointed at.

Start here when another tool fails: it distinguishes "ATLAS is down" from "the feature is disabled" from "this server is aimed at the wrong URL".

List saved conversations, newest first.

Returns id, title, model, timestamps, message count, and a short preview. Use get_conversation for the messages themselves.

Search conversations by title and message content.

Read one full conversation, including its messages.

Long messages are clipped per-message so a single large tool result cannot swamp the answer; raise max_message_chars when you need the full text of a specific turn.

List the tags this user has applied to conversations.

Read config/mcp.json — the whole file, or one server entry.

Add or replace one server entry in config/mcp.json.

The entry is replaced wholesale, not merged — read the current entry with get_mcp_config first and send it back with your change applied. The rest of the file is untouched, and the previous file is backed up.

A stdio entry looks like::

{"command": ["/abs/path/.venv/bin/entrypoint", "--stdio"],
 "cwd": "/abs/path", "transport": "stdio",
 "groups": ["users"], "description": "what it does"}

Remove a server entry from config/mcp.json (previous file is backed up).

Overwrite config/mcp.json with a complete JSON document.

For restructuring several entries at once. Rejected unless content parses as an object of objects; the previous file is backed up either way. Prefer upsert_mcp_server for a single-server change.

List this user's workspaces (saved bundles of prompt/tool/RAG selections).

Create a workspace.

The selection fields are exactly what ATLAS restores when the workspace is applied; unknown keys are rejected by the API, so use these arguments rather than a free-form config blob.

Update a workspace's name, description, or selections.

config replaces the whole selection snapshot when given — read the current one with list_workspaces first. Allowed keys: active_prompt_key, selected_tools, selected_prompts, selected_data_sources, rag_enabled. Anything else is rejected by ATLAS.

Delete a workspace. Not recoverable — confirm with the user first.

List this user's custom prompt library.

Read one custom prompt in full, by id.

Add a prompt to this user's library.

Edit a custom prompt's title or content.

content replaces the whole text — read it with get_custom_prompt first if you are amending rather than rewriting.

Delete a custom prompt. Not recoverable — confirm with the user first.

List the markdown prompt files ATLAS loads from disk.

These are the defaults (system prompt, agent reason/observe/summary prompts), separate from the per-user library above. Editing one changes behaviour for every chat, and takes effect on the next ATLAS restart.

Read one on-disk prompt file.

Overwrite an on-disk prompt file, backing up the previous version.

Affects every chat in this instance and applies on the next ATLAS restart. Confirm with the user before changing system_prompt.md.