MCP server reference

CallForMe is a remote MCP server over streamable HTTP at https://callforme.tel/mcp with standard OAuth sign-in. Adding it shows a Connect step that creates your account in one click. It has ten tools, including place_call, get_call, answer_question and share_call. Clients without OAuth can use /mcp/open or a personal key URL.

Endpoint

https://callforme.tel/mcp

Remote MCP, streamable HTTP, stateless, with standard MCP authorization (OAuth).

Connecting

When you add the URL, your client shows a Connect, Authenticate or Sign in step. A browser tab opens and closes by itself. There's no email, no form and no card. That creates your CallForMe account, and the client keeps the token for every later session.

The only other step is one setup link, the first time your agent places a real call, to add $10. After that every chat just calls. A second agent's first link recognizes you and links it to the same account in one click. See how setup links work.

Clients without OAuth

On any endpoint, place_call also accepts "account_key": "cfm_..." and "setup_code": "k7m2q" (after the user finishes a setup link).

Tools

place_call to the demo line, Maple Street Pizza at +1 469 770 7412 (a fictional restaurant), needs no payment: up to 5 free calls a day per user.

There's also a get_setup helper for the setup flow: after the user finishes a setup link, your agent can call it with the code instead of passing setup_code to place_call again. See setup links.

place_call arguments

place_call responses

{ "status": "calling", "call_id": "call_8f2k1" }

{
  "status": "needs_setup",
  "setup_url": "https://callforme.tel/go/k7m2q",
  "setup_code": "k7m2q",
  "message_for_user": "To place this call, open https://callforme.tel/go/k7m2q and add $10. Then tell me when you're done."
}

{ "status": "blocked", "reason": "This number has asked not to receive automated calls." }

On /mcp/open, the first successful place_call after setup also includes account_key (cfm_...), shown once. Save it. OAuth and personal-key connections don't need to.

get_call response

{
  "status": "ended",
  "transcript": [
    { "role": "business", "text": "Nonna's, this is Kate." },
    { "role": "assistant", "text": "Hi Kate, I'm an automated assistant calling on behalf of Jordan..." }
  ],
  "pending_question": null,
  "answers": {
    "Is there a booth?": "No, window table instead."
  },
  "outcome": {
    "success": true,
    "summary": "Booked 4 at 7:45pm Friday under Jordan.",
    "confirmation_number": null,
    "price_quoted": null,
    "appointment_time": "Friday 7:45pm",
    "next_steps": "None."
  },
  "duration_s": 58,
  "cost_usd": 1.00
}

status moves through queued, ringing, in_progress, ended. The transcript shape above is illustrative; the fields listed in this section are the contract.

Mid-call questions

When the business asks something the assistant doesn't know, get_call returns a pending_question string. Reply with:

{ "call_id": "call_8f2k1", "answer": "Use 469-555-0199." }

on answer_question. The assistant waits on the line up to about 60 seconds. If there's no answer within about 50 seconds, it tells the business it'll call back.

Sharing a call

share_call makes a read-only page for one ended call at https://callforme.tel/c/<id>, with the transcript and result. Phone numbers and email addresses are hidden. The response is { "ok": true, "url": "...", "message": "..." }. Call it again with "public": false to take the page down.

{ "call_id": "call_8f2k1", "public": true }

Prompts

The server ships MCP prompts your agent can use as starting points:

Recommended loop

1. find_business if you don't have the number.
2. plan_call and fill any gaps it lists.
3. place_call. If needs_setup (first real call only), show message_for_user and wait.
4. place_call again with setup_code. On /mcp/open, save account_key.
5. get_call with wait_seconds: 50 until ended. Answer any pending_question.
6. Report answers and outcome to the user. Offer share_call if they want to show someone.

Limits

US and Canadian numbers only. 911, 988, 211, 311, other N11 and 900/976 numbers are blocked. Up to 3 calls to the same number per account per day. Calls end at 30 minutes. See safety and disclosure.

Questions