Skip to content

Sending SMS from an AI assistant (MCP)

Updated:

On this page

MCP is a shared “plug” that lets an AI assistant, for example Claude, Codex or Cursor, use outside tools. Here the tools are sending and reading SMS. The assistant works on your account, from your phone and within your allowance.

How to set it up

  1. In the dashboard open the AI agents section.
  2. In the step “Give your agent its own API key” click “Create a key for the agent”. Each agent should have its own key, so you can revoke one without breaking the others.
  3. In the step “Copy the prompt for your agent” pick your agent and click “Copy prompt”. Paste it into the agent. The prompt contains your key, so paste it only into your own agent.
  4. In the step “Check that it works” ask the agent, for example, to show the phones connected to your account.

After the restart the agent asks for your confirmation of the number and the exact text before every SMS.

What to expect

The assistant gets six tools: list phones, statistics, message history, incoming SMS, sending and checking the send status. One send can have up to 50 numbers. The server's reply does not yet prove delivery, so ask the agent to check the status.

OAuth login is not supported. Your client must be able to send a custom header with the key. If yours cannot, the MCP guide shows a workaround for Claude Desktop.

What next

Questions and answers

What can an AI assistant do?
Show the phones connected to your account, read incoming SMS and history, check statistics and send an SMS to the numbers you name from your own phone.
Can I block sending and allow reading only?
Yes, but only on your own MCP server. Setting SMSPORTAL_READ_ONLY=true removes the sending tool. The details are in the MCP server description.

Didn’t find the answer? Contact us

Send your first SMS today

Create a free account, connect your phone and see how customers respond to messages from your number.