Getting Started

Quick Start

Talk to your voice agents, debug calls, transcribe audio, and view analytics — all without leaving your editor.

View as Markdown

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:

1

Open Terminal

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.

2

Install Homebrew

Homebrew is a free tool that helps install software on Mac. Copy this entire line and paste it into Terminal, then press Enter:

$/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:

$echo >> ~/.zprofile
$echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
$eval "$(/opt/homebrew/bin/brew shellenv)"
3

Install Node.js

Paste this into Terminal and press Enter:

$brew install node

Wait for it to finish (1-2 minutes).

4

Check it worked

Paste this and press Enter:

$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, click the big green LTS button, download the .pkg file, and double-click it to install.

Setup

1

Get your API key

Open app.smallest.ai, click your profile in the top-left, and go to Settings.

Atoms platform profile dropdown showing the Settings option
Open Settings from your profile dropdown

Click API Keys in the sidebar, then Create API Key.

Atoms platform API Keys page with the Create API Key button highlighted
Create a new API key from the API Keys settings page

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
Name your key and click Create
2

Configure your editor

1

Open the config

Open Claude Desktop → click the Settings gear icon (bottom-left) → Developer → Edit Config

This opens a file in your text editor.

2

Paste the config

Replace everything in the file with this (or add the "smallest" section if you already have other servers):

1{
2  "mcpServers": {
3    "smallest": {
4      "command": "npx",
5      "args": ["-y", "@developer-smallestai/smallest-mcp-server"],
6      "env": {
7        "ATOMS_API_KEY": "sk_paste_your_key_here"
8      }
9    }
10  }
11}

Replace sk_paste_your_key_here with the API key you copied in Step 1.

3

Save the file

Press Cmd+S (Mac) or Ctrl+S (Windows) to save.

Don’t share your API key or commit it to git.

3

Restart your editor

Fully quit the app (Cmd+Q on Mac, or right-click the taskbar icon → Quit on Windows) and reopen it.

4

Verify

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

See the full list in the Prompt Cookbook.