Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Telnyx con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Fai lavorare la tua AI con Telnyx: controlla saldo e consumi, elenca e cerca numeri di telefono, invia SMS e MMS, fai chiamate che leggono un messaggio, consulta registrazioni delle chiamate e record di dettaglio, verifica numeri, invia e controlla codici monouso con Verify e consulta i tuoi assistenti AI.
Prova a chiedere
Prompt di esempio per Telnyx
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Telnyx, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Telnyx
Fai lavorare la tua AI con Telnyx: controlla saldo e consumi, elenca e cerca numeri di telefono, invia SMS e MMS, fai chiamate che leggono un messaggio, consulta registrazioni delle chiamate e record di dettaglio, verifica numeri, invia e controlla codici monouso con Verify e consulta i tuoi assistenti AI.
Setup
- Accedi al Mission Control Portal su
https://portal.telnyx.com. - Apri Account settings → Keys & Credentials → API Keys e fai clic su Create API Key. La chiave inizia con
KEYe Telnyx la mostra una sola volta. - Incollala in
TELNYX_API_KEYcosì come la mostra Telnyx, senza la parola Bearer, e installa il connettore. La chiave viene inviata solo ad api.telnyx.com. - Verifica la configurazione con
telnyx_get_balance: è gratuito e mostra saldo, limite di credito e valuta.
Chi vede cosa: la chiave agisce per l'intero account Telnyx, saldo compreso. Condividi il server MCP solo con persone autorizzate a spendere su quell'account.
Costa denaro e raggiunge persone reali, quindi l'AI chiede prima: Telnyx addebita telnyx_send_message (SMS e MMS), telnyx_dial_call (al minuto), telnyx_speak_text (sintesi vocale) e telnyx_send_verification (per verifica). Prima di ognuno l'AI ti mostra destinatario, mittente e contenuto e aspetta il tuo sì. telnyx_lookup_number è a pagamento per ogni ricerca, quindi l'AI ti avvisa prima di verificare molti numeri. Inviare, chiamare e acquistare richiedono un account con credito.
Disattivato all'installazione: telnyx_order_phone_numbers, che acquista numeri con un costo iniziale e un canone mensile per numero. Un amministratore lo attiva consapevolmente; l'AI mostra poi ogni numero con i suoi costi e acquista solo dopo la tua conferma. La ricerca di numeri con telnyx_search_available_numbers è gratuita.
SMS: un numero invia SMS solo se è assegnato a un messaging profile (telnyx_list_messaging_profiles mostra i profili e i paesi verso cui ognuno può inviare). Un nuovo messaggio parte come queued; telnyx_get_message mostra in seguito lo stato di consegna per destinatario. Con link a contenuti multimediali il messaggio diventa un MMS (Stati Uniti e Canada).
Le chiamate richiedono una Call Control application: creane una nel Mission Control Portal e assegnale il numero da cui chiami. telnyx_list_call_control_applications fornisce il connection_id che serve a telnyx_dial_call. L'AI compone il numero, controlla con telnyx_get_call_status finché la chiamata non riceve risposta, legge il tuo messaggio con telnyx_speak_text e chiude con telnyx_hangup_call. Un limite di durata sulla chiamata tiene sotto controllo il costo. Gli eventi della chiamata vanno all'URL webhook dell'application, che questo connettore non riceve. Registrazioni: telnyx_list_recordings e telnyx_get_recording (i link di download scadono dopo pochi minuti).
Verify: crea una volta un Verify profile nel portale, in Verify; telnyx_list_verify_profiles lo elenca. telnyx_send_verification invia un codice via SMS, chiamata vocale o WhatsApp, e telnyx_check_verification_code controlla il codice inserito dalla persona.
Consumi e costi: telnyx_search_detail_records elenca singoli messaggi e chiamate con il loro costo; telnyx_get_usage_report_options e telnyx_get_usage_report danno i totali per prodotto fino a 31 giorni. Gli assistenti AI sono in sola lettura: telnyx_list_ai_assistants e telnyx_get_ai_assistant.
Numeri: sempre in formato E.164, cioè +, prefisso internazionale e numero senza spazi (+393471234567).
Errori comuni: 401 (10009): la chiave è errata, eliminata o è stata incollata con un prefisso; creane una nuova nel portale. 403: l'account non può ancora usare questa funzione (per esempio inviare verso un paese o acquistare numeri prima della verifica dell'account), oppure alla chiave manca il permesso. 404 (10005): la risorsa non esiste su questo account. 422: un parametro non è valido, per esempio il mittente non ha un messaging profile, la chiamata non ha ancora risposto o un numero non è in E.164. 429: troppe richieste; attendi e riprova.
Il connettore non copre portabilità dei numeri, configurazione e rilascio dei numeri, SIP trunking, TeXML, conferenze, fax, template WhatsApp, registrazione 10DLC di brand e campagne, creazione o modifica di assistenti AI e webhook.
Prerequisiti: TELNYX_API_KEY
Installazione locale del connettore
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Apri http://localhost:3000/connectors/store, scegli Telnyx e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| Tool | What it does |
|---|---|
telnyx_get_balance | Read the account balance: balance, pending, credit_limit, available_credit and currency |
telnyx_list_phone_numbers | List the phone numbers the account owns, newest first: id, phone_number (E.164), status, phone_number_type, country, the voice connection… |
telnyx_get_phone_number | Read one owned phone number by its id (from telnyx_list_phone_numbers): status, type, country, voice connection, messaging profile… |
telnyx_search_available_numbers | Search phone numbers that can be bought, by country, area, digits, type and features |
telnyx_order_phone_numbers | Buy phone numbers found with telnyx_search_available_numbers |
telnyx_get_number_order | Read a number order by its id: status (pending, success, failure), the numbers with their own status and whether the regulatory… |
telnyx_send_message | Send an SMS or MMS from a Telnyx number |
telnyx_get_message | Read one message by its id: direction, from, to with per-recipient delivery status (queued, sending, sent, delivered, sending_failed… |
telnyx_list_messaging_profiles | List the messaging profiles: id, name, enabled, webhook_url, whitelisted_destinations (countries the profile may send to), daily spend… |
telnyx_list_call_control_applications | List the Call Control applications (voice connections): id, application_name, active, webhook_event_url and outbound settings.… |
telnyx_dial_call | Place an outbound phone call through a Call Control application |
telnyx_get_call_status | Read the status of a call by its call_control_id: is_alive (false once it ended), call_duration in seconds, start_time and end_time |
telnyx_speak_text | Speak text to the other party on an answered call |
telnyx_hangup_call | Hang up a call that is still in progress |
telnyx_search_detail_records | Search detail records (CDRs and MDRs): one record per message, call leg, verification, recording and so on, with direction, numbers… |
telnyx_get_usage_report_options | List the products of the usage report and, for each, the dimensions and metrics telnyx_get_usage_report accepts (for example product… |
telnyx_get_usage_report | Get aggregated usage and cost for one product over at most 31 days, broken out by dimensions (e.g. date, direction, country) with metrics… |
telnyx_list_recordings | List call recordings, newest first: id, from, to, duration_millis, channels, status, start and end time and download_urls (mp3 and wav… |
telnyx_get_recording | Read one call recording by its id with fresh download_urls (mp3, wav), duration, channels and the call it belongs to |
telnyx_lookup_number | Look up a phone number: country, national format, E.164 form, and with type carrier the carrier name, line type (mobile, landline, voip)… |
telnyx_list_verify_profiles | List the Verify profiles: id, name, language and the settings per channel (sms, call, whatsapp, flashcall) such as code length and… |
telnyx_send_verification | Send a one-time code to a phone number by SMS, voice call or WhatsApp through a Verify profile |
telnyx_check_verification_code | Check the code a person entered against the latest verification sent to that number |
telnyx_get_verification | Read a verification by its id: phone_number, channel type, status (pending, accepted, invalid, expired, error) and when it was created |
telnyx_list_ai_assistants | List the account's Telnyx AI assistants (voice and chat agents): id, name, description, model, greeting, enabled features and creation date |
telnyx_get_ai_assistant | Read one AI assistant by its id: name, model, instructions (system prompt), greeting, tools, voice and transcription settings, telephony… |
Esempi di prompt
- "Qual è il nostro saldo Telnyx e quanto abbiamo speso in messaggi questo mese, suddiviso per paese?"
- "Invia un SMS dal nostro numero di Milano al +393471234567 per dire che l'ordine è pronto per il ritiro. Mostrami prima mittente, destinatario e testo."
- "Chiama il +393471234567 dalla nostra linea di assistenza, di' che il tecnico arriva alle 15 e poi riaggancia. Resta sotto il minuto."
- "Trova tre numeri mobili in Italia abilitati agli SMS e mostrami per ciascuno il costo iniziale e quello mensile."
- "Quali messaggi di ieri non sono stati consegnati? Controlla i record di dettaglio e mostrami stato e costo."
Prossimi passi
Questa guida ti è stata utile?
