# Teltel — how to use (mcp.ai)

Connect your Teltel account and use 26 tools for phone and SMS straight from your AI agent. Connect with your own API key. TelTel is a telecom operator and software provider offering tools for automated voice and SMS communication, including cloud-based contact center software, Voice/SMS API, VoIP/SIP trunking, auto dialer, webphone integration, Click2Call, and webhook-based call event tracking for CRM integration.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_teltel?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `teltel_create_autodialer_custom_status`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/teltel`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/teltel/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/teltel/create/autodialer/custom/status` — Tool to create a custom status for autodialer contacts. Use when you need to add a new status option that agents can use to categorize contacts in the Operator Dashboard.
  - body: { value: string }
- `POST https://api.mcp.ai/api/teltel/create/call` — Tool to create a call between two participants. Use when you need to initiate an outbound call connecting a caller to a destination number.
  - body: { caller_number: string, destination_number: string, destination_displayname: string }
- `POST https://api.mcp.ai/api/teltel/create/user/status` — Tool to create a user status in TelTel. Use when you need to add a new status option for users.
  - body: { data: object }
- `POST https://api.mcp.ai/api/teltel/delete/autodialer/custom/status` — Tool to delete an autodialer custom status by ID. Use when you need to remove a custom status from your autodialer configuration.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/teltel/delete/user/status` — Tool to delete a user status by ID. Use when you need to remove an existing user status from TelTel.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/teltel/get/account/balance` — Tool to retrieve the account balance for your TelTel account. Use when you need to check available credit or account balance information.
- `POST https://api.mcp.ai/api/teltel/get/call/list` — Tool to retrieve a list of calls with details (duration, time, status). Use when you need to filter and page through call records.
  - body: { page?: integer, limit?: integer, search?: string, status?: string, direction?: string, sort_field?: string, sort_order?: string, to_datetime?: string, from_datetime?: string }
- `POST https://api.mcp.ai/api/teltel/get/country` — Tool to retrieve country resource information by ID from TelTel. Use when you need to fetch details about a specific country for DID number provisioning.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/teltel/get/sms/list` — Tool to retrieve a list of sent (outbox) or received (inbox) SMS messages from TelTel. Use when you need to filter or paginate through SMS message history. Supports filtering by date, sender, recipien
  - body: { sort?: string, limit?: integer, fields?: string, filter?: string, offset?: integer, message_type?: string }
- `POST https://api.mcp.ai/api/teltel/get/user/cid/groups` — Tool to retrieve caller ID groups for a specific user. Use when you need to fetch the list of CID groups associated with a user account.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/teltel/get/users/list` — Tool to retrieve a list of users from your TelTel account. Use when you need to page through or synchronize user records.
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/teltel/list/auto/dialers` — Tool to retrieve a list of autodialer campaigns from TelTel. Use when you need to view all autodialer campaigns and their details.
  - body: { fields?: string }
- `POST https://api.mcp.ai/api/teltel/list/autodialer/actions` — Tool to retrieve the action history for an autodialer campaign. Use when you need to view the list of actions performed on a specific autodialer campaign.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/teltel/list/autodialer/contacts` — Tool to retrieve the contact list for an autodialer campaign. Use when you need to view contacts, filter by phone number or start time, or paginate through campaign contacts.
  - body: { id: integer, sort?: string, limit?: integer, fields?: string, filter?: string, offset?: integer }
- `POST https://api.mcp.ai/api/teltel/list/autodialer/custom/statuses` — Tool to retrieve list of autodialer custom statuses. Use when you need to view all available custom statuses for autodialer campaigns.
- `POST https://api.mcp.ai/api/teltel/list/available/countries` — Tool to get the list of countries where DID numbers are available for purchase. Use when you need to discover which countries support phone number provisioning or filter countries by pricing and featu
  - body: { filter?: string }
- `POST https://api.mcp.ai/api/teltel/list/country/price/groups` — Tool to retrieve phone number price groups available in a specific country. Use when you need to view pricing tiers or filter available phone number groups by country.
  - body: { id: integer, limit?: integer, filter?: string, offset?: integer }
- `POST https://api.mcp.ai/api/teltel/list/devices` — Tool to retrieve a list of devices from your TelTel account. Use when you need to view all registered devices and their connection status.
- `POST https://api.mcp.ai/api/teltel/list/my/numbers` — Tool to retrieve a list of phone numbers (DIDs) owned by the account. Use when you need to view all purchased phone numbers or filter by activation status, auto-renew settings, or SMS/voice support.
  - body: { limit?: integer, filter?: string, offset?: integer }
- `POST https://api.mcp.ai/api/teltel/list/orders` — Tool to retrieve a list of DID (phone number) orders from TelTel. Use when you need to check order status, view order history, or filter orders by specific criteria like status or type.
  - body: { filter?: string }
- `POST https://api.mcp.ai/api/teltel/list/user/statuses` — Tool to retrieve a list of all user statuses in TelTel. Use when you need to view available status options for users.
- `POST https://api.mcp.ai/api/teltel/lookup/phone/number` — Tool to perform HLR (Home Location Register) lookup for phone numbers via TelTel API. Use when you need to verify phone number validity, check network status, or retrieve carrier information. Supports
  - body: { numbers: string }
- `POST https://api.mcp.ai/api/teltel/receive/inbound/sms` — Tool to process inbound SMS webhook data from TelTel. Use this to handle incoming SMS notifications that TelTel sends to your configured webhook URL. This action parses and validates the webhook paylo
  - body: { to: string, time: string, msgid: string, message: string, encoding?: string, from_number: string }
- `POST https://api.mcp.ai/api/teltel/set/user/status` — Tool to set a user's status in TelTel. Use when you need to update a user's availability or activity status.
  - body: { data: object, user_id: integer }
- `POST https://api.mcp.ai/api/teltel/update/autodialer/custom/status` — Tool to update an autodialer custom status value by ID. Use when you need to rename or modify an existing custom status label.
  - body: { id: integer, value: string }
- `POST https://api.mcp.ai/api/teltel/update/user/status` — Tool to update an existing user status in TelTel. Use when you need to modify the name, enabled state, or offline state of a user status.
  - body: { id: integer, data: object }

## Example prompts
- "What can I do in Teltel?"
- "Show me a summary of my Teltel account"

## More
- Page: https://mcp.ai/teltel
- Agent spec (llms.txt): https://mcp.ai/teltel/llms.txt
- Postman collection: https://mcp.ai/teltel/postman.json