> For the complete documentation index, see [llms.txt](https://docs.borndigital.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.borndigital.ai/realtime-agent/mcp-tools.md).

# MCP tools

Connect MCP servers so the realtime agent can look up and change data in your systems during a call.

A realtime agent works with your systems – a CRM, a billing system, an order database – through **MCP servers** (Model Context Protocol). Each server offers **tools**, for example `find_contract` or `create_ticket`. During the call, the model decides when to call a tool, based on the tool's description and your prompt.

## Connect an MCP server

1. Click **Agent** in the left column, then **+ MCP server** below **Identity**.
2. In **Connection**, enter the **URL** of the server.
3. If the server needs credentials, turn on **Authentication**, choose **API Key**, **Bearer** or **Basic** and enter the **Token**.
4. Click **Connect**. The **MCP tools** of the server appear.
5. Turn on **Enable MCP server** and choose the tools the agent may use.

The model provider calls the MCP server directly, so the server must be reachable from the internet. (The choice between **Cloud** and **Local** exists only in the AI node of a Digital Agent.)

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2Fgit-blob-aa217683b133dffc8820c7307e5a8d91a65530e0%2Frealtime-mcp-connect.png?alt=media" alt="A new MCP server card with Connection: Name, URL https://mcp.example.com/mcp, Authentication turned on with Bearer selected, the Token field and the Connect button; MCP tools say Connect to reveal relevant tools"><figcaption><p>Connecting an MCP server</p></figcaption></figure>

A server – and the same server URL – can be added only once.

{% hint style="info" %}
Only enable the tools the agent really needs, and describe in the prompt when to use them – for example *"Use find\_contract after the caller tells you the contract number."* Fewer, well-described tools give more reliable calls.
{% endhint %}

## MCP servers in skills

Each [skill](https://docs.borndigital.ai/realtime-agent/prompt-and-skills.md#skills) has its own **MCP servers** card. A skill can use only servers and tools that are configured on the agent. Tools enabled for the whole agent are available in every skill. If an option cannot be changed in a skill, see **Why aren't some MCP server options configurable?** in the editor.

## Built-in behaviour

* **Ending the call** – the agent can hang up by itself after saying goodbye. Tell it in the prompt when the conversation is over.
  * An MCP tool can also end a phone call after the agent's next answer: when the tool result carries `ai.borndigital/hangup_after_reply` set to `true` in its `_meta`, the agent says its reply to the tool output in full and then hangs up. Use it for closings that must be said word for word. If the caller speaks again before the end, the hang-up is cancelled.
* **Switching skills** – the agent switches between skills on its own.
* **No transfer to an operator** – a realtime agent cannot transfer the call. If callers must be able to reach a person, give them a phone number in the prompt, or use a [Digital Agent](https://docs.borndigital.ai/digital-agent/introduction.md) with a Transfer or Redirect node.
