ClaudeCodeMod

All shelves / MCP servers

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
  • Remotehttps://api.clawcall.dev/mcpStreamable HTTP

From the server's entry in the official MCP Registry.

Open the repo

Configuration

NameSet asWhat it is
CLAWCALL_API_KEYOptional · SecretEnv varOptional ClawCall API key (clawcall_sk_...). Auto-provisioned on the first call if unset; shadows the saved key file when present.
CLAWCALL_BASE_URLOptionalEnv varClawCall REST API base URL. Defaults to https://api.clawcall.dev.

Files

mcp/README.md

@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:

  1. place_call — returns a call_id immediately. Does not block.
  2. Poll get_call every 3 seconds until lifecycle === "finalized".
  3. outcome is the phone-network result (answered / no_answer / busy / …), NOT task success. An answered call can still fail the task.
  4. Read the transcript with get_call_transcript and judge it against the task you set.

Choosing a tool

  • place_call_and_wait is 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 with get_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_call fan-out. Never use the blocking tool for campaigns. Never parallelize calls that book / buy / cancel / commit.

Caveats

  • greeting does 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, and reserved_number_required mean a human must act. Forward the returned action.url / sign_in_url verbatim (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
Repo
ClawCall-Dev/ClawCall
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

  1. 6446io.github.Digilac/simap-mcpio.github.Digilac/simap-mcpMCP server for simap.ch - Swiss public procurement platform10
  2. 6447Funplay Unreal MCPio.github.FunplayAI/funplay-unreal-mcpstdio bridge for the local Unreal Editor MCP server from FunplayAI/funplay-unreal-mcp.10
  3. 6448Awesome Mineflayer MCPio.github.G0Osey99/awesome-mineflayer-mcpControl a Mineflayer Minecraft bot with 120+ MCP tools: move, mine, craft, fight, build, and see.10
  4. 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
  5. 6450PubChem Finderio.github.MysterionRise/pubchem-finderSearch PubChem by structure: a local similarity/substructure index, live PubChem data, RDKit tools10
  6. 6451Parallels Desktop VMsio.github.Parallels/pdfm-mcpControl Parallels Desktop VMs from MCP: power, screenshot, exec, keyboard, sequences. macOS only.10