The Sozuri MCP server gives ChatGPT, Claude, Cursor and the agents you build the whole Sozuri API as tools: SMS, WhatsApp, voice calls, one-time codes, premium SMS, contacts and M-Pesa payment requests. Add one URL, approve what the agent may do, and ask in plain words. It acts only within the permissions and daily limits you set, and you can cut it off with one click.
MCP (Model Context Protocol) is the open standard AI assistants use to find and call tools. Sozuri runs an MCP server, so any assistant that speaks MCP can use your Sozuri project without anyone writing integration code.
In ChatGPT, Claude, Cursor or your own agent, add https://mcp.sozuri.net/v1 as a custom MCP server. Every customer uses the same address. The setup guide has the steps for each.
Log in to Sozuri, choose the project the agent works for, and tick what it may do. Or create an MCP key on the project page for agents that take a header.
"Remind tomorrow's patients by WhatsApp." The agent picks the tools, shows you what it is about to send, and goes ahead when you confirm.
Each tool is one call to the same Sozuri API your developers use, with its validation, pricing, sender ID rules and Do-Not-Disturb list. An agent can do nothing the API would not let your own code do.
"Text the open-day group from SHULE: gates open at 8." Send now or schedule, from your own sender ID, to every Kenyan network. The agent is told which recipients were accepted and which were refused, and why.
sms_send
"Send Amina the order_ready template, then drop a pin for the shop." Text, media, locations, contact cards, reactions, buttons and approved templates, on your official number or the one you linked by QR code. The agent can also submit new templates for Meta's review.
whatsapp_send_text whatsapp_send_template whatsapp_submit_template
"Call the three on-call engineers and read out: the payment server is down." Calls from your Sozuri numbers that read a message aloud; every call's status, duration and price afterwards; and, if you record calls, the transcript and a link to play the recording.
voice_place_call voice_get_call voice_get_transcript voice_get_recording voice_end_call
"Send code 4821 from our system to this customer, WhatsApp first, then SMS." One request delivers a code on WhatsApp, SMS and voice, each only if the one before did not arrive. Your system makes the code; the agent never invents one.
otp_send otp_get
"Add the 40 people from this sign-up sheet to a group called March open day." List, look up, add, update and remove contacts in your project, and put them in groups.
contacts_list contacts_create
"Send Otieno an M-Pesa prompt for KES 1,200 for invoice 1043." A prompt on the payer's phone, for money paid into your own paybill. Off until you tick it, and capped per prompt and per day.
payments_request_mpesa
premium_send), check what the connection may do and its limits (account_get), and ask whether every network is delivering normally right now (platform_status).
ChatGPT and Claude sign in with OAuth: you approve the connection on a Sozuri page and never paste a key. Agents that send a header use an MCP key, made for that agent alone and bound to one project.
# ChatGPT: signs in with OAuth
1. Settings → Apps & connectors → add a custom one
2. MCP server URL: https://mcp.sozuri.net/v1
3. Authentication: OAuth
4. Log in to Sozuri, pick the project,
tick what the agent may do, approve.
# ChatGPT asks you to confirm every send.# Claude (claude.ai and Desktop): OAuth
1. Settings → Connectors → Add custom connector
2. URL: https://mcp.sozuri.net/v1
3. Log in to Sozuri, pick the project,
tick what the agent may do, approve.# Claude Code: an MCP key from your project page
claude mcp add --transport http sozuri \
https://mcp.sozuri.net/v1 \
--header "Authorization: Bearer smcp_k_..."// Cursor: an MCP key from your project page (VS Code: see the setup guide)
{
"mcpServers": {
"sozuri": {
"url": "https://mcp.sozuri.net/v1",
"headers": { "Authorization": "Bearer smcp_k_..." }
}
}
}# OpenAI Responses API: an MCP key, sent on every request
response = client.responses.create(
model="...",
tools=[{
"type": "mcp",
"server_label": "sozuri",
"server_url": "https://mcp.sozuri.net/v1",
"authorization": os.environ["SOZURI_MCP_KEY"],
"require_approval": "always", # a person approves each send
}],
input="Text the on-call engineer: the backup finished.",
)Only the project owner or a project admin can connect an agent. Each connection has its own permissions, chosen when it is made. Sozuri checks them on every request, on its own servers, so an agent cannot reach a tool you left unticked.
| Permission | What the agent can do | Ticked to start |
|---|---|---|
account:read | See the project's channels, templates, numbers, call history (with call transcripts and recordings) and code status | Always on |
contacts:read | List and look up contacts | Yes |
contacts:write | Add, update and delete contacts | Yes |
sms:send | Send and schedule SMS | Yes |
whatsapp:send | Send WhatsApp messages and reactions on either channel | Yes |
whatsapp:templates | Submit, edit and delete WhatsApp templates | Yes |
voice:call | Place voice calls, and end a call in progress | Yes |
otp:send | Deliver one-time codes on WhatsApp, SMS and voice | Yes |
premium:send | Subscribe, unsubscribe and message premium SMS customers | Yes |
payments:request | Send M-Pesa payment prompts | No: tick it on purpose |
Every tool that sends, changes or deletes is marked as a write. ChatGPT asks you to confirm each one; for agents you build, we show how to require approval for every send.
Your project's daily limits on spend, SMS, WhatsApp messages, calls, M-Pesa prompts and premium messages, and its monthly budget, apply to the agent like any other sender. A send over a limit is refused before anything goes out, and the agent is told why.
The MCP server never holds your project's API key and stores no token. It acts for one approved connection at a time, and Sozuri checks that connection on every call.
Revoke a connection and it stops within a minute. It also stops on its own when the person who made it loses admin on the project, or when the key expires.
Each request names the connection and the person who approved it, so your project's activity shows what the agent did and on whose authority.
A send is never retried by the MCP server. If Sozuri could not confirm one, the agent is told to check before trying again, and a call carries an id that stops a second call going out.
Everything an agent sends is billed exactly as the same request through the API: the same rates, from the same project balance, within the same limits. Prices are on the pricing page.
What a tool returns (phone numbers, message text, contact details) goes into your assistant's conversation, and so into the logs of the AI company you chose. Connect only the permissions the job needs.
A one-time code an agent sends is in its conversation. Have your own system generate it and hand it over; a code a language model makes up is not random.
Yes. The project owner or a project admin can connect an agent from the dashboard, under Manage API → AI agent (MCP) connections. The setup guide walks through each assistant.
Any client that speaks MCP over HTTP: ChatGPT, Claude (claude.ai, Desktop and Claude Code), Grok, Cursor, VS Code, and agents built on the OpenAI or Anthropic APIs. ChatGPT and Claude sign in with OAuth; the rest use OAuth where they support it, or an MCP key. The setup guide has the steps for each.
Your API key can do everything, is shared with your own systems, and names nobody. An MCP connection can do only what you ticked, belongs to one person and one project, and can be revoked without touching your production integration. The MCP server refuses project API keys.
Not yet. The first version sends and looks things up. Reading inbound messages is planned, with the text marked as written by someone outside your business, so an agent cannot be talked into sending by a message it read.
The server is versioned with the API: /v1 is API version 1. New tools are added to v1 without changing the ones you rely on, and anything that would break a connection waits for a new version, announced in advance.
Yes. Sozuri AI Agents answer your customers for you on SMS and WhatsApp. The MCP server lets an assistant you already use, such as ChatGPT or your own agent, work your Sozuri project for you.
Connect ChatGPT, Claude or your own agent to your project in a couple of minutes.