AgentCall is on Smithery
AgentCall's MCP server is live on Smithery, the largest registry for Model Context Protocol servers. Any AI agent that supports MCP can provision phone numbers, send SMS, extract OTP codes, configure an inbound AI receptionist, and place outbound voice calls through a single connection.
Sixty-two tools and five built-in prompts ship out of the box. AgentCall gives AI agents the same phone capabilities humans take for granted: a US or Canada phone number, a text inbox, the ability to dial out, and incoming calls answered autonomously by an AI voice agent. Numbers are VoIP-routed and built for agent-to-agent traffic and SMS verification on apps you control.
Smithery listing: smithery.ai/server/agentcall/agentcall
What is MCP and Why Does It Matter?
The Model Context Protocol (MCP) is an open standard that lets AI agents connect to external tools and services. Instead of writing custom API integrations for every service, agents discover and use MCP servers that expose structured tools. Think of it like USB for AI. Plug in a server, and the agent immediately knows what it can do.
For phone infrastructure this is a game changer. An AI agent running on Claude, Cursor, Windsurf, OpenClaw, or any MCP-compatible platform can now:
- Provision a real phone number in seconds
- Send and receive SMS programmatically
- Long-poll for OTP verification codes with automatic extraction
- Initiate outbound voice calls with transcripts
- Configure an autonomous AI receptionist on inbound calls
No API keys to configure manually, no SDK to install, no boilerplate code. The agent connects to AgentCall through MCP and starts using phone tools immediately.
62 MCP Tools Available Today
The AgentCall MCP server exposes 62 tools organized across fourteen categories. Here is what your agent can do:
Phone Numbers
- provision_number. Get a new phone number (US or Canada, local by default; toll-free and mobile on Pro).
- list_numbers. See all provisioned numbers.
- get_number. Get details on a specific number.
- update_number_label. Rename a number's human-readable label without touching anything else.
- update_number_voice. Change the inbound AI voice on an existing receptionist without resetting the system prompt, first message, recording flag, or pre-call context webhook.
- update_number_language. Switch the inbound AI language (31 supported, plus auto-detect) on a number.
- release_number. Release a number when done.
Inbound AI Voice
- configure_inbound_ai. Wire up inbound AI voice so incoming calls are answered autonomously by a configurable receptionist. Optionally set a
contextWebhookURL so the AI fetches live context (today's brief, current priorities) from a customer-controlled endpoint on every call. - disable_inbound_ai. Turn off inbound AI on a number.
Premium Voice
- list_premium_voices. List the premium voice options available.
- set_premium_voice. Enable a premium voice on a number.
- disable_premium_voice. Revert a number to the standard voice.
Voice Billing
- set_byok_openai_key. Bring your own key for voice so usage bills to your own provider account.
- disable_byok. Switch back to managed billing.
Outbound AI Defaults
- set_outbound_defaults. Save a reusable outbound AI agent (goal, persona, voice) on a number.
- get_outbound_defaults. Read the saved outbound defaults for a number.
- clear_outbound_defaults. Remove the saved outbound defaults.
SMS
- send_sms. Send a text message from any provisioned number.
- get_inbox. List inbound messages for a number, with an OTP-only filter.
- get_message. Fetch a single message by ID.
- wait_for_otp. Long-poll for an OTP verification code with automatic extraction.
- list_sms_conversations. List two-way AI SMS conversation threads.
- get_sms_conversation. Read one thread with its recent messages.
- reply_to_sms_conversation. Send a reply straight into a two-way SMS thread.
Voice Calls
- initiate_call. Start a standard outbound voice call.
- initiate_ai_call. Start an AI-powered outbound call that follows a system prompt.
- get_call. Get details and status for a specific call.
- get_call_transcript. Retrieve the transcript of a completed AI call.
- hangup_call. Terminate an active call.
- list_calls. List recent calls.
- synthesize_speech. Generate standalone speech audio from text, off-call, using the same 10 call voices (Pro plan, $0.03 per 1,000 characters).
Scheduling
- create_schedule. Schedule a future SMS or action so the agent follows up on its own.
- list_schedules. List scheduled jobs.
- cancel_schedule. Cancel a scheduled job.
Webhooks
- create_webhook. Register event webhooks (SMS, OTP, call status, recording).
- list_webhooks. View active webhooks.
- rotate_webhook_secret. Rotate the signing secret for a webhook.
- delete_webhook. Remove a webhook.
Account and Upgrade
- get_plan. Read the account's offer, trial status, limits, and billing state before quoting allowances or taking a paid action.
- upgrade_to_pro. Return a Stripe checkout link so the human can upgrade to Pro. The human completes the payment, and the agent rereads
get_planafterward.
Usage
- get_usage. Pull a usage and cost breakdown for the current or a past billing period.
AgentFM
- request_agentfm_callback. Submit a callback request to AgentFM so the AI host calls a phone number back to record a short podcast conversation. No account or Pro plan required.
Auditable Call Memory: Read
- list_contacts, get_contact, get_contact_by_phone. Look up the people the agent has talked to.
- get_next_call_context. Pull the stitched brief for an upcoming call.
- get_current_memory, get_memory, get_memory_timeline. Read source-backed facts and how they changed over time.
- list_memory_candidates. See facts awaiting approval.
- list_call_reports, get_call_report. Read post-call reports with evidence quotes.
Auditable Call Memory: Write and Briefs
- update_contact, purge_contact. Edit or delete a contact.
- update_memory, delete_memory. Correct or remove a stored fact.
- approve_memory_candidate, reject_memory_candidate. Confirm or discard a proposed fact.
- set_memory_enabled. Toggle memory for the account.
- list_briefs, acknowledge_brief, resolve_brief. Work the briefs inbox the agent surfaces after calls.
On top of the 62 tools, the server registers five MCP prompts that walk an agent through common workflows: setup-agent-phone, send-and-track-sms,ai-outbound-call, follow-up-on-call, and setup-inbound-ai-receptionist.
How to Connect
There are three ways to plug AgentCall into an MCP client. The hosted endpoint is the fastest path; npx is for local or air-gapped setups; Smithery is for clients that browse the registry.
Hosted endpoint (recommended)
Point your MCP client at the hosted URL and authenticate with a Bearer header. Same URL for every client:
URL: https://api.agentcall.co/mcp
Header: Authorization: Bearer ac_live_xxxSee /docs/mcp for copy-paste configs for Claude Desktop, Claude Code, Cursor, Windsurf, and OpenAI Codex.
Smithery
Browse and install from the Smithery registry: smithery.ai/server/agentcall/agentcall. Smithery prompts you for the configuration values defined in smithery.yaml(API key, default country, default number type, OTP timeout, AI voice, optional webhook URL), and handles OAuth and token refresh for clients that prefer it over Bearer headers.
Or install via the Smithery CLI:
npm install -g smithery
smithery mcp add agentcall/agentcall \
--headers '{"agentcallApiKey":"ac_live_xxx"}'Smithery hosts its own MCP URL for the server at https://agentcall--agentcall1.run.tools, which clients can use directly if they prefer Smithery's session management to AgentCall's native endpoint.
npm (local or air-gapped)
AGENTCALL_API_KEY=ac_live_xxx npx -y @agentcall/mcp-serverOr, in Claude Code, one command:
claude mcp add agentcall --env AGENTCALL_API_KEY=ac_live_xxx -- npx -y @agentcall/mcp-serverCreate an account and get an API key at agentcall.co/sign-up. 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.
Real-World Use Cases
Automated QA Testing
AI agents running QA pipelines can provision a phone number, enter it in a signup form, wait for the OTP code, verify the account, and release the number, all without human intervention. The wait_for_otp tool long-polls for up to 60 seconds by default and returns the extracted verification code automatically. Live OTP extraction requires Pro on new accounts, and numbers are for apps you control; third-party services may reject VoIP numbers.
Outbound AI Voice Agents
Build agents that make autonomous phone calls. Provision a number, dial a destination with a system prompt via initiate_ai_call, then pull a full transcript withget_call_transcript. Useful for appointment scheduling, surveys, lead qualification, and customer outreach.
Inbound AI Receptionist
Provision a number, then call configure_inbound_ai 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.
Agent-to-Human Communication
Give an agent a persistent phone number it can use to send SMS updates, receive customer replies, and maintain ongoing conversations. Each agent gets its own isolated number, with no cross-contamination between agents or customers.
Why Smithery?
Smithery is where developers and AI agents discover MCP servers. With thousands of servers listed and active users, it is the npm of the MCP ecosystem. Publishing AgentCall on Smithery means any MCP-compatible agent can find and use phone infrastructure without the developer writing a single line of integration code.
The AgentCall MCP server is also published to npm as @agentcall/mcp-serverfor developers who prefer to run it locally. The hosted endpoint at https://api.agentcall.co/mcp, the Smithery listing, and the npm package all connect to the same AgentCall API and expose the same 62 tools.
Pricing
AgentCall has a one-time trial and a Pro plan:
- Trial 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 ($19.99/month). Numbers at $2/mo each (toll-free $2.50/mo), outbound calls at $0.035/min, SMS at $0.015/message, call recording at $0.01/min, and AI voice at $0.40/min managed or $0.10/min with your own key, with 10 standard voices including marin and cedar. Premium Voice is $0.59/min.
Get Started
AgentCall's MCP server is live. Everything you need:
- AgentCall on Smithery
- MCP setup docs (Claude Desktop, Cursor, Windsurf, Codex)
- Create an AgentCall account
- Use AgentCall with Claude Code and with OpenAI Codex
- 5 best phone APIs for AI agents compared
- API documentation
- npm: @agentcall/mcp-server
- npm: agentcall (Node.js SDK)
Questions? Email support@agentcall.co. Our support agent responds twice daily.