MCP SERVER · AI ASSISTANTS

Send SMS from your AI assistant

The touchSMS MCP server lets AI tools like Cursor and VS Code send texts, check costs, read replies and manage contacts on your account. Ask in plain English and approve what it does.

Get your API key See the setup

Nothing to install Uses your API key Preview cost before sending

Text Sam on 0412 345 678 that the server room alarm went off and to check it now.

list_sender_ids

+61 480 000 123 (virtual number)

estimate_sms

1 part · 1 message · 1 credit

send_sms

Queued to +61 412 345 678

Done. Sam has been sent the alert from your virtual number, so any reply comes back to your inbox.

TOOLS

Everything your assistant can do

Ten tools covering sending, replies, contacts and your account. Your assistant picks the right one from what you ask.

Send

send_sms
Send one or many SMS or MMS, now or scheduled, with opt-out lists and duplicate checks.
estimate_sms
Preview message parts and credit cost without sending anything.
list_sender_ids
See the sender IDs you can send from, filtered by recipient country.

Contacts & replies

list_inbound_messages
Read your latest replies, newest first, to summarise or follow up.
list_contacts
Search and page through your contacts.
create_contact
Add a contact with name, email, groups and custom fields, or update a match.

Account & webhooks

get_credit_balance
Check your remaining SMS credits.
get_account_info
See the account details and settings the key belongs to.
create_webhook_subscription
Send replies, delivery receipts or opt-outs to a URL of your choice.
list_webhook_subscriptions
List the webhooks already set up on your account.

SETUP

Connected in two minutes

In touchSMS, go to Settings > API Keys and create a key. Join the Token Id and Token Secret with a colon, then add the server to your MCP client:

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "touchsms": {
      "url": "https://app.touchsms.com.au/mcp",
      "headers": {
        "Authorization": "Bearer <token_id>:<token_secret>"
      }
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "touchsms": {
      "type": "http",
      "url": "https://app.touchsms.com.au/mcp",
      "headers": {
        "Authorization": "Bearer <token_id>:<token_secret>"
      }
    }
  }
}

Command lineterminal

claude mcp add --transport http touchsms https://app.touchsms.com.au/mcp \
  --header "Authorization: Bearer <token_id>:<token_secret>"

Endpoint: https://app.touchsms.com.au/mcp. Any client that supports remote HTTP servers with a custom Authorization header will work.

USE CASES

Ask for it, don't build it

Alerts from your dev tools
"Text the on-call engineer that the deploy failed." Send from the editor or terminal you already have open.
Reply triage
"Summarise today's SMS replies and list anyone asking for a call back." Your assistant reads the inbox for you.
Contact capture
"Add Jordan Lee, 0412 345 678, to the VIP group." Contacts go straight into touchSMS.
Wiring up integrations
"Send delivery receipts to our webhook endpoint." Set up webhooks without opening the docs.

IN CONTROL

Built to be safe

Cost preview firstYour assistant is told to check sender IDs and estimate the cost before it sends, so you can see the price and say no.
Opt-outs respectedMessages honour your opt-out lists, and duplicates to the same recipient can be rejected.
Your account onlyThe server acts as the account that owns the API key, with the same rate limits as the API. It never sees other accounts.
Revoke any timeDelete the key in Settings > API Keys and access stops straight away. The page also shows when each key was last used.

FAQ

Frequently asked questions

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants use outside tools. The touchSMS MCP server gives assistants like Cursor and VS Code a set of SMS tools they can call on your behalf.

Which apps does it work with?

Any MCP client that can connect to a remote HTTP server and send an Authorization header, including Cursor, VS Code and command-line coding assistants. There is nothing to install or run locally.

What does it cost?

Nothing extra. Messages you send through it are charged at your normal touchSMS rate, from 5c per SMS (ex GST). Reading replies, contacts and your balance is free.

Can my assistant send messages without asking me?

It can only do what your MCP client allows. Most clients ask you to approve each tool call, and the server tells the assistant to estimate the cost before sending. Treat your API key like a password, because anyone who has it can send messages and spend credits on your account.

Where do I get the token?

Sign in to touchSMS and go to Settings > API Keys. Create a key and join its Token Id and Token Secret with a colon: token_id:token_secret.

Can I use it for the same things as the API?

For everyday messaging, yes: sending, scheduling, MMS, contacts, replies and webhooks. For building it into your own software, use the SMS API directly.

Give your assistant SMS

Create a free account, make an API key and connect in a couple of minutes. Building your own app? Use the SMS API.

Start sending now API docs