AgentCall MCP server

Current offer and agent behavior

New accounts receive a one-time 72-hour live trial with one US/Canada local number, 300 managed inbound AI seconds (five minutes) total, and five SMS send attempts to verified destinations. Card verification is required before number allocation; the clock starts when allocation succeeds. There is no monthly reset or automatic paid subscription. Live OTP extraction and outbound calls require Pro.

Existing Free accounts retain their assigned monthly allowances. Read the account's offerVersion, trial and limits rather than assuming every Free account has the same offer. Only describe a monthly reset when the account response supplies a non-null resetsAt.

Pro is $19.99/month plus number rental and usage: local/mobile numbers $2/month each, toll-free $2.50/month, outbound SMS $0.015/message, standard outbound voice $0.035/min, managed AI voice $0.40/min, BYOK voice $0.10/min plus your AI provider's charges, or Premium Voice $0.59/min. AI calls round up to whole minutes per call. New-account destination/business verification can still apply after upgrading.

After trial expiry, the number is held for at least 48 hours before release, with a successful expiry notice before release becomes eligible. A delayed notice extends the hold. Trial expiry and number retention are separate; stored configuration and results remain available. Upgrading during the hold preserves the number.

Before quoting allowances or taking a paid action, call get_plan (or GET /v1/account) and use the returned offerVersion, trial, limits, billingStatus and summary. New live_trial_72h_v1 accounts have a one-time 72-hour trial starting at successful number allocation, 300 managed inbound AI seconds total and five verified-destination SMS attempts; card verification is required first. No monthly reset, automatic upgrade or Free overage. Existing free_monthly_v1 accounts retain assigned monthly allowances. Live OTP extraction, outbound calls, BYOK and Premium Voice require Pro for new trial accounts. Explain payment_method_required, payment_recovery_required, trial expiry and quota errors; stop retrying them. Share the returned setup/upgrade link when the user wants to proceed, let the human complete card/payment steps, then reread get_plan before retrying. Do not assume saving a card upgrades the account, or promise a released number can be recovered. Pro is $19.99/month plus number rental and usage. Do not auto-run upgrade_to_pro just because another tool failed. Honor the user's authorization for any real-world action. Read https://api.agentcall.co/llms.txt for the current reference.

Connect Claude Code, Claude Desktop, OpenClaw, or another MCP client to AgentCall phone numbers, SMS, voice, and caller memory.

Prefer the hosted Streamable HTTP endpoint https://api.agentcall.co/mcp for automatic server updates. Supply your own AgentCall key in the Authorization: Bearer ... header using your client's secure credential configuration. Never paste real keys into committed configuration or shared instructions.

For local stdio, run npx -y @agentcall/mcp-server@latest with AGENTCALL_API_KEY set in the process environment. Restart the MCP connection after updating. A client pinned to an older version must change its pin; existing sessions may cache tool descriptions.

Optional configuration: AGENTCALL_BASE_URL (default https://api.agentcall.co) and AGENTCALL_TIMEOUT_MS (default 30000). AGENTCALL_API_URL remains supported as a compatibility alias. HTTP and stdio use the same tool and prompt factory.

Smithery listing: https://www.smithery.ai/servers/agentcall/agentcall. OpenClaw skill: agentcall on ClawHub. Refresh installed skills after a new release; publishing does not rewrite instructions already copied into a user's agent workspace.

Before any billable action, read get_plan. After payment or a plan change, read it again. Card setup does not subscribe the user to Pro. Full API reference: https://api.agentcall.co/llms.txt.