Agent Call MCP

The Agent Call MCP server prepares a phone call for your task and dials only after you explicitly confirm the plan.

  • 269 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • The assistant phones third parties on your behalf and spends money on OpenAI and Twilio.
  • The server stores provider keys, the owner number and conversation transcripts.
All reasons and checks

xiyaowang0519/agent-call

Install

Manual install

uv tool install /absolute/path/to/agent_call-0.1.0-py3-none-any.whl

The build sits in the v0.1.0 release attachments and is not on PyPI. Then `agent-call doctor --dummy` and `agent-call serve --profile evaluation --host 127.0.0.1 --port 8000`.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The assistant phones third parties on your behalf and spends money on OpenAI and Twilio.
  • The server stores provider keys, the owner number and conversation transcripts.

This is third-party code. Review the repository files before installing.

What it does

Agent Call runs as its own server to which an AI assistant connects through MCP. The assistant takes a task, a recipient number and a list of details it may share from the user, then drafts a call plan. Preparation dials nothing: the call starts only after the plan is explicitly confirmed. OpenAI GPT-Live handles the conversation over SIP and Twilio places the call, while the user can follow the call, suggest answers, stop it and later request the result and a transcript. The service runs on your own computer with your own OpenAI and Twilio accounts. The `evaluation` profile disables dialing for a safe trial.

Who it is for. People who want an assistant to phone a service or shop while keeping approval of the plan, and who are ready to run their own server.

Good fit when

  • A workshop must be asked whether it takes a bicycle this week, without booking a time.
  • A call to a recipient is prepared with a limited set of details the assistant may state.
  • The conversation must be watched live with the option to stop the call.
  • A result and transcript are needed afterwards for a report.

Not a fit when

  • A ready-made service without your own accounts is needed: OpenAI keys and a Twilio number are required here.
  • Regular ChatGPT chat mode is required: the author verified ChatGPT Work and Claude in the browser.
  • The recipient must not learn that a program is calling: disclosure and consent rules fall on the owner.

Example request

Prepare a call to the repair shop to ask whether they can fix a bicycle this week, book nothing, and show me the plan before dialing.

MCP

Transport
http
Authentication
OAuth

Environment variables

MCP_BEARER_TOKEN secret
Token for clients that connect to `/mcp/` with an Authorization header.
ALLOWED_AGENT_USER_ID
User ID sent in the `X-Agent-User-Id` header for the same connection method.

Limitations

This is an early-stage 0.x project built for a single owner. Python 3.12, an OpenAI key with Live SIP access, a Twilio account and number, a public HTTPS address and paid usage on both services are required. Build 0.1.0 sits in GitHub releases and is not on PyPI. Do not restart the service during a call. The owner is responsible for consent, disclosure and transcript retention. The latest commit is dated November 2026.

How to disable. Stop the `agent-call` server and remove the connector in the client. Remove the package with `uv tool uninstall agent-call`, delete data and settings in `~/.agent-call` by hand and revoke the OpenAI and Twilio keys with the providers.

FAQ

Does the assistant call without my consent?

No. Preparing a plan dials nothing, and starting in the live profile needs a reviewed plan and explicit confirmation. In the `evaluation` profile starting a call is blocked with the `live_calls_disabled` code.

How do I connect Claude in the browser?

Add a custom connector in Claude web with the remote MCP server address `https://YOUR_HOST/connect/mcp/` and complete login on the Agent Call page. ChatGPT needs Work mode, as regular chat could not prepare a call.

How many tools does the server have?

Seven. The `agent-call smoke-prepare` check connects, lists them and prepares a plan without dialing.

Where are settings stored?

In `~/.agent-call`. A separate instance can be chosen with the `--directory /path/to/private-folder` flag.

Is a public address required?

Yes, webhooks and browser clients need public HTTPS. On first launch `agent-call start` downloads a verified Cloudflare tunnel helper and obtains a temporary address without a separate account.

Discussion

No questions or reviews yet.

A phone API for AI agents: Claude and Cursor get a real number, make and take calls, read SMS and transcripts over MCP.

MCP serverBroad access62Repository stars

An agent messages your phone or calls it over VoIP, a voice AI discusses the decision and the transcript returns to the agent

SkillBroad access401Repository stars
Official

PlaceCall phones US businesses for your agent: bookings, quotes and inquiries, with the outcome and a transcript sent back.

MCP serverBroad access117Repository stars
Official

SeldonFrame MCP server and plugin: an agent builds a client site, booking flow, CRM and AI agent from one request

MCP serverBroad access70Repository stars
Official

Aident's remote MCP server: the agent finds and runs actions in email, chat and CRM through connected accounts, and the server logs every call

MCP serverBroad access
Official

A self-hosted control plane for running several agents: task dispatch, run review, spend tracking, connected via MCP, CLI or REST

MCP serverBroad access6.5KRepository stars

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
Agent Call (this card)noOAuth269
Phone Harness MCPyesOAuth793Controls a smartphone for in-app actions; Agent Call places calls through Twilio and OpenAI Live SIP with plan confirmation
WhoBot phone call skillyes119A skill for calls from chat; Agent Call runs as its own MCP server with the owner accounts

README in short

The project is described as a server for assistant calls on the owner behalf: setup, modes, limits and clients. Local evaluation needs only `agent-call doctor --dummy` and `agent-call smoke-prepare`. Live calls turn on after OpenAI and Twilio are configured.

README badge

Report a problem