Developer API & Model Context Protocol

SMSRiver Developer Reference: Mcp Setup

Executable cURL examples, Python snippets, and MCP configuration for mcp-setup.

claude_desktop_config.json

JSON-RPC 2.0

{
  "mcpServers": {
    "smsriver": {
      "command": "npx",
      "args": ["-y", "@smsriver/mcp-server"],
      "env": {
        "SMSRIVER_API_KEY": "sk_live_your_api_key_here",
        "SMSRIVER_ENDPOINT": "https://smsriver.com/api/v1/mcp/"
      }
    }
  }
}

bash — synthetic_sms.sh

REST API v1

curl -X POST https://smsriver.com/api/v1/synthetic/sms/ \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+12025550101",
    "from": "AuthService",
    "body": "Your verification code is 482910"
  }'

Supported MCP Agent Tools

sms_list_numbers

Query active public and dedicated lines by country ISO code, source type, and readiness status.

sms_get_messages

Retrieve real-time inbound SMS messages with extracted OTP tokens and detected service attribution.

sms_create_synthetic_message

Inject zero-carrier-cost synthetic SMS inbound events directly into webhook endpoints for CI/CD test automation.