Quick Setup

Prerequisites

• A Stable Baseline account with at least one workspace.
• An MCP-compatible client (Claude Desktop, Cursor, VS Code, Windsurf, or any Streamable HTTP client).

1. Create an API Key

1. Open your organization in Stable Baseline and go to Settings → MCP Setup → API Keys.
2. Click Create Key and give it a descriptive name (e.g., "Claude Desktop – work laptop").
3. Select which workspaces (and optionally projects / folders) the key can access.
4. Choose an expiration: 7 days, 30 days, 90 days, 1 year, or never expires.
5. Click Create MCP Key. Copy the key immediately — it will only be shown once.

Your key will look like sta_... and is sent as a Bearer token in the Authorization header.

2. Configure Your Client

Claude Desktop / Cursor / Windsurf

Add the following to your MCP client configuration file. For Claude Desktop on macOS this is ~/Library/Application Support/Claude/claude_desktop_config.json:

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

VS Code (GitHub Copilot)

Add to your .vscode/settings.json or user settings:

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

cURL (Manual Testing)

Send a JSON-RPC request directly:

curl -X POST https://api.stablebaseline.io/functions/v1/cloud-serve/mcp \
  -H "Authorization: Bearer sta_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

3. Verify the Connection

Once configured, your AI agent should automatically discover all available tools. A good first command to test is asking your agent to:

The agent will call listOrganizations, then listWorkspaces, and return your workspace names. If this works, your connection is configured correctly.

Endpoint Reference