Skip to main content
The ai-cmo.dev MCP server runs as a local stdio process and proxies the ai-cmo.dev API. This page takes you from a clean machine to a verified, responding server.

​
Prerequisites

Node.js 20 or later is required. Verify your version:

​
Install and connect

1

Start the ai-cmo.dev web app

Start the app locally and keep it running:
The app listens on http://127.0.0.1:3000 by default. To point the server at a different instance, set AICMO_BASE_URL (see Environment variables).
2

Add the server to your MCP client

Register the server with your client’s CLI, or declare it in its config file:
npx -y downloads and executes the latest ai-cmo-mcp package from npm without a prompt. To pin a version, use npx -y ai-cmo-mcp@<version> or install the package globally and reference the binary directly.
3

Authorize in the browser on first run

On first use, ai-cmo.dev opens your browser so you can choose a workspace and approve access. No API-key copying is required — the approved credential is written to ~/.ai-cmo/credentials.json and reused on later runs. See the authorization guide for the full flow.To skip the browser flow (for example in CI), set AICMO_API_KEY. When set, the device flow is skipped entirely.
4

Verify the server responds

Once authorized, try asking your assistant:
  • Show my ai-cmo.dev score and scoreboard.
  • List the latest recommendations and runs.
  • Ask ai-cmo.dev what I should improve next.
Each prompt should trigger the matching MCP tool. To verify initialization without contacting the web app, run the stdio handshake smoke test.

​
Ready-to-paste assistant prompts

Once the server is installed and authorized, these prompts trigger the matching MCP tools:
Ask for your score and scoreboard
List recommendations and runs
Ask for improvement suggestions
Whoami and workspace info
Get a specific report
Multi-step workflow

​
Environment variables

The legacy env var names NOISEMAKER_BASE_URL and NOISEMAKER_API_KEY are still recognized as fallbacks.
Export env vars for the MCP server
Next: browse the tool reference for all 10 tools, or follow the usage examples.