# SMS Alert — how to use (mcp.ai)

Connect your SMS Alert account and use 23 tools for phone and SMS straight from your AI agent. Connect with your own API key. SMS Alert is a versatile multi-channel communication platform enabling businesses to engage with customers through SMS, RCS, Telegram, and WhatsApp via a unified REST API.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_sms_alert?ms=1787295960000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `sms_alert_change_password`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/sms_alert`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/sms_alert/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/sms_alert/change/password` — Tool to change the password for the authenticated user account. Use when the user needs to update their account password.
  - body: { pwd: string, cnfpwd: string, newpwd: string }
- `POST https://api.mcp.ai/api/sms_alert/get/balance/check` — Tool to retrieve the current SMS credit balance. Use when you need an up-to-date credit status before sending messages. If balance is low, gate high-volume sends before proceeding — insufficient credi
- `POST https://api.mcp.ai/api/sms_alert/get/delivery/report` — Tool to retrieve delivery report for sent SMS messages by batch ID. Returns message delivery status including mobile numbers, delivery status, and timestamps. Use after sending SMS campaigns to track 
  - body: { text?: string, sender?: string, batchid: string, schedule?: string }
- `POST https://api.mcp.ai/api/sms_alert/get/group/detail` — Tool to retrieve details of a specific SMS Alert group. Use after confirming the group ID.
  - body: { group_id: integer }
- `POST https://api.mcp.ai/api/sms_alert/get/group/list` — Tool to retrieve a list of SMS Alert groups. Use when you need to fetch all groups associated with your account. Call after authenticating your API key.
- `POST https://api.mcp.ai/api/sms_alert/get/sender/id/list` — Tool to fetch the list of available sender IDs. Use when you need to retrieve all sender IDs associated with your account. Use after configuring your API key.
- `POST https://api.mcp.ai/api/sms_alert/get/template/list` — Tool to retrieve list of SMS templates from your SmsAlert account. Use when you need to display or manage your SMSAlert templates.
  - body: { template_type?: string }
- `POST https://api.mcp.ai/api/sms_alert/get/user/profile` — Tool to retrieve user login and profile information. Returns account details including balance, sender IDs, and account status. Use after configuring your API key to fetch complete user profile.
- `POST https://api.mcp.ai/api/sms_alert/post/create/contact` — Create New Contact
  - body: { name: string, group: string, mobile: string }
- `POST https://api.mcp.ai/api/sms_alert/post/create/group` — Tool to create a new contact group. Use when needing to organize contacts into a new group.
  - body: { name: string }
- `POST https://api.mcp.ai/api/sms_alert/post/create/short/url` — Tool to create a short URL for a given long URL. Use when you need to shorten a URL before sharing.
  - body: { url: string, alias?: string }
- `POST https://api.mcp.ai/api/sms_alert/post/create/template` — Tool to create a new SMS template. Use when you need to define reusable message content.
  - body: { name: string, text: string }
- `POST https://api.mcp.ai/api/sms_alert/post/delete/contact` — Tool to delete a specified contact. Use after confirming the contact's ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/sms_alert/post/delete/group` — Tool to delete a specified group. Use after confirming the group's ID.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/sms_alert/post/delete/short/url` — Tool to delete an existing short URL. Use after confirming the short URL's ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/sms_alert/post/delete/template` — Tool to delete an existing SMS template. Use when you have the template ID to remove it.
  - body: { template_id: string }
- `POST https://api.mcp.ai/api/sms_alert/post/edit/contact` — Tool to edit an existing contact’s details. Use when you need to update a contact’s information after confirming the contact_id.
  - body: { name?: string, email?: string, group_id?: string, mobileno?: string, contact_id: string }
- `POST https://api.mcp.ai/api/sms_alert/post/edit/group` — Tool to edit an existing groups name. Use when you need to rename a group after confirming the group id.
  - body: { id: string, name: string }
- `POST https://api.mcp.ai/api/sms_alert/post/edit/profile` — Tool to update user account profile details. Use when modifying authenticated user profile after login.
  - body: { gst?: string, city?: string, email?: string, state?: string, address?: string, company?: string, country?: string, pincode?: string, mobileno: string }
- `POST https://api.mcp.ai/api/sms_alert/post/edit/template` — Tool to edit an existing SMS template. Use when you need to update a template after confirming the template id.
  - body: { id: string, name: string, text: string }
- `POST https://api.mcp.ai/api/sms_alert/post/generate/otp` — Tool to generate a one-time password (OTP). Use when you need to send an OTP to a mobile number using a predefined template.
  - body: { sender?: string, mobileno: string, template: string }
- `POST https://api.mcp.ai/api/sms_alert/post/sent/sms/report` — Tool to retrieve SMS campaign sent report details. Use after campaigns are sent to analyze delivery results. Delivery status data may lag real time; treat results as non-final for time-sensitive workf
  - body: { page?: integer, limit?: integer, mobile?: string, campaignuniqueid?: string }
- `POST https://api.mcp.ai/api/sms_alert/send/sms/xml` — Tool to send SMS messages using XML format for bulk sending. Use when you need to send multiple messages to different recipients with different content in a single API call.
  - body: { messages: object[] }

## Example prompts
- "What can I do in SMS Alert?"
- "Show me a summary of my SMS Alert account"

## More
- Page: https://mcp.ai/sms_alert
- Agent spec (llms.txt): https://mcp.ai/sms_alert/llms.txt
- Postman collection: https://mcp.ai/sms_alert/postman.json