io.github.ClawCall-Dev/clawcall
io.github.ClawCall-Dev/clawcall · 10 stars · TypeScript · MIT
MCP server Real US phone calls for AI agents: navigates phone menus, waits on hold, returns transcripts.
Install
The repo has no one-line install. Follow its README.
Published as
- npm
@clawcall/mcpstdio - Remote
https://api.clawcall.dev/mcpStreamable HTTP
From the server's entry in the official MCP Registry.
Configuration
| Name | Set as | What it is |
|---|---|---|
CLAWCALL_API_KEYOptional · Secret | Env var | Optional ClawCall API key (clawcall_sk_...). Auto-provisioned on the first call if unset; shadows the saved key file when present. |
CLAWCALL_BASE_URLOptional | Env var | ClawCall REST API base URL. Defaults to https://api.clawcall.dev. |
Files
@clawcall/mcp
Important
Legacy local transport. New integrations should use ClawCall's hosted OAuth MCP connector at
https://api.clawcall.dev/mcp. This stdio package remains available for existing local/API-key installations, but it is not the connector submitted to the official xAI marketplace.
MCP server wrapping the ClawCall REST API for AI-powered US phone calls.
ClawCall places real outbound phone calls in the US (+1 only). This package is a stdio
MCP server that exposes the ClawCall REST contract as tools any MCP host (Claude Code,
Claude Desktop, Cursor, Windsurf) can call. It is a stateless client over the public API
at https://api.clawcall.dev — it imports nothing from the ClawCall server.
Install / register
Add the server to your MCP client config:
{ "mcpServers": { "clawcall": { "command": "npx", "args": ["-y", "@clawcall/mcp"], "env": { "CLAWCALL_API_KEY": "optional", "CLAWCALL_BASE_URL": "https://api.clawcall.dev" } } } }
Or, for Claude Code, the one-liner:
claude mcp add clawcall -- npx -y @clawcall/mcp
The env block is optional. The ClawCall server self-provisions an API key on the
first call: an anonymous place_call auto-issues a proto-key, which this server captures
and persists. You do not need to set CLAWCALL_API_KEY to get started.
Identity sharing
This MCP server reads and writes the same ~/.config/clawcall/key.json file
({ "api_key": "...", "user_phone_number": "..." }) that the ClawCall agent skill uses.
Running both the skill and this MCP server does not fork your identity — they share one
key, one trial quota, one call history, and one balance.
If CLAWCALL_API_KEY is set in the environment, it shadows the file (an operator /
CI override). The saved file is otherwise the source of truth, and the proto-key issued on
your first call is persisted there automatically (preserving any saved user_phone_number).
The workflow
A call runs for several minutes. The load-bearing loop is:
place_call— returns acall_idimmediately. Does not block.- Poll
get_callevery 3 seconds untillifecycle === "finalized". outcomeis the phone-network result (answered / no_answer / busy / …), NOT task success. An answered call can still fail the task.- Read the transcript with
get_call_transcriptand judge it against the task you set.
Choosing a tool
place_call_and_waitis the single-foreground-call shortcut: it places the call and internally polls until finalized or a hard cap (~180 s, ceiling 240 s). On the cap it degrades to the non-blocking contract — it returns{ still_running: true, call_id, … }and you continue withget_call. Use it when you want one call's result in one shot.- Campaigns — 3–4 parallel, interchangeable, info-gathering-only calls (quotes,
availability, inventory, policy comparison) — use
place_call+get_callfan-out. Never use the blocking tool for campaigns. Never parallelize calls that book / buy / cancel / commit.
Caveats
greetingdoes NOT set the agent's first spoken line. It is outbound-opener context only. The agent's actual opening line is a hardcoded recording disclosure on the server.- 402 errors are PERMANENT gating, not retryable.
trial_exhausted,plan_required, andreserved_number_requiredmean a human must act. Forward the returnedaction.url/sign_in_urlverbatim (they are personalized and embed your proto-key). Do not retry.
Trial limits are read from the live quota object in the error envelope — they are
never hardcoded in this package, so the displayed numbers always match the server.
Environment variables
| Variable | Default | Purpose |
|---|---|---|
CLAWCALL_BASE_URL |
https://api.clawcall.dev |
ClawCall REST API base URL. |
CLAWCALL_FRONTEND_URL |
https://clawcall.dev |
Frontend base used to build sign-in / account-link URLs. |
CLAWCALL_API_KEY |
(unset) | Optional operator override. Shadows the saved key file. |
CLAWCALL_WAIT_DEFAULT |
180 |
Default cap (seconds) for place_call_and_wait. |
CLAWCALL_WAIT_CEILING |
240 |
Maximum allowed cap (seconds) for place_call_and_wait. |
More
skill-companion/MCP-COMPANION.md— companion note for the ClawCall skill describing how the two share identity and workflow.../skill/SKILL.md— the ClawCall agent skill (the procedural layer; this MCP server is the connectivity layer over the same REST API).
Facts
- Kind
- MCP server
- Group
- Uncategorized
- Stars
- 10
- License
- MIT
- Language
- TypeScript
- Last push
- 2026-10-13
- Forks
- 1
- MCP Registry
- io.github.ClawCall-Dev/clawcall
- Homepage
- clawcall.dev
- Topics
- ai-agent, grok-build, mcp, phone-calls, clawcall
Next on this shelf
- 6446io.github.Digilac/simap-mcpio.github.Digilac/simap-mcpMCP server for simap.ch - Swiss public procurement platform10
- 6447Funplay Unreal MCPio.github.FunplayAI/funplay-unreal-mcpstdio bridge for the local Unreal Editor MCP server from FunplayAI/funplay-unreal-mcp.10
- 6448Awesome Mineflayer MCPio.github.G0Osey99/awesome-mineflayer-mcpControl a Mineflayer Minecraft bot with 120+ MCP tools: move, mine, craft, fight, build, and see.10
- 6449tex-mcp-webio.github.MiiKiyoshi/tex-mcp-webLaTeX paper review: comment on the PDF while an AI agent edits the source, with Overleaf sync.10
- 6450PubChem Finderio.github.MysterionRise/pubchem-finderSearch PubChem by structure: a local similarity/substructure index, live PubChem data, RDKit tools10
- 6451Parallels Desktop VMsio.github.Parallels/pdfm-mcpControl Parallels Desktop VMs from MCP: power, screenshot, exec, keyboard, sequences. macOS only.10