How to integrate Teltel MCP with Atomic Agent

Connect Atomic Agent to Teltel MCP. Retrieve all missed calls from today, list all sms messages from specific number, and more using natural language, with authentication handled for you.

Teltel logoTeltel
Api Key

Teltel is a telecom operator and software platform for automated voice and SMS communication. It streamlines contact center management and programmable communication for businesses.

26 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 Teltel.

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

Also integrate Teltel with

How Atomic Agent connects to Teltel

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

The Teltel MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Teltel account. It provides structured and secure access to your telecom data, so your agent can retrieve call logs, manage SMS messages, access user records, and handle inbound SMS events automatically.

  • Comprehensive call log retrieval: Quickly fetch and filter detailed lists of your recent and historical calls, including duration, status, and time for easy reporting or analysis.
  • SMS message management: Effortlessly access sent and received SMS logs, filter messages by sender, recipient, status, or date, and keep your communications organized.
  • User directory synchronization: Retrieve up-to-date lists of all users in your Teltel account, making it simple to manage contact center agents or team members.
  • Automated inbound SMS handling: Set up your agent to receive and process incoming SMS via webhook, so you never miss an important customer message or support request.

Use Teltel from Atomic Agent

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

Create Autodialer Custom Status

Tool to create a custom status for autodialer contacts.

Create Call

Tool to create a call between two participants.

Create User Status

Tool to create a user status in TelTel.

Delete Autodialer Custom Status

Tool to delete an autodialer custom status by ID.

Delete User Status

Tool to delete a user status by ID.

Get Account Balance

Tool to retrieve the account balance for your TelTel account.

Get Call List

Tool to retrieve a list of calls with details (duration, time, status).

Get Country

Tool to retrieve country resource information by ID from TelTel.

Get SMS List

Tool to retrieve a list of sent (outbox) or received (inbox) SMS messages from TelTel.

Get User Caller ID Groups

Tool to retrieve caller ID groups for a specific user.

Get Users List

Tool to retrieve a list of users from your TelTel account.

List Autodialer Actions

Tool to retrieve the action history for an autodialer campaign.

List Autodialer Contacts

Tool to retrieve the contact list for an autodialer campaign.

List Autodialer Custom Statuses

Tool to retrieve list of autodialer custom statuses.

List Autodialer Campaigns

Tool to retrieve a list of autodialer campaigns from TelTel.

List Available Countries

Tool to get the list of countries where DID numbers are available for purchase.

List Country Price Groups

Tool to retrieve phone number price groups available in a specific country.

List Devices

Tool to retrieve a list of devices from your TelTel account.

List My Numbers

Tool to retrieve a list of phone numbers (DIDs) owned by the account.

List DID Orders

Tool to retrieve a list of DID (phone number) orders from TelTel.

List User Statuses

Tool to retrieve a list of all user statuses in TelTel.

Lookup Phone Number

Tool to perform HLR (Home Location Register) lookup for phone numbers via TelTel API.

Receive Inbound SMS

Tool to process inbound SMS webhook data from TelTel.

Set User Status

Tool to set a user's status in TelTel.

Update Autodialer Custom Status

Tool to update an autodialer custom status value by ID.

Update User Status

Tool to update an existing user status in TelTel.

FAQ

Frequently asked questions

With a standalone Teltel MCP server, the agents and LLMs can only access a fixed set of Teltel tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Teltel 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 Teltel tools.

Yes, absolutely. You can configure which Teltel 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 Teltel data and credentials are handled as safely as possible.

Start with Teltel.It takes 30 seconds.

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

Start building