Other Clients

The Bland MCP server speaks standard streamable HTTP, so any MCP client can connect. You need two things:

URL: https://api.bland.ai/v1/mcp
Header: Authorization: Bearer YOUR_BLAND_API_KEY

Get your key from the dashboard. Configs for the most common clients:

OpenAI Codex

Add to ~/.codex/config.toml:

[mcp_servers.bland]
url = "https://api.bland.ai/v1/mcp"
bearer_token_env_var = "BLAND_API_KEY"

Export BLAND_API_KEY in your shell profile, then restart Codex. If your Codex version has trouble with HTTP servers, use the stdio bridge below.

VS Code (Copilot)

Install in VS Code, or add to .vscode/mcp.json:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "bland-api-key",
      "description": "Bland API key",
      "password": true
    }
  ],
  "servers": {
    "bland": {
      "type": "http",
      "url": "https://api.bland.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:bland-api-key}"
      }
    }
  }
}

VS Code prompts for the key on first use and stores it securely. It never lands in the config file.

Claude Desktop

Claude Desktop’s custom connectors expect OAuth, so use the stdio bridge with your API key instead. Add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "bland": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://api.bland.ai/v1/mcp",
        "--header", "Authorization: Bearer ${BLAND_API_KEY}"
      ],
      "env": { "BLAND_API_KEY": "org_your_key_here" }
    }
  }
}

Requires Node.js 18+. Restart Claude Desktop after saving.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "bland": {
      "serverUrl": "https://api.bland.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BLAND_API_KEY"
      }
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "bland": {
      "httpUrl": "https://api.bland.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BLAND_API_KEY"
      }
    }
  }
}

Any client / custom agents

For clients not listed here (or your own agent loop), either: Native HTTP: configure a streamable-HTTP MCP server with the URL and header above. Stdio bridge: if the client only supports stdio servers, mcp-remote bridges any of them to the Bland endpoint:

npx -y mcp-remote https://api.bland.ai/v1/mcp \
  --header "Authorization: Bearer $BLAND_API_KEY"

Raw JSON-RPC: the endpoint is plain HTTP POST, so you can drive it directly:

curl -X POST https://api.bland.ai/v1/mcp \
  -H "Authorization: Bearer $BLAND_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Next steps

Tool reference

Everything the MCP server can do.

MCP overview

Auth, rate limits, and how the server works.

Docs for agents: llms.txt

Welcome

Core Bland Features

Basic Tutorials

Advanced Features

Platform Information

SDKs & Tools

Bland Enterprise

Other Clients

OpenAI Codex

VS Code (Copilot)

Claude Desktop

Windsurf

Gemini CLI

Any client / custom agents

Next steps

Tool reference

MCP overview

​OpenAI Codex

​VS Code (Copilot)

​Claude Desktop

​Windsurf

​Gemini CLI

​Any client / custom agents

​Next steps

Tool reference

MCP overview

OpenAI Codex

VS Code (Copilot)

Claude Desktop

Windsurf

Gemini CLI

Any client / custom agents

Next steps