Atono MCP server

Atono MCP Server

Give your AI coding tools your team's product context.

Your AI tools are fast, confident, and guessing at how your product actually works. They can only act on the context they can reach — so they produce work that looks right, passes review, ships, and fails weeks later.

The Atono MCP server connects Claude Code, Claude Desktop, Cursor, VS Code, Copilot, Windsurf, and Codex directly to an Atono workspace. 41 tools for reading and writing stories, bugs, epics, subtasks, acceptance criteria, and timeboxes — plus the two things that actually change output quality: your workspace glossary of product concepts, and per-item AI context (design decisions, investigations, summaries).

Agents stop relearning your domain on every session.

Quick start

Prerequisites

1. Docker Desktop v27.0 or later, running in the background
2. An Atono API key — workspace settings → Manage API keys
3. An MCP-enabled tool

Claude Code

claude mcp add --transport stdio atono \
  --env X_API_KEY=YOUR_ATONO_API_KEY \
  -- docker run --pull=always -i --rm -e X_API_KEY atonoai/atono-mcp-server:latest

Run /mcp to confirm Atono appears.

Claude Desktop

claudedesktopconfig.json:

{
  "mcpServers": {
    "atono": {
      "command": "docker",
      "args": [
        "run", "--pull=always", "-i", "--rm",
        "-e", "X_API_KEY=YOUR_ATONO_API_KEY",
        "atonoai/atono-mcp-server:latest"
      ]
    }
  }
}

Cursor

One-step install via the Cursor MCP directory, or add to mcp.json:

{
  "mcpServers": {
    "atono-mcp-server": {
      "command": "docker",
      "args": [
        "run", "--pull=always", "-i", "--rm",
        "-e", "X_API_KEY=YOUR_ATONO_API_KEY",
        "atonoai/atono-mcp-server:latest"
      ]
    }
  }
}

VS Code (GitHub Copilot)

Copilot Chat → Configure Tools → Add MCP Server → Docker Image → atonoai/atono-mcp-server:latest, then use the same JSON in .vscode/mcp.json and restart the server.

Windsurf

Same JSON as Cursor, in mcp_config.json. Restart Windsurf.

OpenAI Codex

~/.codex/config.toml:

[mcp_servers.atono]
command = "docker"
args = ["run", "--pull=always", "-i", "--rm", "-e", "X_API_KEY", "atonoai/atono-mcp-server:latest"]

[mcp_servers.atono.env]
X_API_KEY = "YOUR_ATONO_API_KEY"

Verify: ask your assistant "What Atono MCP tools are available?"

Updates: none required. --pull=always fetches the latest image on restart.

The 41 tools

Setup & context (5) atonoconfiguration · atonolistusers · atonolistteams · atonogetteamworkflow · atonogetglossary

Stories (10) atonogetstory · atonoliststorypersonas · atonocreatestory · atonoupdatestorytitle · atonoupdatestorycontent · atonoupdatestoryac · atonoupdatestoryadditionalcontent · atonoupdatestoryteam · atonoupdatestorystep · atonoupdatestory_assignee

Bugs (7) atonolistenvironments · atonogetbug · atonocreatebug · atonoupdatebug · atonoupdatebugstep · atonoupdatebugassignee · atonodocumentbug_fix

Epics (7) atonocreateepic · atonogetepic · atonoupdateepictitle · atonoupdateepicdescription · atonoupdateepicuserstories · atonoaddstorytoepic · atonoremovestoryfromepic

Subtasks (4) atonogetsubtasks · atonocreatesubtask · atonoupdatesubtask · atonodeletesubtask

Attachments (3) atonouploadfileurl · atonocreateattachment · atonoget_attachment

Timeboxes (2) atonolisttimeboxes · atonolisttimebox_items

Linked items (1) atonolinkbugsorstories

AI context (2) atonogetaicontext · atonoupdateaicontext

Full reference: docs.atono.io/docs/atono-mcp-tools

Shortened. The full README is on GitHub.