---
name: ringahuman
description: Hand a phone call to a real person with Ring a Human. Use when the user wants someone called (a lead, a business, a customer) to book a meeting, qualify, confirm, or follow up, and a human (not an AI voice) should place the call.
---

# Ring a Human

Ring a Human is a remote MCP server (`https://ringahuman.com/mcp`) where you create call tasks and vetted human callers dial them, then report a structured outcome.

## Setup
- If the `ringahuman` MCP tools are not available, add the server: `claude mcp add --transport http ringahuman https://ringahuman.com/mcp` (OAuth sign-in), or with a key: `--header "Authorization: Bearer $RINGAHUMAN_API_KEY"`.
- No key yet? `POST https://ringahuman.com/api/signup` with `{"email": "...", "company": "..."}` returns one. No email verification. New accounts get free calls.
- To try things without a key, use the sandbox at `https://ringahuman.com/sandbox/mcp`. Numbers ending in 0100–0107 return booked, conversation, voicemail, no_answer, gatekeeper, not_interested, wrong_number and do_not_call.

## Creating a good task
1. Confirm you have a consent basis for the call (an inbound form, a free-tool signup, an existing customer, or a business line). Never invent consent.
2. Write the brief for a person reading it on their phone in 20 seconds. Include who the contact is, why they're getting a call, the single goal, two or three talking points and what counts as success.
3. Call `create_call_task` with the phone, contact name, timezone or state, goal, brief and a `webhook_url` if you have one.
4. Calls only happen 9am–8pm in the lead's local time. If `callable_now` is false, tell the user when the window opens rather than retrying.

## After the call
- Poll `get_call_task` or wait for the webhook. Outcomes: `booked`, `conversation`, `voicemail`, `no_answer`, `gatekeeper`, `not_interested`, `wrong_number`, `do_not_call`.
- `do_not_call` adds the number to this account's do-not-call list automatically. Never re-task that number.
- Billing is per completed attempt plus a fee for booked meetings. Check `get_billing_status` before a large batch, and use `create_checkout_link` if the user needs a plan.

Docs: https://ringahuman.com/docs/ · Agent guide: https://ringahuman.com/llms.txt
