Get started

MCP setup

One remote server, Streamable HTTP, stateless. Works with API keys or OAuth.

Server

https://ringahuman.com/mcp (Streamable HTTP). Authenticate with Authorization: Bearer rah_live_…, or let the client run OAuth.

Claude Code

claude mcp add --transport http ringahuman https://ringahuman.com/mcp \
  --header "Authorization: Bearer $RINGAHUMAN_API_KEY"

ChatGPT

Find Ring a Human in the app directory, or add a connector with the server URL. ChatGPT opens the Ring a Human sign-in screen (OAuth).

Claude (web and desktop)

Settings → Connectors → Add custom connector → https://ringahuman.com/mcp, then sign in.

Cursor, VS Code, Windsurf and others

{
  "mcpServers": {
    "ringahuman": {
      "url": "https://ringahuman.com/mcp",
      "headers": { "Authorization": "Bearer rah_live_…" }
    }
  }
}

Tools

Tool	Annotations	Does
`create_call_task`	open-world	Queue a call for a human
`get_call_task`	read-only	Status and outcome
`list_call_tasks`	read-only	Recent tasks
`cancel_call_task`	destructive, idempotent	Cancel before dialing
`add_do_not_call`	idempotent	Block a number network-wide
`get_billing_status`	read-only	Plan, calls remaining, whether tasks will dispatch
`create_checkout_link`	—	Stripe Checkout link for your user to pick a plan