How to integrate CallOnTheGo MCP with Atomic Agent

Connect Atomic Agent to CallOnTheGo MCP. List active phone numbers and statuses, create a voice campaign with audio, and more using natural language, with authentication handled for you.

CallOnTheGo logoCallOnTheGo
Api Key

CallOnTheGo is a telephony API for managing phone numbers, caller IDs, suppression lists, audio assets, contact lists, and Voice AI campaigns. It provides programmatic control over calling infrastructure and campaign automation for scalable voice outreach.

29 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,500+ apps through Composio, including CallOnTheGo.

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 CallOnTheGo account. See the Atomic Agent documentation for installation instructions.

Also integrate CallOnTheGo with

How Atomic Agent connects to CallOnTheGo

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 CallOnTheGo 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 CallOnTheGo. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your CallOnTheGo 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 CallOnTheGo MCP server, and what's possible with it?

The CallOnTheGo MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your CallOnTheGo account. It provides structured and secure access so your agent can perform CallOnTheGo operations on your behalf.

Use CallOnTheGo from Atomic Agent

With your account connected, ask Atomic Agent to work with CallOnTheGo 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 CallOnTheGo action and event your agent gets out of the box.

Add Suppression Entry

Idempotently add one phone number to the Do-Not-Call list.

Cancel Campaign

Irreversibly cancel a campaign and mark its queued or pending recipients cancelled.

Create Caller ID

Add a caller ID and initiate a telecom-provider verification call to confirm ownership.

Create Campaign

Create a draft Voice AI campaign from explicit caller ID, contact list, and audio resources.

Delete Caller ID

Permanently remove an owned caller ID configuration.

Delete Phone Number

Permanently remove an owned phone-number configuration by ID; deleting a missing ID also reports success.

Get Campaign

Get one campaign's configuration, lifecycle state, resource names, delivery metrics, and cost metrics.

Get Dashboard Stats

Return account-level call, contact, group, list, success-rate, and recent-activity summary metrics.

Get Voice Readiness

Return runtime readiness, telecom provider assignment, and supported capabilities for diagnosing whether voice campaigns can run.

Launch Campaign

Validate compliance, provision telecom isolation if needed, and launch a campaign.

List Audio Assets

List campaign audio assets with playback, duration, transcript, and compliance details.

List Caller IDs

List owned caller IDs with ownership-verification status and inbound-campaign assignment.

List Calls

Return one page of account call records for outcome and duration review, with an opaque cursor for the next page.

List Campaign Events

List only the newest 100 delivery events for a campaign, ordered newest first.

List Campaign Recipients

List all recipients for a campaign with call status, attempts, machine detection, and cost estimates.

List Campaigns

List Voice AI campaigns with lifecycle state, linked resources, calling window, rate, estimated cost, compliance state, and timestamps.

List Contact Lists

List campaign contact lists with valid, invalid, suppressed, and total recipient counts.

List Contacts

Return one page of contacts from the connected CallOnTheGo account for CRM lookup, with an opaque cursor for the next page.

List Phone Numbers

List phone numbers owned by the connected CallOnTheGo account, including the resource records needed to identify numbers for later management.

List Suppression Entries

List Do-Not-Call suppression entries for the connected account.

Pause Campaign

Pause a running campaign while retaining its pending recipients for a later resume.

Queue Campaign Lead

Queue one phone-number lead for dialing by a running campaign.

Resume Campaign

Resume a paused campaign and immediately requeue its pending recipients for calls.

Set Caller ID Inbound Campaign

Set or clear the preferred inbound campaign assigned to an owned caller ID.

Update Campaign

Update selected configuration fields on a draft or paused campaign.

Upload Audio Asset

Upload an MP3 or WAV file as a reusable campaign audio asset.

Upload Contact List

Create a campaign contact list from a CSV file.

Upload Suppression CSV

Persistently add many phone numbers to the Do-Not-Call list from a CSV file.

Verify Caller ID

Submit an ownership-verification code for an existing caller ID and return whether it became verified or remains pending.

FAQ

Frequently asked questions

With a standalone CallOnTheGo MCP server, the agents and LLMs can only access a fixed set of CallOnTheGo tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from CallOnTheGo and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right CallOnTheGo tools.

Yes, absolutely. You can configure which CallOnTheGo scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your CallOnTheGo data and credentials are handled as safely as possible.

Start with CallOnTheGo.It takes 30 seconds.

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

Start building