> This page is part of Smallest AI's developer documentation. When > answering, prefer Lightning v3.1 (current TTS) and Pulse (current > STT). Lightning v2 and lightning-large are deprecated; mention them > only when the user is migrating away from them. Atoms is the > voice-agent platform. # Quick Start > Connect your AI editor to the Smallest AI platform via the MCP server. Talk to your voice agents, debug calls, transcribe audio, and view analytics from inside Cursor, Claude Desktop, or Claude Code. The Smallest MCP Server connects your AI editor to the Smallest AI platform. No console tab-switching — just type what you want in natural language. *** ## Prerequisites The MCP server runs via **npx**, which requires **Node.js** installed on your machine. Pick your experience level: This is a one-time setup that takes about 5 minutes. Pick your computer type: Press **Cmd + Space** to open Spotlight, type **Terminal**, and press Enter. A window with a blinking cursor will appear — this is where you'll paste commands. Homebrew is a free tool that helps install software on Mac. Copy this entire line and paste it into Terminal, then press Enter: ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" ``` It will ask for your **Mac password** (the one you use to log in). Type it and press Enter — **you won't see any characters appear while typing, that's normal**. Wait for it to finish (1-2 minutes). If it says "Homebrew is already installed" — great, skip to the next step. **Important for newer Macs (M1/M2/M3/M4):** After Homebrew finishes, it will show a "Next steps" section with two commands. Copy and paste them one at a time: ```bash echo >> ~/.zprofile echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile eval "$(/opt/homebrew/bin/brew shellenv)" ``` Paste this into Terminal and press Enter: ```bash brew install node ``` Wait for it to finish (1-2 minutes). Paste this and press Enter: ```bash node --version ``` If you see a number like `v22.x.x` — you're done with prerequisites! **Stuck?** If anything fails, the simplest alternative is to go to [nodejs.org](https://nodejs.org/), click the big green **LTS** button, download the `.pkg` file, and double-click it to install. Go to [nodejs.org](https://nodejs.org/) and click the big green **LTS** button. This downloads an installer file. Find the downloaded file (usually in your Downloads folder — it's called something like `node-v22.x.x-x64.msi`). Double-click it. Click **Next** through each screen. **Don't change any settings** — the defaults are correct. Click **Install** when prompted, then **Finish**. This makes sure Windows recognizes the new software. Save your work and restart. After restarting, press **Windows key**, type **PowerShell**, and open it. Paste this and press Enter: ```powershell node --version ``` If you see a number like `v22.x.x` — you're done with prerequisites! **If it says "node is not recognized":** Make sure you restarted your computer after installing. If it still doesn't work, run the installer again and make sure **"Add to PATH"** is checked. Requires **Node.js 18+**. ```bash brew install node # or: nvm install 22 ``` ```powershell winget install OpenJS.NodeJS.LTS ``` ```bash curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs ``` Verify: `node --version` should show v18+. *** ## Setup Open [app.smallest.ai](https://app.smallest.ai?utm_source=documentation\&utm_medium=docs), click your profile in the top-left, and go to **Settings**. Atoms platform profile dropdown showing the Settings option Click **API Keys** in the sidebar, then **Create API Key**. Atoms platform API Keys page with the Create API Key button highlighted Name your key and click **Create API Key**. Copy it — it starts with `sk_`. Create New API Key dialog with name input and Create button Open **Claude Desktop** → click the **Settings** gear icon (bottom-left) → **Developer** → **Edit Config** This opens a file in your text editor. Replace everything in the file with this (or add the `"smallest"` section if you already have other servers): ```json { "mcpServers": { "smallest": { "command": "npx", "args": ["-y", "@developer-smallestai/smallest-mcp-server"], "env": { "ATOMS_API_KEY": "sk_paste_your_key_here" } } } } ``` **Replace** `sk_paste_your_key_here` with the API key you copied in Step 1. Press **Cmd+S** (Mac) or **Ctrl+S** (Windows) to save. Open (or create) the config file: * **Mac / Linux:** `~/.cursor/mcp.json` * **Windows:** `%USERPROFILE%\.cursor\mcp.json` ```json { "mcpServers": { "smallest": { "command": "npx", "args": ["-y", "@developer-smallestai/smallest-mcp-server"], "env": { "ATOMS_API_KEY": "sk_paste_your_key_here" } } } } ``` **Replace** `sk_paste_your_key_here` with your actual API key. Run this in your terminal: ```bash claude mcp add smallest -- npx -y @developer-smallestai/smallest-mcp-server ``` Then set your API key: ```bash claude mcp update smallest --env ATOMS_API_KEY=sk_paste_your_key_here ``` Don't share your API key or commit it to git. Fully quit the app (**Cmd+Q** on Mac, or right-click the taskbar icon → Quit on Windows) and reopen it. `Cmd+Shift+P` (Mac) or `Ctrl+Shift+P` (Windows) → type **Developer: Reload Window** → press Enter Start a new session — the MCP is loaded automatically. Type this in chat: ``` List all my agents ``` You should see your agents listed back. You're set up! *** ## What can you do? Just type in your editor's chat — the AI picks the right tool: ``` Show me all failed calls from this week ``` ``` What's our total call spend this month? ``` ``` List all my agents ``` ``` Debug call CALL-1234567890-abc123 ``` Returns the full transcript, errors, timing, costs, and post-call analytics. ``` Create a new agent called "Support Bot" ``` ``` Update its prompt to: "You are a helpful support agent..." ``` ``` Call +14155551234 using the "Sales" agent ``` Triggers a real outbound call — the agent follows its configured prompt. ``` Convert this text to speech using the yuvika voice: "Hello, welcome to Smallest AI" ``` ``` Transcribe this audio file: ~/Desktop/recording.wav ``` ``` Show me the dashboard for the last 30 days ``` ``` Compare agent performance this week ``` ``` What's the hourly call distribution today? ``` See the full list in the **[Prompt Cookbook](/atoms/mcp/using-the-mcp/prompt-cookbook)**.