Add a phone call tool to any MCP client

If your client speaks the Model Context Protocol, it can ask a real person to phone a US or Canadian business and read back what they said. This page covers the transport, sign-in, tools and results for people who build or configure MCP clients.

What the HumanCalls MCP server speaks

There is one server address: https://humancalls.ai/mcp. It uses the Streamable HTTP transport, so there is nothing to install or run locally. Any client that can reach a remote MCP server over HTTPS can use it.

ItemValue
TransportStreamable HTTP
Server URLhttps://humancalls.ai/mcp
Sign-inOAuth 2.1 with PKCE
Discoveryhttps://humancalls.ai/.well-known/oauth-protected-resource
Client registrationOpen to any MCP client
Alternative authAn existing hc_live_ API key as a Bearer token

A client that follows the MCP authorization flow reads the discovery document, registers itself, and sends the user to HumanCalls to sign in and approve access. No client ID needs to be requested by hand.

Connect a client with OAuth or an API key

  1. Add a remote MCP server in your client and give it the URL https://humancalls.ai/mcp.
  2. Choose OAuth if the client offers it. The client finds the authorization details at the discovery path and opens a HumanCalls sign-in page.
  3. Sign in with your email. A new workspace gets 10 free minutes once the email is verified.
  4. Approve access. The client now lists the HumanCalls tools.

If your client cannot run an OAuth flow, or you are scripting a headless setup, send an API key from your dashboard as a Bearer token instead. Keep the key out of shared config files.

Example config only. Key names differ between clients, and the key shown is not real.
{
  "mcpServers": {
    "humancalls": {
      "url": "https://humancalls.ai/mcp",
      "headers": {
        "Authorization": "Bearer hc_live_EXAMPLE_KEY"
      }
    }
  }
}

Client-specific steps for Claude, ChatGPT, Claude Code and others are on the Connect page. For a worked example in a terminal client, see HumanCalls in Claude Code.

The seven tools

ToolWhat it does
request_callCreates a call task: the number, the business, who the call is for, the goal and the answers to collect.
get_callReturns the current status and, when finished, the results.
list_callsLists recent calls for the workspace.
cancel_callCancels a call that has not started yet. Canceled calls cost nothing.
answer_questionReplies to a question HumanCalls raised about missing details.
add_detailsAdds information to a task before the first dial.
get_accountReports balance and available minutes. It cannot buy credit.

A user might type something like this (example data):

  • “Call Lakeside Hardware on 416 555 0187 and ask if they have 3/4 inch copper elbows and the price per box. Don't order anything.”
  • “Phone Northside Auto at 312 555 0123 and ask what time they close on Saturday.”

Every call is made by a trained person who says who they are and who they are calling for. Callers do not buy, book or agree to anything the user did not authorize. Sales, debt collection, political calls, cold calls to consumers and sensitive healthcare workflows are declined. Read how our callers work.

Reading results: polling and the call card

Nothing is pushed into the conversation. The model calls get_call to check on a task, usually when the user asks how it went. A task moves from queued to assigned, dialing and in progress, then ends as completed, failed, no answer, declined or canceled.

A finished call returns typed answers, notes, a summary, the duration, billed minutes, the cost and links to the recording and transcript. The recording and transcript can arrive a little after the call ends, so poll again if the links are missing.

Clients with MCP Apps support show this as a call card with the status, summary, answers, cost and media links. Other clients get the same data as tool output and can render it however they like. If you need webhooks or direct API access, use the REST API instead.

What a call costs

$1 per connected minute, rounded up to the next minute. Phone menus and hold time after the business answers count. A call nobody answers costs $0, as do declined and canceled calls. Credit is added only by the account owner on the dashboard. See pricing.

Questions

Does my MCP client need OAuth support?
No. OAuth 2.1 with PKCE is the usual path, but you can send an existing hc_live_ API key as a Bearer token instead.
Do I need to register a client ID?
No. Registration is open, so a client that follows the MCP authorization flow registers itself using the discovery path.
Why does my client not show results automatically?
The server does not push results. The model reads them with get_call, so ask how the call went and it will fetch the latest state.
Is the caller an AI voice?
No. A real, trained person makes every call and tells the business the call is recorded.

Related

  • HumanCalls in Claude CodeAdd the HumanCalls MCP server to Claude Code with one command, so an agent working in your terminal can ask a real person to phone a business for an answer.
  • HumanCalls in CursorAdd the HumanCalls MCP server to Cursor so its agent can ask a real person to phone a business and bring back typed answers, a summary and the recording.
  • An MCP server for phone callsThe HumanCalls MCP server lets Claude, ChatGPT and other clients ask a real person to phone a business. Address, sign-in and the seven tools.

Try it with 10 free minutes

$1 per connected minute after that, and nothing when nobody picks up.

Request a callConnect a chat app