AI 에이전트가 미국 내로 전화를 걸고, 메뉴를 탐색하며, 대기 상태를 유지하고, 통화 녹취록을 가져올 수 있도록 지원합니다.
다른 이름 ClawCall-Dev/clawcall, @clawcall/mcp
- 스타
- 10
- Tools
- —
- 다운로드, 30일
- 195
- 최신 버전
- 0.2.0
- 마지막 커밋
- 2026년 10월 13일
- 라이선스
- MIT
ClawCall MCP란?
ClawCall은(는) MCP server입니다. AI 에이전트가 미국 내로 전화를 걸고, 메뉴를 탐색하며, 대기 상태를 유지하고, 통화 녹취록을 가져올 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
ClawCall MCP server 정보
Clawcall은 AI 에이전트가 미국 내로 아웃바운드 전화를 걸 수 있는 방법을 제공합니다. 이 stdio MCP server는 ClawCall REST API를 위한 연결 계층 역할을 하며, Claude Desktop, Cursor, Windsurf와 같은 호스트가 전화 네트워크와 상호작용할 수 있도록 합니다. 음성 통신을 에이전트 워크플로우에 통합하여 전화 메뉴 탐색이나 대기 등의 작업을 수행하려는 개발자를 위해 설계되었습니다.
사용자는 초기 API key 없이 npx를 사용하여 서버를 설정할 수 있습니다. 첫 번째 place_call 명령 시 시스템이 proto-key를 자체적으로 프로비저닝하기 때문입니다. 이 key와 사용자 전화번호는 로컬 설정 파일에 저장되어 일관된 신원, 체험 쿼터 및 통화 기록을 유지합니다. 서버는 재정의를 위해 선택 사항인 CLAWCALL_API_KEY 환경 변수를 지원하지만, 주로 이 로컬 영속성을 사용하여 계정 상태를 관리합니다.
서버는 특정 도구를 통해 다양한 상호작용 패턴을 제공합니다. place_call_and_wait 도구는 통화 생명주기가 완료될 때까지 폴링을 수행하여 단일 통화를 위한 단축 경로를 제공하며, 최대 240초까지 대기할 수 있습니다. 정보 수집 캠페인과 같은 더 복잡한 작업의 경우, 개발자는 비차단 방식인 place_call 및 get_call 도구를 사용하여 여러 개의 병렬 통화를 관리할 수 있습니다.
활용 사례
- 1단일 아웃바운드 통화 실행AI 에이전트가 단일 전화를 걸고 결과가 완료될 때까지 기다린 후 다음 작업을 진행할 수 있습니다.
- 2정보 수집 캠페인 실행개발자가 에이전트에게 견적을 수집하거나 재고를 확인하기 위해 여러 통의 전화를 병렬로 수행하도록 지시할 수 있습니다.
- 3녹취록을 통한 통화 결과 분석통화가 종료된 후 에이전트가 텍스트 녹취록을 가져와 특정 작업의 성공 여부를 평가할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
ClawCall MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 ClawCall MCP 설치
$ claude mcp add --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall -- npx -y @clawcall/mcpCursor에 ClawCall MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}VS Code에 ClawCall MCP 설치
.vscode/mcp.json
{
"servers": {
"clawcall": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}VS Code CLI에 ClawCall MCP 설치
$ code --add-mcp '{"name":"clawcall","type":"stdio","command":"npx","args":["-y","@clawcall/mcp"],"env":{"CLAWCALL_API_KEY":"<YOUR_CLAWCALL_API_KEY>"}}'Claude Desktop에 ClawCall MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}Codex에 ClawCall MCP 설치
$ codex mcp add clawcall --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' -- npx -y @clawcall/mcpCodex config.toml에 ClawCall MCP 설치
~/.codex/config.toml
[mcp_servers.clawcall] command = "npx" args = ["-y", "@clawcall/mcp"] [mcp_servers.clawcall.env] CLAWCALL_API_KEY = "<YOUR_CLAWCALL_API_KEY>"
Gemini CLI에 ClawCall MCP 설치
$ gemini mcp add -s user -e 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall npx -- -y @clawcall/mcpGemini settings.json에 ClawCall MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}구성
CLAWCALL_API_KEY비밀Optional ClawCall API key (clawcall_sk_...). Auto-provisioned on the first call if unset; shadows the saved key file when present.
CLAWCALL_BASE_URLClawCall REST API base URL. Defaults to https://api.clawcall.dev.
| 이름 | 설명 | 유형 |
|---|---|---|
| CLAWCALL_API_KEY | Optional ClawCall API key (clawcall_sk_...). Auto-provisioned on the first call if unset; shadows the saved key file when present. | 비밀 |
| CLAWCALL_BASE_URL | ClawCall REST API base URL. Defaults to https://api.clawcall.dev. |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능clawcall-dev/clawcall is public and reachablegithub.com/clawcall-dev/clawcall ↗통과
- 패키지가 이 저장소를 소스로 명시@clawcall/mcp names clawcall-dev/clawcall as sourcenpmjs.com/package/@clawcall/mcp ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-13github.com/clawcall-dev/clawcall ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @clawcall/mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음99 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기@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).
ClawCall MCP 질문
ClawCall MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall -- npx -y @clawcall/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
ClawCall MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
ClawCall을 사용하려면 API key가 필요한가요?
아니요, 서버가 API key를 자체적으로 프로비저닝할 수 있습니다. 익명 통화 시 proto-key가 자동으로 발급되며, 서버가 이를 캡처하여 저장합니다.
여러 통의 전화를 동시에 걸 수 있나요?
네, place_call과 get_call을 사용하여 병렬 정보 수집 캠페인을 수행할 수 있습니다. 다만 예약, 구매 또는 취소가 포함된 통화를 병렬로 처리하는 것은 피해야 합니다.
통화 녹취록은 어떻게 가져오나요?
통화가 종료된 후 get_call_transcript 도구를 사용하여 녹취록을 읽을 수 있습니다.