Sandbox

The full tool surface with simulated calls. No key, no signup, nobody gets dialed.

Endpoints

Same inputs, validation and response shape as production, plus "sandbox": true. Send your API key and sandbox tasks are scoped to your account; without one they're scoped to your network.

claude mcp add --transport http ringahuman-sandbox https://ringahuman.com/sandbox/mcp

Timeline

Each simulated task moves open → claimed (~3s) → dialed (~5s) → completed (~8s). Poll get_call_task, or pass a webhook_url to receive the same task.completed payload production sends.

Calling hours

Production only claims and dials between 9am and 8pm in the lead's timezone (Texas Sundays from noon). If you create a sandbox task outside that window, the sandbox fast-forwards: the task still completes in ~8 seconds, but claimed, dial and completed are timestamped at the next window, and the response includes a calling_window object explaining it. callable_now stays accurate for the current moment.

Magic test numbers

The last four digits of the phone number decide the outcome. Use any area code with 555.

Example

curl -X POST https://ringahuman.com/api/sandbox/tasks \
  -H "Content-Type: application/json" \
  -d '{"phone":"(512) 555-0100","state":"TX","consent":"inquiry",
       "business_name":"Bright Smile Dental","goal":"Book a 15-minute call",
       "brief":"They ran our grader 6 minutes ago and scored 41/100…"}'

# ~8 seconds later
curl https://ringahuman.com/api/sandbox/tasks/sbx_…
# → { "status": "completed", "outcome": { "disposition": "booked", "meeting_at": "Thu 2:00 PM …" }, … }

Limits

• 100 sandbox tasks per day per account or network.
• Sandbox tasks are kept for testing and never billed.
• Switch to production by changing the URL to /mcp or /api/tasks and adding your key.