Connect Bloom

Copy the Bloom MCP server URL:

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

Bloom supports two ways to authenticate:

Sign in with Bloom (OAuth) — the default for interactive clients. Sign in through a browser the first time the client connects.
API key — a static bloom_sk_... key for a server, continuous-integration job, automation host, or another environment without browser sign-in.

Create an API key from your account settings and treat it like a password. Reference it from an environment variable or secret store, never commit it or expose it client-side. The examples below use BLOOM_API_KEY where the client supports environment variables. An API key can use either header form; use the one your client expects:

x-api-key: bloom_sk_...

Authorization: Bearer bloom_sk_...

Choose your client

OAuth 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.

API key

claude.ai is sign-in only. Claude Desktop can use a key through the mcp-remote bridge, but the key is stored in plaintext in claude_desktop_config.json. Keep that file private and add Bloom under Settings → Developer → Edit Config:

{
  "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.

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.

API key

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_API_KEY}'

Set BLOOM_API_KEY before starting Claude Code. Add --scope user to make the server available across all your projects.

Codex CLI, the Codex IDE extension, and the ChatGPT desktop app share MCP configuration.

Add the server

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

codex mcp login bloom

Use /mcp inside Codex to confirm that Bloom is connected.

API key

Set BLOOM_API_KEY, then add Bloom to ~/.codex/config.toml or a trusted project’s .codex/config.toml:

[mcp_servers.bloom]
url = "https://www.trybloom.ai/api/mcp"
bearer_token_env_var = "BLOOM_API_KEY"

Add the server

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

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

API key

Add a headers block to the same file:

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

Set BLOOM_API_KEY before starting Cursor.

Add the server

Add Bloom to .vscode/mcp.json:

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

API key

Use an inputs block so VS Code prompts for the key once and stores it securely:

{
  "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}"
      }
    }
  }
}

The ChatGPT desktop app shares MCP configuration with Codex.

Open MCP settings

Open Settings → MCP servers and select Add server.

Add Bloom

Name the server Bloom, choose Streamable HTTP, and enter the Bloom MCP server URL.

Restart and sign in

Save the server, restart the app, then select Authenticate and sign in with Bloom. Use /mcp in the composer to confirm the connection.

ChatGPT on the web uses MCP tools supplied through installed workspace plugins. Bloom does not currently document a public ChatGPT web installation path.

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.

API key

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

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 key

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

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

Verify the connection with hermes mcp test bloom.

Getting started

Guides

MCP

Connect Bloom

Choose your client

API key

API key

API key

API key

API key

API key

API key

​Choose your client

​Sign in with Bloom

​API key

​Sign in with Bloom

​API key

​Sign in with Bloom

​API key

​Sign in with Bloom

​API key

​Sign in with Bloom

​API key

​Sign in with Bloom

​API key

​Sign in with Bloom

​API key

Choose your client

Sign in with Bloom

API key

Sign in with Bloom

API key

Sign in with Bloom

API key

Sign in with Bloom

API key

Sign in with Bloom

API key

Sign in with Bloom

API key

Sign in with Bloom

API key