> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok Bot

> Give your Grok Bot a phone number and let it call and text through Bland

Grok Bot attaches remote MCP servers by URL. Bland's hosted MCP server is exactly that, so a Grok Bot can place calls, send texts, and read results with no code on your side.

There are two ways to connect, depending on whether you already have a Bland account.

## Prerequisites

* A [Grok Bot](https://grok.com) with MCP connectors enabled
* A payment card for the [Agent Phone Plan](/platform/agent-phone-plan) (\$29.99/month, includes a US phone number)

## Option 1: You have a Bland API key

1. In Grok Bot, open your bot's MCP settings and add a custom server.

2. Set the server URL to:

   ```
   https://api.bland.ai/v1/mcp
   ```

3. Add one header, using your API key from the [dashboard](https://app.bland.ai/dashboard/settings):

   ```
   Authorization: Bearer org_...
   ```

4. Ask your bot to make a call:

   ```
   Call +1 415 555 0123, introduce yourself as my assistant, and ask what time they close today.
   ```

To give the bot its own number, so it can receive calls and send texts, subscribe to the Agent Phone Plan at [Billing & Plans](https://app.bland.ai/dashboard/pay?tab=plan). The plan provisions a US number within a few seconds. Ask the bot "what's my Bland phone number?" and it reads the number from your account and uses it from then on.

## Option 2: Let your bot set itself up

If you do not have a Bland account, your bot can request its own access. Paste this into Grok Bot:

```
Read https://docs.bland.ai/platform/connect-your-agent and get yourself a Bland phone number. Show me the link and code when you have them. Once approved, add https://api.bland.ai/v1/mcp as an MCP server using the API key you receive, then call me at +1 415 555 0123 to confirm it works.
```

The bot starts the device flow, sends you a link and a short code, and waits. Open the link, sign up or sign in, subscribe to the Agent Phone Plan, and approve the request. The bot receives its own API key and phone number, connects the MCP server, and is ready to call and text.

The key is scoped to a new organization that belongs to you. You can revoke it any time from **Settings > API Keys**. If your bot cannot add MCP servers on its own, ask it for the key and add the server yourself as in Option 1.

## What the bot can do

| Ask for                              | What happens                                                                                      |
| ------------------------------------ | ------------------------------------------------------------------------------------------------- |
| "Call +1 ... and ask ..."            | Places an outbound call from the bot's number and returns the transcript and summary when it ends |
| "Text +1 ... saying ..."             | Sends an SMS from the bot's number                                                                |
| "What did they say on my last call?" | Reads the call transcript and analysis                                                            |
| "Create an agent that ..."           | Builds a reusable pathway the bot can call with later                                             |

Calls and texts are limited to US and Canadian numbers, one call at a time, up to 60 minutes per call. See [Limits](/platform/agent-phone-plan#limits).

## Troubleshooting

| Symptom                                                        | Cause                                           | Fix                                                                         |
| -------------------------------------------------------------- | ----------------------------------------------- | --------------------------------------------------------------------------- |
| Bot reports `PLAN_REQUIRED` or "not available"                 | The organization has no active Agent Phone Plan | Subscribe at [Billing & Plans](https://app.bland.ai/dashboard/pay?tab=plan) |
| Bot reports `CALL_PLAN_DESTINATION_BLOCKED`                    | The destination is outside the US and Canada    | Use a US or Canadian number                                                 |
| The approval link says the code expired                        | Codes last 15 minutes                           | Ask the bot to start again                                                  |
| Approval page says the request did not come from the dashboard | The link was opened in an embedded browser      | Open it in a normal browser tab                                             |

## Next steps

<CardGroup cols={2}>
  <Card title="Agent Phone Plan" icon="phone" href="/platform/agent-phone-plan">
    What's included, limits, and how to cancel.
  </Card>

  <Card title="Bland MCP Server" icon="plug" href="/integrations/mcp/overview">
    Every tool the server exposes and how authentication works.
  </Card>
</CardGroup>
