TelTEL MCP server
34 operations0 webhooks
SMS and voice with TelTEL - send SMS one at a time or in bulk, read outbound and inbound message reports, run SMS campaigns, manage contacts and groups, place click-to-call calls, and read the DID numbers and countries on the account.
Try TelTEL with your agent
Connect TelTEL, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in TelTEL on my account, then run one read-only example and show me the result.
TelTEL tools and triggers
Tools are what your agent can do in TelTEL through Corsair's MCP server. Triggers are the TelTEL events a routine can start from.
Campaigns
- ActionDestructive
Start, pause or stop a campaign; start sends to every contact in its groups
campaigns.action
- CreateWrite
Create an SMS campaign for a set of contact groups; it does not send until `campaigns.action` starts it
campaigns.create
- DeleteDestructive
Delete an SMS campaign and its history
campaigns.delete
- GetRead-only
Read one SMS campaign by ID
campaigns.get
- ListRead-only
List SMS campaigns with their state, sender and rate
campaigns.list
- UpdateWrite
Change a campaign's title, sender, groups, message or rate
campaigns.update
Contact Groups
- ContactsRead-only
List the contacts in one group
contactGroups.contacts
- CreateWrite
Create a contact group
contactGroups.create
- DeleteDestructive
Delete a contact group and its contacts
contactGroups.delete
- GetRead-only
Read one contact group by ID
contactGroups.get
- ListRead-only
List contact groups with their contact counts
contactGroups.list
- UpdateWrite
Rename a contact group
contactGroups.update
Contacts
- CreateWrite
Add a contact to a contact group
contacts.create
- Create BulkWrite
Add many contacts in one call; a partial result reports which entries failed
contacts.createBulk
- DeleteDestructive
Delete a contact
contacts.delete
- GetRead-only
Read one contact by ID
contacts.get
- ListRead-only
List contacts with their group and custom fields
contacts.list
- UpdateWrite
Change a contact's phone, group or custom fields
contacts.update
Numbers
- GetRead-only
Read one DID number by ID
numbers.get
- ListRead-only
List the DID numbers on the account with their renewal date and SMS settings
numbers.list
- UpdateWrite
Change a number's auto-renew or SMS handler URL and email
numbers.update
Calls
- CreateDestructive
Place a click-to-call between two numbers, which bills per minute once answered
calls.create
- ListRead-only
List calls with their duration, cost and hangup reason, filtered by direction or start time
calls.list
Inbox
- GetRead-only
Read one inbound message by ID
inbox.get
- ListRead-only
List inbound messages with their sender and handler
inbox.list
Number Countries
- GetRead-only
Read one number country by ID
numberCountries.get
- ListRead-only
List the countries numbers can be ordered in, with their prefix and SMS support
numberCountries.list
Sms
- SendDestructive
Send one SMS from a verified number or sender ID, charging the account per part
sms.send
- Send BulkDestructive
Send many SMS in one call; a partial result answers 207 with the messages that failed
sms.sendBulk
Sms Reports
- GetRead-only
Read one outbound message report by ID
smsReports.get
- ListRead-only
List outbound messages with their state, price and delivery details, filtered by number or date
smsReports.list
Account
- BalanceRead-only
Read the account balance, its credit limit and the outstanding amount where one is owed
account.balance
Price Groups
- ListRead-only
List a country's price groups, whose IDs an order takes
priceGroups.list
Users
- ListRead-only
List the account users with their login and email; their API keys are left out
users.list
Connect TelTEL to Claude, ChatGPT or Cursor
- 1
Connect TelTEL in Corsair
Add your TelTEL API key once in Corsair. Corsair stores the credential encrypted and makes the TelTEL API calls for your agent, so it never goes into a prompt or a config file. Connect TelTEL
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs TelTEL. On a ChatGPT personal plan, connect TelTEL here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, TelTEL's read and write operations run right away and its 7 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/teltel, add the TelTEL plugin, and connect with an API key. Then call methods like corsair.teltel.api.account.balance() from your app. Corsair keeps each tenant isolated.
Yes. TelTEL requires an API key from your TelTEL account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit TelTEL, GitHub, Notion, Stripe, and the rest. Trigger TelTEL from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for SMS and voice with TelTEL - send SMS one at a time or in bulk, read outbound and inbound message reports, run SMS campaigns, manage contacts and groups, place click-to-call calls, and read the DID numbers and countries on the account. Common builds include sync jobs, admin tooling, and agents that call TelTEL APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per TelTEL API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/teltel in the open repo. When TelTEL ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your TelTEL data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store TelTEL data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put TelTEL on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 7 destructive TelTEL operations. You can change a link's mode at hub.corsair.dev/me.