# How to integrate CallOnTheGo MCP with Atomic Agent

```json
{
  "title": "How to integrate CallOnTheGo MCP with Atomic Agent",
  "toolkit": "CallOnTheGo",
  "toolkit_slug": "callonthego",
  "framework": "Atomic Agent",
  "framework_slug": "atomic-agent",
  "url": "https://composio.dev/toolkits/callonthego/framework/atomic-agent",
  "markdown_url": "https://composio.dev/toolkits/callonthego/framework/atomic-agent.md",
  "updated_at": "2026-08-27T05:37:04.765Z"
}
```

## 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](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions.

## Also integrate CallOnTheGo with

- [ChatGPT](https://composio.dev/toolkits/callonthego/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/callonthego/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/callonthego/framework/hermes-agent)

## TL;DR

### 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

### Connect CallOnTheGo to Atomic Agent
- Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key.
- 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.
- Ask Atomic Agent to do something in CallOnTheGo. It searches Composio for the right tool.
- 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.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `CALLONTHEGO_ADD_SUPPRESSION_ENTRY` | Add Suppression Entry | Idempotently add one phone number to the Do-Not-Call list. This change persists indefinitely because the API provides no removal route. |
| `CALLONTHEGO_CANCEL_CAMPAIGN` | Cancel Campaign | Irreversibly cancel a campaign and mark its queued or pending recipients cancelled. This changes the campaign to a terminal state but does not delete its record. |
| `CALLONTHEGO_CREATE_CALLER_ID` | Create Caller ID | Add a caller ID and initiate a telecom-provider verification call to confirm ownership. Returns the caller-ID resource ID and verification code needed to complete verification; this does not launch a campaign. |
| `CALLONTHEGO_CREATE_CAMPAIGN` | Create Campaign | Create a draft Voice AI campaign from explicit caller ID, contact list, and audio resources. This only saves a draft: it does not launch the campaign, place or queue calls, or incur call charges. Use the separate launch action when calling should begin. |
| `CALLONTHEGO_DELETE_CALLER_ID` | Delete Caller ID | Permanently remove an owned caller ID configuration. |
| `CALLONTHEGO_DELETE_PHONE_NUMBER` | Delete Phone Number | Permanently remove an owned phone-number configuration by ID; deleting a missing ID also reports success. |
| `CALLONTHEGO_GET_CAMPAIGN` | Get Campaign | Get one campaign's configuration, lifecycle state, resource names, delivery metrics, and cost metrics. |
| `CALLONTHEGO_GET_DASHBOARD_STATS` | Get Dashboard Stats | Return account-level call, contact, group, list, success-rate, and recent-activity summary metrics. |
| `CALLONTHEGO_GET_VOICE_READINESS` | Get Voice Readiness | Return runtime readiness, telecom provider assignment, and supported capabilities for diagnosing whether voice campaigns can run. |
| `CALLONTHEGO_LAUNCH_CAMPAIGN` | Launch Campaign | Validate compliance, provision telecom isolation if needed, and launch a campaign. Launching immediately queues eligible recipients for calls and may incur call charges. |
| `CALLONTHEGO_LIST_AUDIO_ASSETS` | List Audio Assets | List campaign audio assets with playback, duration, transcript, and compliance details. |
| `CALLONTHEGO_LIST_CALLER_IDS` | List Caller IDs | List owned caller IDs with ownership-verification status and inbound-campaign assignment. |
| `CALLONTHEGO_LIST_CALLS` | List Calls | Return one page of account call records for outcome and duration review, with an opaque cursor for the next page. |
| `CALLONTHEGO_LIST_CAMPAIGN_EVENTS` | List Campaign Events | List only the newest 100 delivery events for a campaign, ordered newest first. CallOnTheGo provides no cursor or continuation mechanism, so events older than this fixed window cannot be retrieved with this tool. |
| `CALLONTHEGO_LIST_CAMPAIGN_RECIPIENTS` | List Campaign Recipients | List all recipients for a campaign with call status, attempts, machine detection, and cost estimates. CallOnTheGo does not paginate this endpoint, so campaigns with many recipients can return a large response. |
| `CALLONTHEGO_LIST_CAMPAIGNS` | List Campaigns | List Voice AI campaigns with lifecycle state, linked resources, calling window, rate, estimated cost, compliance state, and timestamps. |
| `CALLONTHEGO_LIST_CONTACT_LISTS` | List Contact Lists | List campaign contact lists with valid, invalid, suppressed, and total recipient counts. |
| `CALLONTHEGO_LIST_CONTACTS` | List Contacts | Return one page of contacts from the connected CallOnTheGo account for CRM lookup, with an opaque cursor for the next page. |
| `CALLONTHEGO_LIST_PHONE_NUMBERS` | List Phone Numbers | List phone numbers owned by the connected CallOnTheGo account, including the resource records needed to identify numbers for later management. |
| `CALLONTHEGO_LIST_SUPPRESSION_ENTRIES` | List Suppression Entries | List Do-Not-Call suppression entries for the connected account. |
| `CALLONTHEGO_PAUSE_CAMPAIGN` | Pause Campaign | Pause a running campaign while retaining its pending recipients for a later resume. The campaign must currently be running. |
| `CALLONTHEGO_QUEUE_CAMPAIGN_LEAD` | Queue Campaign Lead | Queue one phone-number lead for dialing by a running campaign. This can place a call and incur charges; suppressed or already-active leads may return without a new dial. |
| `CALLONTHEGO_RESUME_CAMPAIGN` | Resume Campaign | Resume a paused campaign and immediately requeue its pending recipients for calls. Resuming can place calls and incur call charges. |
| `CALLONTHEGO_SET_CALLER_ID_INBOUND_CAMPAIGN` | Set Caller ID Inbound Campaign | Set or clear the preferred inbound campaign assigned to an owned caller ID. |
| `CALLONTHEGO_UPDATE_CAMPAIGN` | Update Campaign | Update selected configuration fields on a draft or paused campaign. Running, completed, cancelled, and failed campaigns reject updates. Only explicitly supplied fields are changed. |
| `CALLONTHEGO_UPLOAD_AUDIO_ASSET` | Upload Audio Asset | Upload an MP3 or WAV file as a reusable campaign audio asset. This creates stored account data but does not place calls; the API provides no route to delete the stored asset. |
| `CALLONTHEGO_UPLOAD_CONTACT_LIST` | Upload Contact List | Create a campaign contact list from a CSV file. CallOnTheGo normalizes phone numbers, removes duplicates, filters suppressed recipients, and persists the resulting contacts without placing calls. The API provides no route to delete the resulting contact list. |
| `CALLONTHEGO_UPLOAD_SUPPRESSION_CSV` | Upload Suppression CSV | Persistently add many phone numbers to the Do-Not-Call list from a CSV file. Duplicate entries are skipped. This bulk change cannot be undone through the API because no suppression-removal route is available. |
| `CALLONTHEGO_VERIFY_CALLER_ID` | Verify Caller ID | Submit an ownership-verification code for an existing caller ID and return whether it became verified or remains pending. |

## Supported Triggers

None listed.

## 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](/pricing) for the current limits that apply to your connection.

## Complete Code

None listed.

## Conclusion

### 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](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo).

## How to build CallOnTheGo MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/callonthego/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/callonthego/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/callonthego/framework/hermes-agent)

## Related Toolkits

- [Gmail](https://composio.dev/toolkits/gmail) - Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable.
- [Outlook](https://composio.dev/toolkits/outlook) - Outlook is Microsoft's email and calendaring platform for unified communications and scheduling. It helps users stay organized with powerful email, contacts, and calendar management.
- [Slack](https://composio.dev/toolkits/slack) - Slack is a channel-based messaging platform for teams and organizations. It helps people collaborate in real time, share files, and connect all their tools in one place.
- [Gong](https://composio.dev/toolkits/gong) - Gong is a platform for video meetings, call recording, and team collaboration. It helps teams capture conversations, analyze calls, and turn insights into action.
- [Microsoft teams](https://composio.dev/toolkits/microsoft_teams) - Microsoft Teams is a collaboration platform that combines chat, meetings, and file sharing within Microsoft 365. It keeps distributed teams connected and productive through seamless virtual communication.
- [Slackbot](https://composio.dev/toolkits/slackbot) - Slackbot is a conversational automation tool for Slack that handles reminders, notifications, and automated responses. It boosts team productivity by streamlining onboarding, answering FAQs, and managing timely alerts—all right inside Slack.
- [2chat](https://composio.dev/toolkits/_2chat) - 2chat is an API platform for WhatsApp and multichannel text messaging. It streamlines chat automation, group management, and real-time messaging for developers.
- [Agent mail](https://composio.dev/toolkits/agent_mail) - Agent mail provides AI agents with dedicated email inboxes for sending, receiving, and managing emails. It empowers agents to communicate autonomously with people, services, and other agents—no human intervention needed.
- [Android Texter](https://composio.dev/toolkits/android_texter) - Android Texter is an API service that connects Android phones to SMS, MMS, contacts, and device data. Use it to automate mobile messaging without building your own phone-to-API bridge.
- [Basecamp](https://composio.dev/toolkits/basecamp) - Basecamp is a project management and team collaboration tool by 37signals. It helps teams organize tasks, share files, and communicate efficiently in one place.
- [Blooio](https://composio.dev/toolkits/blooio) - Blooio is a stable v2 API platform for messaging, chats, contacts, groups, phone numbers, and account analytics. It gives teams a clean way to build reliable communication workflows without stitching together fragile custom APIs.
- [Carbon Voice MCP](https://composio.dev/toolkits/carbon_voice_mcp) - Carbon Voice MCP is a voice-first collaboration platform for messages, conversations, and workflows. Use it to centralize voice communications and streamline team collaboration.
- [CardClan](https://composio.dev/toolkits/cardclan) - CardClan is a digital card platform for creating and sending personalized team cards. Use it to celebrate moments, share card links, and manage card workflows without extra coordination.
- [Chatwork](https://composio.dev/toolkits/chatwork) - Chatwork is a team communication platform with group chats, file sharing, and task management. It helps businesses boost collaboration and streamline productivity.
- [Clickmeeting](https://composio.dev/toolkits/clickmeeting) - ClickMeeting is a cloud-based platform for running online meetings and webinars. It helps businesses and individuals host, manage, and engage virtual audiences with ease.
- [Confluence](https://composio.dev/toolkits/confluence) - Confluence is Atlassian's team collaboration and knowledge management platform. It helps your team organize, share, and update documents and project content in one secure workspace.
- [Daily](https://composio.dev/toolkits/daily) - Daily is a WebRTC video and audio API platform for building rooms, meetings, recordings, live streams, transcriptions, and telephony. It gives developers reliable real-time media infrastructure without managing complex conferencing stacks.
- [Dailybot](https://composio.dev/toolkits/dailybot) - DailyBot streamlines team collaboration with chat-based standups, reminders, and polls. It keeps work flowing smoothly in your favorite messaging platforms.
- [Dialmycalls](https://composio.dev/toolkits/dialmycalls) - Dialmycalls is a mass notification service for sending voice and text messages to contacts. It helps teams and organizations quickly broadcast urgent alerts and updates.
- [Dialpad](https://composio.dev/toolkits/dialpad) - Dialpad is a cloud-based business phone and contact center system for teams. It unifies voice, video, messaging, and meetings across your devices.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and CallOnTheGo MCP?

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.

### Can I use Tool Router MCP with Atomic Agent?

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.

### Can I manage the permissions and scopes for CallOnTheGo while using Tool Router?

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.

### How safe is my data with Composio Tool Router?

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.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)
