How to integrate Bland AI MCP with Atomic Agent

Connect Atomic Agent to Bland AI MCP. Place appointment reminder calls to patients, review failed outbound call transcripts, and more using natural language, with authentication handled for you.

Bland AI logoBland AI
Api Key

Bland AI is a conversational AI platform for building voice agents, phone calls, messaging, and communication workflows. Use it to automate calling, evaluate conversations, and run voice operations at scale.

27 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Bland AI.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Bland AI account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Bland AI with

How Atomic Agent connects to Bland AI

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Bland AI to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Bland AI. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Bland AI account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Bland AI MCP server, and what's possible with it?

The Bland AI MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Bland AI account. It provides structured and secure access to your account details, call history, contacts, knowledge bases, pathways, and agent tools, so your agent can review calls, check account status, explore resources, inspect configurations, and organize pathway folders on your behalf.

  • Call history review: Have your agent search existing inbound and outbound calls to help you review recent communication activity.
  • Account status checks: Let the agent report your account status, call count, balance, and refill settings whenever you need an update.
  • Contacts and knowledge access: Direct your agent to list organization contacts or review available knowledge bases, including their processing status and source details.
  • Pathway and tool discovery: Instruct your agent to inspect conversational pathways and search the active or draft tools configured for your Bland AI agents.
  • Pathway folder organization: Have your agent create and rename pathway folders, review their organization, or delete empty folders you no longer need.

Use Bland AI from Atomic Agent

With your account connected, ask Atomic Agent to work with Bland AI in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Bland AI action and event your agent gets out of the box.

Add User to Memory

Add a phone-number user and optional initial context to an existing Bland memory.

Chat with Knowledge Base

Ask a question of one Bland AI knowledge base and return its grounded answer and supporting source chunks.

Create Agent Version

Save a complete agent configuration snapshot on the development timeline or an open branch without deploying it.

Create Pathway Folder

Create an empty pathway folder, optionally nested under an existing folder, without running calls or agents.

Delete Pathway Folder

Delete an empty pathway folder by ID; folders containing pathways or subfolders must be emptied first.

Get Account Details

Return the connected Bland AI account's status, call count, balance, and refill settings without changing the account.

Get Agent

Retrieve one Bland AI agent by ID, including its development, staging, and production environment version pointers.

Get Agent Version

Retrieve a specific published agent version by semantic version, including its full configuration snapshot and version metadata.

Get Knowledge Base

Retrieve one Bland AI knowledge base by ID, including its processing status, source details, and file metadata.

Get Latest Agent Version

Retrieve the newest saved version and full configuration snapshot for an agent's dev timeline or an open branch.

Get Pathway

Retrieve one Bland AI conversational pathway by ID, including its name, description, nodes, and edges.

Get Tool

Retrieve one legacy Bland AI custom tool by its TL-prefixed ID.

List Calls

Search the connected account's existing inbound and outbound call history without placing or modifying calls.

List Contacts

Return organization contacts and their identifiers and memory records one page at a time.

List Inbound Numbers

List inbound phone numbers configured for the connected Bland AI account, including each number's calling settings.

List Knowledge Bases

Return one page of the connected Bland AI organization's knowledge bases, including processing status, source details, and file metadata.

List Pathway Folders

Return all pathway folders and their parent relationships from Bland's US regional pathway service.

List Pathways

Return all conversational pathways, including their names, descriptions, nodes, and edges.

List Pathway Versions

List the saved versions of a conversational pathway with their version and revision metadata.

List Tools

Search and page through the active or draft tools configured for Bland agents.

List Voices

List every Bland voice available to the connected account with identifiers and synthesis attributes.

Release Agent Version

Publish a new snapshot, an existing saved version, or the latest saved version to staging, or promote the version currently in staging to production.

Rename Pathway Folder

Rename an existing pathway folder without moving or changing any pathways inside it.

Resolve Contact

Find a Bland contact by phone number, email, or external ID, creating one when no match exists.

Synthesize Speech

Generate Bland speech audio from text with a selected voice and return a downloadable WAV reference.

Update Contact

Update a Bland contact's name, email, external ID, or custom metadata.

Update Contact Facts

Merge structured facts into a Bland contact memory without deleting existing keys.

FAQ

Frequently asked questions

Start with Bland AI.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Bland AI tool your agent needs.Free to start.

Start building