ReadySMS Server

Send SMS messages from any AI assistant — Claude, ClickUp, Cursor, Windsurf, and more. One-click setup.

npm version License: MIT

Setup (30 seconds)

Step 1: Get your API key

1. Create a free account at readysms.io
2. Go to Settings → API Keys → Create Key
3. Copy your key (starts with rsms_)

Step 2: Add to your AI tool

Copy-paste the config for your platform:

{
  "mcpServers": {
    "readysms": {
      "command": "npx",
      "args": ["-y", "readysms-mcp"],
      "env": {
        "READYSMS_API_KEY": "rsms_your_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "readysms": {
      "command": "npx",
      "args": ["-y", "readysms-mcp"],
      "env": {
        "READYSMS_API_KEY": "rsms_your_key_here"
      }
    }
  }
}

claude mcp add readysms -- npx -y readysms-mcp

export READYSMS_API_KEY=rsms_your_key_here

{
  "mcpServers": {
    "readysms": {
      "command": "npx",
      "args": ["-y", "readysms-mcp"],
      "env": {
        "READYSMS_API_KEY": "rsms_your_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "readysms": {
      "command": "npx",
      "args": ["-y", "readysms-mcp"],
      "env": {
        "READYSMS_API_KEY": "rsms_your_key_here"
      }
    }
  }
}

Step 3: Start talking

Just ask your AI assistant naturally:

"Send a text to +15551234567 saying their appointment is tomorrow at 3pm"

"Show me my unread conversations"

"Draft a campaign to remind customers about our summer sale"

"How many credits do I have left?"

"Run a deliverability audit on my phone numbers"

What You Can Do

Messaging

Inbox

Contacts

Campaigns

Automation

Analytics & Billing

Setup

Built-in Workflows

These pre-built prompts guide your AI through multi-step tasks:

• send_campaign — Walk through creating a campaign: check balance → AI-draft message → choose audience → save as draft
• inbox_summary — Summarize unread conversations, flag urgent items, show balance
• deliverability_audit — Audit every phone number with red/yellow/green health status

Environment Variables

Reliability

• Automatic retries with exponential backoff on 429/502/503/504
• 30-second timeout on all API calls (no hanging)
• Structured errors — clear, actionable messages (not stack traces)
• Phone number normalization — accepts (555) 123-4567, 5551234567, +15551234567
• Input validation — catches bad inputs before hitting the API
• Startup validation — verifies API key format immediately

Get Started

Don't have a ReadySMS account? Sign up free at readysms.io — takes under 2 minutes.

Need help? Email [email protected]