Skip to main content
OpenClaw is a personal AI agent you run yourself, configured through a JSON5 file. It connects to remote MCP servers over streamable HTTP, and Bland’s hosted MCP server is exactly that, so an OpenClaw agent can place calls, send texts, and read the results. There are two ways to connect, depending on whether you already have a Bland account. Setting up a different assistant? See Personal AI Agents.

​
Prerequisites

  • A running OpenClaw gateway
  • Optional: a payment card for the Agent Phone Plan ($14.99 first month, then $29.99/month, includes a US phone number). Without it, the agent connects on $2 of free credits, calls from a shared Bland number, and can’t text.

​
Option 1: You have a Bland API key

  1. Export your Bland API key from the dashboard in the environment that runs OpenClaw, so it never lands in the config file:
  2. Add the server under mcp.servers in ~/.openclaw/openclaw.json:
    With the Gateway running and hot reload enabled, config changes apply automatically. Otherwise restart OpenClaw.
  3. Verify the connection and list the Bland tools:
  4. Ask your agent to make a call:
Bland’s tools go through OpenClaw’s normal tool-profile and tool-policy controls. Keep confirmation on for tools that place calls or publish agents: they have real-world side effects. To give the agent its own number, so it can receive calls and send texts, subscribe to the Agent Phone Plan at Billing & Plans. The plan provisions a US number within a few seconds. Ask “what’s my Bland phone number?” and the agent reads it from your account and uses it from then on.

​
Option 2: Let the agent set itself up

This workflow requires your agent to make HTTP requests, poll for approval, store the returned key in its environment, and edit your OpenClaw configuration. Enable those capabilities before proceeding, or create your Bland account in the dashboard and use Option 1.
If your agent has access to an agent wallet that can approve payments, it can skip the browser step entirely: see Headless agent onboarding. The agent pays for its own number, and your only manual step is relaying a text-message code. Without a wallet, use the link-based flow below.
Tell the agent:
Once the agent starts the device flow, it shows you a link and a short code. Open the link, sign up or sign in, then either start the Agent Phone Plan or continue with free credits, and approve the request. After the agent retrieves its API key, and its phone number if you chose the plan, verify the connection with openclaw mcp doctor bland --probe. If it cannot update the environment or configuration, finish those steps manually as in Option 1. If your agent runs where Node.js is available, it can instead run the Bland CLI’s MCP server, which handles the same flow as two tools and stores the key for you. See the Agent onboarding API. The key is scoped to a new organization that belongs to you. Revoke it any time from Settings > API Keys.

​
What the agent can do

On the Agent Phone Plan, calls and texts are limited to US and Canadian numbers, one call at a time, up to 60 minutes per outbound call, and up to 100 texts a day. See Limits.

​
Next steps

Personal AI Agents

Two-way texting, troubleshooting, and the general pattern.

Tool reference

Every tool the server exposes.
Docs for agents: llms.txt