MCP servers for Atomic Agent
Atomic Agent is an MCP client. Any MCP server you add shows up in the agent’s toolbox next to the built-in browser, shell and file tools, under the name mcp.<server>.<tool>. This section has one page per popular service: the exact config for that service’s official MCP server, what to ask the agent once it is connected, where the token lives, and what to do when the server will not start.
If you are new to MCP in Atomic Agent, read the MCP client reference first. It covers every config field, the three transports and the approval rules these pages rely on.
Connect an official server
Build your own
Three ways to add a server
Every page below gives you one JSON object. You can add it in any of three places, and all three write the same mcp.servers list in ~/.atomic-agent/config.json (the desktop app and the terminal share that folder):
| Where | How | When it connects |
|---|---|---|
config.json by hand | Add the object to the mcp.servers array | On the next start of the agent |
| Terminal UI | Run /mcp add (or press n in the /mcp panel) and paste the object | Right away |
| Desktop app | Settings › Connections › MCP servers › Add server, paste, press ⌘Enter (Ctrl+Enter on Windows and Linux) | Press Restart on the new row |
The paste box in the TUI and the desktop app also accepts the {"mcpServers": {"name": {...}}} shape that most MCP servers print in their README, as long as it holds exactly one server. Hand-edited config.json needs the canonical shape with a transport block, which is what these pages show.
Before you connect anything
- Approvals. Tools from an MCP server ask before they run unless the server marks a tool read-only (
readOnlyHint), you set the server’strusttopure_read, you run at approval level 5 (full trust), or you allowed the category for the session. Leave write-capable servers at the default. - No OAuth. Atomic Agent sends static headers only. Every service page here uses a token or API key path for that reason. Servers that accept OAuth only cannot be connected today.
- Tokens are stored in plain text. Header values and per-server
envlive inconfig.json. The agent writes that file with owner-only permissions (0600) on macOS and Linux, but it is not encrypted. - Each tool costs prompt space on every turn. A server with dozens of tools makes every request longer, which matters most on small local models. Several pages show how to load fewer tools.
Get updates by email
One email when a new version comes out.