Through the MCP server, your AI assistant orders numbers, connects them to your agent and sets up transfers and hold music. You say in one sentence what you need, and the assistant calls the right tools.
The server runs locally via npx @trunkbeam/mcp and requires Node.js 22 or newer. Create the API key in the dashboard under API, CLI & MCP and pass it as the environment variable TRUNKBEAM_API_KEY.
Tools
| Tool | What it does | Permission |
|---|---|---|
trunkbeam_account | Account, verification status, plan and the key’s permissions | Read |
trunkbeam_prices | Plans and prices | Read |
trunkbeam_list_sites | Sites; only verified sites get local numbers | Read |
trunkbeam_search_area_code | Search an area code by place or code | Read |
trunkbeam_list_numbers | Your numbers with target | Read |
trunkbeam_order_number | Order a local or 032 number, asks first | Order |
trunkbeam_list_number_requests | Orders and their status | Read |
trunkbeam_release_number | Cancel a number, asks first | Order |
trunkbeam_connect_number_elevenlabs | Connect a number to ElevenLabs in one step | Manage |
trunkbeam_set_number_target | Route a number to any SIP address | Manage |
trunkbeam_set_number_agent_fallback | Fallback number if the agent is unreachable | Manage |
trunkbeam_list_connections | Agent connections (SIP targets) | Read |
trunkbeam_create_connection | Create an agent connection | Manage |
trunkbeam_delete_connection | Delete an agent connection | Manage |
trunkbeam_provider_guide | Setup guide per provider with your real values | Read |
trunkbeam_get_transfer_policy | Show transfers to people | Read |
trunkbeam_set_transfer_policy | Change transfers, as default or per number | Manage |
trunkbeam_reset_number_transfer_policy | Delete a number’s own transfer settings | Manage |
trunkbeam_list_hold_music | Hold music with descriptions, so the assistant can pick a fitting track | Read |
trunkbeam_list_calls | Recent calls | Read |
trunkbeam_usage | Usage and cost for a month | Read |
Ordering and cancelling always take two steps. First the assistant fetches a quote with the price and shows it to you. Only after you agree does it confirm. The server rejects a confirmation without a prior quote.
Claude Code
claude mcp add trunkbeam \
-e TRUNKBEAM_API_KEY=tb_live_… \
-- npx -y @trunkbeam/mcp
With --scope user the server is available in all projects. With --scope project it goes into the repo’s .mcp.json and so to your whole team, but then the key does not belong in the file. Check with:
claude mcp list
Codex
codex mcp add trunkbeam \
--env TRUNKBEAM_API_KEY=tb_live_… \
-- npx -y @trunkbeam/mcp
Or directly in ~/.codex/config.toml:
[mcp_servers.trunkbeam]
command = "npx"
args = ["-y", "@trunkbeam/mcp"]
[mcp_servers.trunkbeam.env]
TRUNKBEAM_API_KEY = "tb_live_…"
Check with codex mcp list.
Cursor, Claude Desktop and others
In .cursor/mcp.json in the project, ~/.cursor/mcp.json for all projects, or for Claude Desktop in claude_desktop_config.json:
{
"mcpServers": {
"trunkbeam": {
"command": "npx",
"args": ["-y", "@trunkbeam/mcp"],
"env": { "TRUNKBEAM_API_KEY": "tb_live_…" }
}
}
}
Windsurf and most other clients read the same mcpServers block.
Keys for assistants
Give your assistant its own key with limited validity. For looking things up, the Read permission is enough. It needs Manage to change targets or transfers, and Order only if it really may buy numbers. You can revoke a key in the dashboard at any time.
Example
Get us a number for our Schramberg site and connect it to our ElevenLabs agent.
The assistant lists the sites, fetches the quote for a local number in area code 07422 and asks you about the price. After your OK, it orders, connects the number to ElevenLabs and shows you what to enter at ElevenLabs.