clawcall — Claude Code MCP server: real US phone calls
Hands your agent tools for real outbound calls in the US: it dials, walks phone menus, sits through hold time and brings back a transcript.
claude mcp add --transport http clawcall https://api.clawcall.dev/mcpWhat clawcall does
clawcall is a stdio MCP server that wraps the ClawCall REST API. It imports nothing from the ClawCall backend — it just exposes that contract as tools any MCP host can call. Calls go outbound only, US numbers only, +1 format.
You can skip the API key entirely. On the first place_call the server issues a proto-key itself and writes it to ~/.config/clawcall/key.json. The ClawCall skill touches the same file, so skill and server share one identity, one trial quota and one call history. Setting CLAWCALL_API_KEY in the environment shadows that file — useful for operators and CI.
A call takes minutes, so the loop matters: place_call returns a call_id right away, then you poll get_call every 3 seconds until lifecycle reads finalized, and pull the transcript with get_call_transcript. The outcome field describes the phone network, not your task — a picked-up call can still fail what you asked for. Do not retry 402 errors. trial_exhausted, plan_required and reserved_number_required all need a person, and the action.url has to be forwarded as-is because it is personalized and carries your proto-key.
What it helps with
- call a business and find out its opening hours
- gather quotes from several suppliers in parallel
- get past an IVR menu and reach a human
- pull a transcript of the conversation into a report
- compare policies across different providers
Example prompts for the agent
- Call the repair shop and ask whether they open on Saturday
- Ring three stores and compare who has this part in stock
- Place the call and show me the transcript when it finishes
How to install clawcall
1Platform CLI: remote server
claude mcp add --transport http clawcall https://api.clawcall.dev/mcp2Platform CLI
claude mcp add --env CLAWCALL_API_KEY=<CLAWCALL_API_KEY> --env CLAWCALL_BASE_URL=<CLAWCALL_BASE_URL> --transport stdio mcp -- npx -y @clawcall/mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add mcp --url https://api.clawcall.dev/mcp2Platform CLI
codex mcp add mcp --env CLAWCALL_API_KEY=<CLAWCALL_API_KEY> --env CLAWCALL_BASE_URL=<CLAWCALL_BASE_URL> -- npx -y @clawcall/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp": {
"url": "https://api.clawcall.dev/mcp"
}
}
}{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<CLAWCALL_API_KEY>",
"CLAWCALL_BASE_URL": "<CLAWCALL_BASE_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp": {
"type": "http",
"url": "https://api.clawcall.dev/mcp"
}
}
}{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<CLAWCALL_API_KEY>",
"CLAWCALL_BASE_URL": "<CLAWCALL_BASE_URL>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http mcp https://api.clawcall.dev/mcp2Platform CLI
gemini mcp add -e CLAWCALL_API_KEY=<CLAWCALL_API_KEY> -e CLAWCALL_BASE_URL=<CLAWCALL_BASE_URL> mcp npx -y @clawcall/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about clawcall
How do I install clawcall in Claude Code?
Add the hosted connector with claude mcp add --transport http clawcall https://api.clawcall.dev/mcp. A separate command covers the local stdio package via npx -y @clawcall/mcp.
What does clawcall do?
It places outbound US phone calls for your agent, handles menus and hold time, then returns a transcript. The agent works through place_call, get_call and get_call_transcript.
Do I need an API key to start?
No. The server issues a proto-key on your first call and stores it in ~/.config/clawcall/key.json. CLAWCALL_API_KEY is only an override.
