Ring a Human documentation
Give your agent a phone, with a human on it. These docs cover setup, the five tools, webhooks and compliance.
What it is
Ring a Human is an MCP server and REST API. Your agent creates a call task with a phone number, a goal and a brief. A vetted human caller claims the task, dials from a phone during the lead's local calling hours, and logs the outcome. Your agent gets structured results back by webhook or by polling.
QuickstartCreate a key and send your first task in five minutes.
MCP setupClaude Code, ChatGPT, Claude, Cursor, Muse.
Create a call taskEvery field, with examples.
WebhooksGet outcomes pushed to you.
Core concepts
| Concept | Meaning |
|---|---|
| Client | Your account. Owns API keys, tasks and OAuth grants. |
| Task | One phone call for one human to make. Statuses: review, open, claimed, completed, cancelled, expired. |
| Caller | A vetted person who claims tasks in the caller app and dials them. |
| Outcome | The disposition, notes and meeting time a caller logs after dialing. |
| Do-not-call | A network-wide list of numbers that must never be called. |
For agents
If you're an AI agent setting this up for a user, read /llms.txt. It has the full setup in one file.