Connecting your agent

Copy the Bloom MCP server URL:

https://www.trybloom.ai/api/mcp

There are two ways to authenticate:

Sign in with Bloom (OAuth) — the default. A browser sign-in on first connect, with nothing to set up in advance. Recommended; per-client setup is below.
API key — a static bloom_sk_... key in a request header. The better fit when there’s no browser to sign in with, when a team shares one setup, or when you’re running headless — CI, a server, an automation host.

Rule of thumb: OAuth for interactive desktop clients; an API key on a server, in CI, or anywhere headless. The default path — nothing to create ahead of time; you sign in when the client first connects.

Claude

Works in the Claude desktop app and on claude.ai (Pro, Max, Team, and Enterprise).

Open the connector settings

Go to Settings → Connectors and click Add custom connector.

Add the server

Paste the server URL and click Connect.

Claude Code

Add the server

claude mcp add --transport http bloom https://www.trybloom.ai/api/mcp

Add --scope user to make it available across all your projects.

Run /mcp inside Claude Code and sign in with Bloom when prompted.

Cursor

Add the server

Add Bloom to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "bloom": {
      "url": "https://www.trybloom.ai/api/mcp"
    }
  }
}

VS Code

Add the server

Add Bloom to .vscode/mcp.json:

{
  "servers": {
    "bloom": {
      "type": "http",
      "url": "https://www.trybloom.ai/api/mcp"
    }
  }
}

ChatGPT

Enable Developer mode

Turn on Developer mode under Settings → Apps & Connectors → Advanced.

Add the server

Add a connector with the server URL.

Choose OAuth and sign in with Bloom.

OpenClaw

Add the server

openclaw mcp add bloom --url https://www.trybloom.ai/api/mcp --transport streamable-http --auth oauth

Run openclaw mcp login bloom and complete the browser sign-in.

Hermes Agent

Add the server

hermes mcp add bloom --url https://www.trybloom.ai/api/mcp

When it asks about authentication, choose OAuth.

Complete the browser sign-in, then verify with hermes mcp test bloom.

API keys

Create a key from your account settings and treat it like a password: reference it from an environment variable or your client’s secret store rather than hard-coding it, and never commit it or expose it client-side. Bloom keys look like bloom_sk_.... The key goes in a request header, in either of two forms — use whichever your client expects:

x-api-key: bloom_sk_...

Authorization: Bearer bloom_sk_...

Not every client can carry a static key. Claude Code, Cursor, VS Code, OpenClaw, and Hermes support custom headers, and Claude Desktop can do so through a bridge (below). claude.ai and ChatGPT are sign-in only — use OAuth for those (see Sign in with Bloom).

Claude Code

Pass the key as a header when you add the server:

claude mcp add --transport http bloom https://www.trybloom.ai/api/mcp \
  --header "x-api-key:bloom_sk_..."

Add --scope user to make the server available across all your projects.

Cursor

Add a headers block to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "bloom": {
      "url": "https://www.trybloom.ai/api/mcp",
      "headers": {
        "x-api-key": "bloom_sk_..."
      }
    }
  }
}

To keep the key out of the file, reference an environment variable instead: "x-api-key": "${env:BLOOM_API_KEY}".

VS Code

Use an inputs block in .vscode/mcp.json so VS Code prompts for the key once and stores it securely, instead of hard-coding it:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "bloom-api-key",
      "description": "Bloom API Key",
      "password": true
    }
  ],
  "servers": {
    "bloom": {
      "type": "http",
      "url": "https://www.trybloom.ai/api/mcp",
      "headers": {
        "x-api-key": "${input:bloom-api-key}"
      }
    }
  }
}

Claude

Claude’s connector UI is sign-in only. To use a key with the Claude desktop app, add Bloom to claude_desktop_config.json (Settings → Developer → Edit Config) through the mcp-remote bridge, which connects the remote server through a local process:

{
  "mcpServers": {
    "bloom": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.trybloom.ai/api/mcp",
        "--header",
        "x-api-key:bloom_sk_..."
      ]
    }
  }
}

Restart Claude Desktop to pick up the change.

OpenClaw

Pass the key as a header when you add the server:

openclaw mcp add bloom \
  --url https://www.trybloom.ai/api/mcp \
  --transport streamable-http \
  --header "x-api-key:bloom_sk_..."

Or add it directly to ~/.openclaw/openclaw.json:

{
  "mcp": {
    "servers": {
      "bloom": {
        "url": "https://www.trybloom.ai/api/mcp",
        "transport": "streamable-http",
        "headers": {
          "x-api-key": "bloom_sk_..."
        }
      }
    }
  }
}

Hermes Agent

Add the server, and paste your key when Hermes prompts for authentication:

hermes mcp add bloom --url https://www.trybloom.ai/api/mcp

When it asks about authentication, paste your bloom_sk_... key. Verify with hermes mcp test bloom.

​Sign in with Bloom

​Claude

​Claude Code

​Cursor

​VS Code

​ChatGPT

​OpenClaw

​Hermes Agent

​API keys

​Claude Code

​Cursor

​VS Code

​Claude

​OpenClaw

​Hermes Agent

Sign in with Bloom

Claude

Claude Code

Cursor

VS Code

ChatGPT

OpenClaw

Hermes Agent

API keys

Claude Code

Cursor

VS Code

Claude

OpenClaw

Hermes Agent