Developer API & MCP

The texting API,
ready

Send compliant business SMS at scale with a few lines of code — or hand your AI assistant the whole platform over MCP. Carrier registration, routing, and deliverability are handled for you.

Get API access → View reference
Works with Claude · Cursor · ClickUp · Windsurf · ChatGPT
Terminal — send a text
# send a message
curl https://api.tryready.com/sms/send \
  -H "Authorization: Bearer rdy_live_..." \
  -H "Content-Type: application/json" \
  -d '{"to":"+14155551234","message":"Confirmed for Thu 2 PM."}'
200 OK
{
  "success": true,
  "data": {
    "id": "msg_7Qk2f9",
    "status": "queued"
  }
}
MCP Integration

Connect in 3 steps

The ready. MCP server gives your AI assistant full access to your texting 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 the ready. connector

Name it ready. and paste this URL:

https://api.tryready.com/mcp
3

Connect & sign in

Click Add → Connect, sign in with your ready. 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 ready. 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 texting-platform access via AI.

MCP

ClickUp

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

MCPOAuth
GoHighLevel

GoHighLevel

Two-way sync with GHL. Inbound messages push to GHL conversations; outbound sends flow through ready.

LiveOAuth
Zapier

Zapier

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

LiveOAuth
Calendly

Calendly

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

LiveWebhook

Webhooks

Real-time event delivery — message.sent, message.delivered, message.inbound, contact.opted_out, and more.

LiveWebhook

REST API

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

Live
API Reference

REST API

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

Authorization: Bearer rdy_your_api_key_here Base URL: https://api.tryready.com

SMS

POST/sms/sendSend 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 ready!",
  "from_phone_number_id": 1
}
GET/sms/logsGet message history
limitintegerMax results (default 50)
statusstringpending, delivered, failed
directionstringoutbound, inbound
POST/sms/generateAI-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.01,
    "daily_avg_send": 428,
    "estimated_days_left": 5
  }
}
Get started

Start building on the texting API

Create an account, grab a key, and send your first compliant text — or connect your AI in three steps.

Get API access →