58 MCP Tools · REST API · OAuth

Connect ReadySMS to any AI

Send texts, manage contacts, run campaigns, and check deliverability — directly from Claude, Cursor, ChatGPT, ClickUp, or your own code.

Claude Cursor ClickUp Windsurf ChatGPT
MCP Integration

Connect in 3 steps

The ReadySMS MCP server gives your AI assistant full access to your SMS platform — send messages, manage contacts, run campaigns, and more.

1

Open Claude settings

Launch Claude Desktop or claude.ai and go to
Settings → Connectors

2

Add ReadySMS connector

Name it ReadySMS and paste this URL:

https://api.readysms.io/mcp
3

Connect & sign in

Click Add → Connect, sign in with your ReadySMS account — you're set. Just ask Claude to send a text.

58 tools across 10 categories

Messaging

send_sms, ai_generate_message, get_message_logs, get_delivery_rate

Conversations

list, get_messages, update, assign

Contacts

search, get, create, update, delete, bulk_tag, bulk_assign, carrier_lookup, validate, export

Campaigns

list, ai_compose, create, update, send, cancel, preview, breakdown, diagnose, delete

Drip Sequences

list, create, enroll, update_status, get_enrollments

Phone Numbers

list, check_deliverability, check_spam, set_primary, rename

AI Agents

list, create, update, test, set_status

Segments

list, create, preview

Billing

get_balance, spend_history, transactions, billing_status, payment_method, subscriptions

System

test_connection, get_setup_status, templates, automations
Integrations

One-click connections

Connect ReadySMS with the tools you already use. OAuth-based integrations connect in seconds.

MCP Server

58 tools for Claude, Cursor, ClickUp Brain, Windsurf, and ChatGPT. Full SMS platform access via AI.

MCP

ClickUp

Connect ClickUp Brain to ReadySMS. Send texts, look up contacts, and manage campaigns from any task or doc.

MCP OAuth

GoHighLevel

Two-way sync with GHL. Inbound messages push to GHL conversations, outbound sends from GHL flow through ReadySMS.

Live OAuth

Zapier

Trigger SMS sends from any of 6,000+ apps. Receive inbound messages as Zap triggers.

Live OAuth

Calendly

Automatic SMS confirmations and reminders when appointments are booked via Calendly.

Live Webhook

Webhooks

Real-time event delivery. Get notified on message.sent, message.delivered, message.inbound, contact.opted_out, and more.

Live Webhook

REST API

Full programmatic access. Send SMS, manage contacts, campaigns, billing — everything with a Bearer token.

Live
API Reference

REST API

All requests require a Bearer token from Settings → API Keys.

Authorization: Bearer rsms_your_api_key_here
Base URL: https://api.readysms.io

SMS

POST /sms/send Send an SMS message
tostringRecipient phone (E.164) required
messagestringMessage content (max 1600) required
from_phone_number_idintegerID of sending phone number
{
  "to": "+14155551234",
  "message": "Hello from ReadySMS!",
  "from_phone_number_id": 1
}
GET /sms/logs Get message history
limitintegerMax results (default 50)
statusstringpending, delivered, failed
directionstringoutbound, inbound
POST /sms/generate AI-generate SMS messages
descriptionstringDescribe the message required
// Response
{
  "success": true,
  "data": [
    "Hi {first_name}! Reminder: your appointment is tomorrow at 3 PM.",
    "Hey {first_name}, don't forget your appointment tomorrow!"
  ]
}

Contacts

GET/contactsList contacts with filters
searchstringSearch by name, phone, email
stagestringPipeline stage filter
statusstringactive, opted_out
POST/contactsCreate a contact
phonestringPhone number required
first_namestringFirst name
last_namestringLast name
emailstringEmail address
tagsarrayTag strings
pipeline_stagestringnew_lead, contacted, qualified, proposal, won, lost
PUT/contacts/:idUpdate a contact

Same fields as POST. Only include fields to update.

DELETE/contacts/:idDelete a contact

Permanently deletes the contact and all associated data.

Billing

GET/billing/balanceGet credit balance and usage 
{
  "success": true,
  "data": {
    "balance": 2500,
    "rate": 0.0084,
    "daily_avg_send": 428,
    "estimated_days_left": 5
  }
}
GET/billing/transactionsTransaction history
limitintegerMax results (default 20)

Webhooks

Configure webhooks in Settings → API Keys to receive real-time events.

EVENTmessage.sentOutbound sent
EVENTmessage.deliveredDelivery confirmed
EVENTmessage.failedDelivery failed
EVENTmessage.inboundReply received
EVENTcontact.createdNew contact
EVENTcontact.opted_outSTOP received

Need help integrating?

Our team can help you get connected in minutes.

support@readysms.io