Early Access: Dashboard, CLI, MCP-Server und REST-API sind nutzbar. Die Einrichtung für deinen Voice-Stack klären wir gern direkt mit dir.

MCP-Server

Nummern direkt aus Claude Code, Codex, Cursor oder jedem anderen MCP-Client verwalten.

Über den MCP-Server bestellt dein KI-Assistent Nummern, verbindet sie mit deinem Agenten und stellt Weiterleitung und Wartemusik ein. Du sagst in einem Satz, was du brauchst, der Assistent ruft die passenden Werkzeuge auf.

Der Server läuft lokal über npx @trunkbeam/mcp, Voraussetzung ist Node.js 22 oder neuer. Den API-Schlüssel legst du im Dashboard unter API, CLI & MCP an und gibst ihn als Umgebungsvariable TRUNKBEAM_API_KEY mit.

Werkzeuge

WerkzeugWas es machtRecht
trunkbeam_accountKonto, Prüfstatus, Tarif und Rechte des SchlüsselsLesen
trunkbeam_pricesTarife und PreiseLesen
trunkbeam_list_sitesStandorte; nur geprüfte bekommen OrtsnetznummernLesen
trunkbeam_search_area_codeOrtsnetz zu Ort oder Vorwahl suchenLesen
trunkbeam_list_numbersDeine Nummern mit ZielLesen
trunkbeam_order_numberOrtsnetz- oder 032-Nummer bestellen, mit RückfrageBestellen
trunkbeam_list_number_requestsBestellungen und ihr StandLesen
trunkbeam_release_numberNummer kündigen, mit RückfrageBestellen
trunkbeam_connect_number_elevenlabsNummer in einem Schritt mit ElevenLabs verbindenVerwalten
trunkbeam_set_number_targetNummer an eine beliebige SIP-Adresse leitenVerwalten
trunkbeam_set_number_agent_fallbackErsatznummer, wenn der Agent nicht erreichbar istVerwalten
trunkbeam_list_connectionsAgent-Anbindungen (SIP-Ziele)Lesen
trunkbeam_create_connectionAgent-Anbindung anlegenVerwalten
trunkbeam_delete_connectionAgent-Anbindung löschenVerwalten
trunkbeam_provider_guideEinrichtungsanleitung je Anbieter mit deinen echten WertenLesen
trunkbeam_get_transfer_policyWeiterleitung an Menschen anzeigenLesen
trunkbeam_set_transfer_policyWeiterleitung ändern, als Standard oder je NummerVerwalten
trunkbeam_reset_number_transfer_policyEigene Weiterleitung einer Nummer löschenVerwalten
trunkbeam_list_hold_musicWartemusik mit Beschreibung, damit der Assistent ein passendes Stück wähltLesen
trunkbeam_list_callsLetzte AnrufeLesen
trunkbeam_usageNutzung und Kosten eines MonatsLesen

Bestellen und Kündigen laufen immer in zwei Schritten: Zuerst holt der Assistent ein Angebot mit Preis und zeigt es dir. Erst nach deiner Zustimmung bestätigt er. Eine Bestätigung ohne vorheriges Angebot lehnt der Server ab.

Claude Code

claude mcp add trunkbeam \
  -e TRUNKBEAM_API_KEY=tb_live_… \
  -- npx -y @trunkbeam/mcp

Mit --scope user steht der Server in allen Projekten zur Verfügung. Mit --scope project landet er in der .mcp.json des Repos und damit bei deinem ganzen Team, dann gehört der Schlüssel aber nicht in die Datei. Prüfen mit:

claude mcp list

Codex

codex mcp add trunkbeam \
  --env TRUNKBEAM_API_KEY=tb_live_… \
  -- npx -y @trunkbeam/mcp

Oder direkt in ~/.codex/config.toml:

[mcp_servers.trunkbeam]
command = "npx"
args = ["-y", "@trunkbeam/mcp"]

[mcp_servers.trunkbeam.env]
TRUNKBEAM_API_KEY = "tb_live_…"

Prüfen mit codex mcp list.

Cursor, Claude Desktop und andere

In .cursor/mcp.json im Projekt, ~/.cursor/mcp.json für alle Projekte oder bei Claude Desktop in claude_desktop_config.json:

{
  "mcpServers": {
    "trunkbeam": {
      "command": "npx",
      "args": ["-y", "@trunkbeam/mcp"],
      "env": { "TRUNKBEAM_API_KEY": "tb_live_…" }
    }
  }
}

Windsurf und die meisten anderen Clients lesen denselben mcpServers-Block.

Schlüssel für Assistenten

Gib deinem Assistenten einen eigenen Schlüssel mit begrenzter Gültigkeit. Für reines Nachschauen genügt das Recht „Lesen“. „Verwalten“ braucht er, wenn er Ziele oder die Weiterleitung ändern soll, „Bestellen“ nur, wenn er wirklich Nummern kaufen darf. Einen Schlüssel kannst du im Dashboard jederzeit widerrufen.

Beispiel

Besorg uns eine Nummer für unseren Standort Schramberg und verbinde sie mit unserem ElevenLabs-Agenten.

Der Assistent listet die Standorte, holt das Angebot für eine Ortsnetznummer im Ortsnetz 07422 und fragt dich nach dem Preis. Nach deinem OK bestellt er, verbindet die Nummer mit ElevenLabs und zeigt dir, was du bei ElevenLabs eintragen musst.

Deinen Stack mit TrunkBeam verbinden