Any other AI tool, over MCP.

The details

Leave out the key and a tool that supports OAuth signs you in instead. Create one under Organisation settings, Developers, API keys. See Setup.

Config shapes

mcpServers with url

Used by Cursor and similar tools. Claude Code's .mcp.json adds "type": "http".

{
  "mcpServers": {
    "sb": {
      "url": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp",
      "headers": { "Authorization": "Bearer ${env:STABLE_BASELINE_API_KEY}" }
    }
  }
}

servers

Used by VS Code.

{
  "servers": {
    "sb": { "type": "http", "url": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp" }
  }
}

serverUrl

Used by Antigravity and by the Cascade agent in Devin Desktop.

{
  "mcpServers": {
    "sb": { "serverUrl": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp" }
  }
}

httpUrl

Used by Gemini CLI.

{
  "mcpServers": {
    "sb": { "httpUrl": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp" }
  }
}

TOML

Used by Codex.

[mcp_servers.sb]
url = "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp"
bearer_token_env_var = "STABLE_BASELINE_API_KEY"

mcp with type remote

Used by OpenCode.

{
  "mcp": {
    "sb": { "type": "remote", "url": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp" }
  }
}

A local bridge

For a tool that can only start local servers, run a small bridge that forwards to Stable Baseline. It needs Node.js:

{
  "mcpServers": {
    "sb": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp"]
    }
  }
}

No account yet?

Your AI tool can sign you up. Ask it to start a Stable Baseline sign-up: it shows you a short code and a link, you confirm in your browser, and the tool carries on with your new account. See the sign-up tools.

Document a repository

If your tool offers MCP prompts as commands, run sb-setup. Otherwise ask in plain words:

Document this repository in my Stable Baseline project. Use the Stable Baseline tools to find my workspace and project (do not create them), read the code, design a structure of folders, documents and diagrams, write them, and add a Stable Baseline section to AGENTS.md so you keep the docs current as the code changes.

1. 1

   Checks the connection

   It confirms it can reach Stable Baseline with your key or sign-in.
2. 2

   Finds your workspace and project

   It never creates them: if it cannot find the ones you mean, it asks you to create them in the app first.
3. 3

   Remembers them

   It writes their ids to .sb/config.json, and keeps .sb/ out of git.
4. 4

   Checks for existing docs

   If the project already has documentation, it asks whether to add to it, replace it, or stop.
5. 5

   Reads the repository

   It works through the code to understand what is there.
6. 6

   Designs a structure

   Folders and documents that fit this repository, not a fixed template.
7. 7

   Writes it

   Folders, documents, and the diagrams each document needs.
8. 8

   Updates AGENTS.md

   It adds a Stable Baseline section with rules for keeping the docs current, and keeps everything else in the file.
9. 9

   Sums up

   It tells you what it created.