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
- In the dashboard open the AI agents section.
- 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.
- 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.
- 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
- The full guide with ready entries for each client: the MCP integration.
- Managing keys: API keys.
- For your own programs see API for developers.
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.
Related guides
Didn’t find the answer? Contact us