Cursor AI SMS Testing via MCP

How to configure Cursor AI editor with SMSRiver MCP server for autonomous end-to-end authentication testing in local codebases.

.cursor/mcp.json

Cursor MCP

{
  "mcpServers": {
    "smsriver": {
      "command": "npx",
      "args": ["-y", "@smsriver/mcp-server"],
      "env": {
        "SMSRIVER_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

agent_prompt.txt

REST API v1

@smsriver Generate a test SMS to +12025550101 with an OTP code and verify that our auth service webhook parses it correctly.

Implementation Walkthrough

Add MCP Server in Cursor Settings

Open Cursor Settings > Features > MCP, and add SMSRiver with your live API key.

Use Agent Chat Mode

In Composer or Chat, mention `@smsriver` to trigger tools like `create_test_inbox` and `generate_test_sms`.

Run Automated Verification Loops

Cursor will autonomously trigger synthetic SMS messages, read inbound OTP tokens, and verify frontend form validation.

Supported MCP Agent Tools

list_countries

alias: sms_list_numbers

Discover supported countries, inventory counts, and carrier capabilities by source type.

get_number_capabilities

alias: sms_get_capabilities

Check line types, SMS capabilities, carrier limitations, and rental costs for a phone number or ISO country.

create_test_inbox

alias: sms_create_inbox

Create an isolated synthetic test inbox for deterministic webhook integration testing without real carriers.

generate_test_sms

aliases: sms_generate_sms, sms_create_synthetic_message

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

simulate_delivery_failure

alias: sms_simulate_failure

Simulate carrier drops, 10DLC rejections, DND blocks, and queue timeouts to verify retry handling.

inspect_webhook_events

alias: sms_inspect_webhooks

Query recorded test events, delivery status, latency, and raw carrier webhook payloads within plan retention.

replay_test_event

alias: sms_replay_event

Replay an existing test event to re-trigger local webhooks or reproduce failed integration test cases.

get_usage_summary

alias: sms_get_usage

Inspect current billing plan, monthly quota, consumed requests, and remaining units across REST and MCP.