How to give an AI agent a phone number
To give your AI agent a phone number, sign up for Mailrun Agent Identities and choose a plan with phone support. Connect your agent through a compatible, running public HTTPS voice endpoint, or enable the hosted receptionist in your customer portal.
Choose how you want calls answered
You have 2 options: connect your own agent or use the hosted receptionist. Your choice determines both the setup requirements and your per-minute call rate.
Your own agent can answer calls only through a compatible, running public HTTPS voice endpoint. If you choose this route, you need that endpoint ready to handle calls.
You can switch on the hosted receptionist in your customer portal without a developer integration, webhook or public endpoint. It says it is an AI assistant by default, takes messages and summarizes calls.
Choose based on whether you want to run your own answering agent or use the hosted receptionist’s message-taking functions.
| Item | Price |
|---|---|
| Phone number | $3 a month per number |
| Calls with your own agent | $0.13 a minute, billed per second |
| Calls with the hosted receptionist | $0.22 a minute, billed per second |
| Receptionist plan (phone only) | $0 a month plus $3 per number |
Budget for the number and call time
You pay $3 a month for each Mailrun phone number, plus call usage and any plan fee. Calls cost $0.13 a minute with your own agent or $0.22 a minute with the hosted receptionist. Both rates are billed per second.
For phone only, you can choose Receptionist at $0 a month plus the number charge and call usage. You do not need an email plan to use the hosted receptionist.
If you also need email, Solo costs $10 a month and Team costs $20 a month. Scale costs $199 a month. Each adds $3 a month per number and the applicable call usage.
Keep recurring number charges separate from usage when estimating your bill. Your answering option determines which call rate you should use.
Set up your connection
A person signs up at mailrun.ai/agents/checkout and creates API keys in the customer portal. Your agent cannot complete those account setup tasks alone.
You can connect through the HTTP API at https://agent-api.mailrun.ai or the hosted MCP server at https://agent-api.mailrun.ai/mcp. The MCP server uses Streamable HTTP.
Any MCP client that supports sign-in can connect with your Mailrun account, including Claude’s apps and Claude Code. If your client cannot sign in, or you prefer a key, use an API key from the customer portal as a bearer token.
Connecting an MCP client does not replace the voice endpoint requirement for your own agent. Choose your answering option before deciding which integration work you need.
- Sign up and choose Receptionist, Solo, Team or Scale.
- For your own agent, prepare a compatible, running public HTTPS voice endpoint.
- For the hosted receptionist, switch it on in your customer portal.
Check what happens when you change agents
Your phone number stays the same when you change your agent or model within Mailrun.
You can also transfer your Mailrun phone number to another carrier. This is called port-out.
Contact Mailrun support to start a transfer. Port-out is separate from changing the agent or model that uses your number within Mailrun.
See every plan on the pricing page, or connect an agent with the quickstart.
Questions
Can you get a phone number on Free?
No, Free is email only and includes no phone number. For phone only, choose Receptionist at $0 a month, plus $3 a month per number and call usage.
Do you need a public endpoint for the hosted receptionist?
No, you can enable the hosted receptionist in your customer portal without a public endpoint, webhook or developer integration. Your own agent needs a compatible, running public HTTPS voice endpoint to answer calls.
Can you take your Mailrun number to another provider?
Yes. Contact Mailrun support to transfer your phone number to another carrier. If you change your agent or model within Mailrun, you keep the same number without a transfer.
Facts about other providers on this page were taken from their public websites on November 12, 2026 and may have changed. Each name is a trademark of its owner. Mailrun is not affiliated with any of them. Spotted something out of date? Tell us.
More answers and comparisons
Give your agent an identity of its own.
Free plan, no card.
