Atoms MCP Server

MCP server for the Atoms voice AI platform. Manage agents, debug calls, view analytics — directly from your IDE.

Quick start

Option A: npm (recommended)

Requires Node.js 18+. Add this to your MCP config (~/.cursor/mcp.json for Cursor, claude_desktop_config.json for Claude Desktop):

{
  "mcpServers": {
    "atoms": {
      "command": "npx",
      "args": ["-y", "@developer-smallestai/atoms-mcp-server"],
      "env": {
        "ATOMS_API_KEY": "sk_your_key_here"
      }
    }
  }
}

Auto-updates to the latest version every time your editor restarts.

Option B: One-line installer (no dependencies)

Mac / Linux:

curl -fsSL https://raw.githubusercontent.com/smallest-inc/mcp-server/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/smallest-inc/mcp-server/main/install.ps1 | iex

Downloads a standalone binary, prompts for your API key, and configures Cursor + Claude Desktop automatically. Re-run to update.

Option C: One prompt

Open a chat in Cursor or Claude Desktop and type:

Set up the Atoms MCP server for me.
The npm package is @developer-smallestai/atoms-mcp-server.
My API key is: sk_paste_your_key_here

Verify

Reload your editor, then type: "List all my agents"

Available tools

Read

| Tool | Description | |---|---| | get_call_logs | Query call logs with filters for status, type, date range, agent name, or phone number | | debug_call | Deep-dive into a single call — full transcript, errors, timing, cost breakdown, post-call analytics | | get_agents | List agents with their configuration, voice, LLM model, and call stats | | get_usage_stats | Usage statistics — total calls, duration, costs, status breakdown | | get_campaigns | List outbound calling campaigns with status and progress | | get_phone_numbers | List phone numbers owned by your organization |

Write

| Tool | Description | |---|---| | create_agent | Create a new AI voice agent | | update_agent_prompt | Update an agent's system prompt / instructions | | update_agent_config | Update agent settings — name, language, voice, first message, etc. | | delete_agent | Archive (soft-delete) an agent |

Act

| Tool | Description | |---|---| | make_call | Initiate an outbound phone call using a specific agent |

Resources

| Resource | URI | Description | |---|---|---| | Platform Overview | atoms://docs/platform-overview | Key concepts, call types, statuses, and cost breakdown |

Environment variables

| Variable | Required | Default | Description | |---|---|---|---| | ATOMS_API_KEY | Yes | — | Your Atoms API key | | ATOMS_API_URL | No | https://atoms-api.smallest.ai/api/v1 | Override the API base URL |

Development

npm install
npm run dev    # run with tsx
npm run build  # bundle to dist/

Releases

Merging to main automatically publishes a new version to npm and GitHub Releases.

Version bumps are automatic based on commit messages:

| Commit message contains | Bump | Example | |---|---|---| | new tool, new resource, add tool, add resource | minor (0.2.0 → 0.3.0) | feat: add new tool for knowledge bases | | BREAKING CHANGE or feat!: | major (0.2.0 → 1.0.0) | feat!: redesign agent config schema | | Anything else | patch (0.2.0 → 0.2.1) | fix: handle empty call logs |

To force a major version bump manually, include BREAKING CHANGE in the commit message or PR title.

License

MIT