Connect Bloom

Copy the Bloom MCP server URL:

https://mcp.trybloom.ai/mcp

Bloom supports two ways to authenticate:

Sign in with Bloom (OAuth) — the default for interactive clients. Sign in through a browser when your client prompts you.
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

Connector availability and permissions depend on your Claude account and workspace policy. See Claude’s current requirements.

Open the connector settings

On Free, Pro, or Max, go to Customize → Connectors → Add custom connector. On Team or Enterprise, an owner first adds Bloom under Organization settings → Connectors; members then connect under Customize → Connectors.

Add the server

Paste the server URL and click Connect.

API key

Static request headers are in beta for eligible organizations. If your connector settings offer them, choose no sign-in and add an x-api-key header with your Bloom key. Otherwise, use OAuth above.

Add the server

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

By default, Bloom is available only to you in the current project. Add --scope user to make it available across all your projects.

Run /mcp inside Claude Code and sign in with Bloom when prompted. Use /mcp again to confirm that Bloom is connected.

API key

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

claude mcp add --transport http bloom https://mcp.trybloom.ai/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://mcp.trybloom.ai/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://mcp.trybloom.ai/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://mcp.trybloom.ai/mcp"
    }
  }
}

API key

Add a headers block to the same file:

{
  "mcpServers": {
    "bloom": {
      "url": "https://mcp.trybloom.ai/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://mcp.trybloom.ai/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://mcp.trybloom.ai/mcp",
      "headers": {
        "x-api-key": "${input:bloom-api-key}"
      }
    }
  }
}

Custom MCP server availability depends on your ChatGPT plan and workspace settings. Check ChatGPT availability.Add Bloom as a custom MCP server, then install it as a plugin.

Open ChatGPT Plugins

Select +, then choose Add custom MCP server.

Add Bloom

Name the server Bloom and use The brand layer for agents. as its description. Under Connection, enter the Server URL and choose OAuth authentication:

Field	Value
Server URL	`https://mcp.trybloom.ai/mcp`
Authentication	OAuth

Create and install the plugin

Acknowledge the risk notice, choose Create as a plugin, then install it. Sign in with Bloom when prompted.

Open ChatGPT Plugins · ChatGPT plugin setup guide

Add the server

openclaw mcp set bloom '{"url":"https://mcp.trybloom.ai/mcp","transport":"streamable-http","auth":"oauth"}'

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

Verify the connection

openclaw mcp doctor bloom --probe

API key

Set BLOOM_API_KEY, then configure the Authorization header:For a gateway or background service, set BLOOM_API_KEY in that process’s environment, a .env file in its working directory, or ~/.openclaw/.env; it may not inherit your shell export.

openclaw mcp set bloom '{"url":"https://mcp.trybloom.ai/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${BLOOM_API_KEY}"}}'

Omit auth: "oauth" when using an API key; OpenClaw ignores static Authorization headers in OAuth mode. Verify with openclaw mcp doctor bloom --probe.

Add the server

hermes mcp add bloom --url https://mcp.trybloom.ai/mcp --auth oauth

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

API key

Run this command, then paste the API key when prompted:

hermes mcp add bloom --url https://mcp.trybloom.ai/mcp --auth header

Verify the connection with hermes mcp test bloom.

After setup, confirm the connection by asking your agent to check the connected Bloom account and list your brands.

Getting started

Guides

Use cases

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