# MCP Phone Number: Give Any MCP Agent Calls and SMS

- **Canonical URL:** https://agentline.cloud/blog/mcp-phone-number-for-ai-agents
- **HTML:** https://agentline.cloud/blog/mcp-phone-number-for-ai-agents
- **Markdown:** https://agentline.cloud/blog/mcp-phone-number-for-ai-agents.md
- **Date:** 2026-11-13
- **Updated:** 2026-11-13
- **Author:** Sameer Srivastava
- **Read time:** 3 min read
- **Tags:** `MCP`, `AI Phone Number`, `Voice`, `SMS`, `AI Agents`, `Guide`

> Connect the AgentLine MCP server to Claude, Cursor, Codex or any MCP client so the agent can provision a phone number, place calls, send SMS and read transcripts as tools.

---

An MCP phone number is a real phone number that an AI agent controls through Model Context Protocol tools. With AgentLine, you add the MCP server at https://api.agentline.cloud/mcp with your API key as a bearer header. The agent can then provision a US or Canada number, place and answer calls, send and read SMS, and fetch transcripts as ordinary tool calls. Plans start at $20/month with a number included.

## Connect the MCP server

Create an API key in the AgentLine dashboard and set it privately as AGENTLINE_API_KEY. Any MCP client that can reach a remote server works. For a client that launches local commands, such as Claude Desktop or Cursor, add this entry to its MCP configuration:

```json
{
  "mcpServers": {
    "agentline": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://api.agentline.cloud/mcp", "--header", "Authorization: Bearer $AGENTLINE_API_KEY"]
    }
  }
}
```

In Claude Code the same connection is one command. The [Claude Code guide](/build/claude-code), [Cursor guide](/build/cursor) and [Codex guide](/build/codex) show each client's setup and first call.

```bash
claude mcp add agentline -- npx -y mcp-remote@latest https://api.agentline.cloud/mcp --header "Authorization: Bearer $AGENTLINE_API_KEY"
```

## What the MCP tools let the agent do

The [agent skill](/skill.md) lists 35 MCP tools, and every REST endpoint is also exposed as a tool. The ones a phone workflow uses most:

- **create_agent:** set the name and system prompt for the hosted voice that holds the conversation.
- **Number provisioning:** buy a US or Canada local number for that agent, list numbers, and reassign them.
- **make_outbound_call:** dial an E.164 number; the hosted voice talks and the call is recorded and transcribed.
- **send_sms:** send a text from the agent's number; inbound texts can be read back.
- **push_call_context:** give the voice live facts during a call when your runtime does a lookup.
- **Contacts:** create_contact, list_contacts and the related tools store up to 1,000 people per agent.

Your MCP client does not voice each turn. AgentLine's hosted voice agent runs the conversation from the prompt you set, and your agent reads the transcript afterwards. To answer mid-call questions from the agent's private context, use the relay or a webhook as described in the skill.

## First call in three requests

1. Ask the agent to create a phone agent with a short system prompt.
2. Ask it to buy a US local number for that agent.
3. Ask it to call your own phone and read you the transcript when the call ends.

Each step is a tool call that shows up in your MCP client, so you can approve purchases and calls before they run. Buying a number and placing calls cost money; keep approvals on for those tools.

## MCP, skill or REST

Use MCP when the agent itself should operate the phone from a chat or coding client. Use the [skill file](/skill.md) when your runtime reads skills instead of MCP servers. Use the REST API from a backend service; the [API walkthrough](/blog/agentline-api-developer-walkthrough) covers the same flow with curl. All three reach the same account, numbers and transcripts.

## Cost

AgentLine's published rates are monthly plans from $20 with included US or Canada numbers, call minutes and SMS; beyond the plan, $3.00/month per number, $0.12/minute for calls (per-second after a one-minute minimum; zero-second calls are free), and $0.02 per SMS in either direction. Check [pricing](/pricing) and your account's allowances before budgeting. Runtime hosting and external integrations can add costs.

Reviewed against [AgentLine API schema](https://api.agentline.cloud/openapi.json) and [agent skill](/skill.md). For a broader setup without MCP, see [How to Give Your AI Agent a Phone Number](/blog/ai-agent-phone-number-guide).

## Frequently Asked Questions

**What is an MCP phone number?**

A phone number an AI agent controls through Model Context Protocol tools. With AgentLine, the MCP server at https://api.agentline.cloud/mcp lets the agent buy a US or Canada number, make and receive calls, send SMS and read transcripts.

**Which MCP clients can use the AgentLine phone tools?**

Any client that supports remote MCP servers or mcp-remote, including Claude Code, Claude Desktop, Cursor and Codex. Authenticate with an Authorization: Bearer header carrying your AgentLine API key.

**Can an MCP agent send and receive SMS?**

Yes. The send_sms tool texts from the agent's number, and inbound messages to that number can be read back. SMS beyond the plan allowance is $0.02 per message in either direction.

**How much does an MCP phone number cost?**

Plans start at $20/month with a US or Canada number, call minutes and SMS included. Beyond the plan, extra numbers are $3.00/month, calls $0.12/minute and SMS $0.02 each.

---

## Related guides

- [Can Grok Bot Make Phone Calls? Built-in Calling, Dial Bot, and a Number of Its Own](https://agentline.cloud/blog/grok-bot-phone-calls) — also as markdown: https://agentline.cloud/blog/grok-bot-phone-calls.md
- [How Much Does It Cost to Give an AI Agent a Phone Number?](https://agentline.cloud/blog/ai-agent-phone-number-cost) — also as markdown: https://agentline.cloud/blog/ai-agent-phone-number-cost.md
- [Best API to Buy and Manage US and Canada Phone Numbers for an AI Calling App](https://agentline.cloud/blog/best-api-to-buy-us-phone-numbers-for-ai-calling-app) — also as markdown: https://agentline.cloud/blog/best-api-to-buy-us-phone-numbers-for-ai-calling-app.md

## About AgentLine

AgentLine gives AI agents real phone numbers for voice and SMS. Docs: https://docs.agentline.cloud · Pricing: https://agentline.cloud/pricing · Skill: https://agentline.cloud/skill.md
