Widely

com.widely-mobile/widely · v1.0.0 · communication

Widely is healthy: it completed an MCP handshake in 1872 ms and exposes 68 tools.

Connect your communications to your AI.

Endpoint: https://mcp.widely-mobile.com/mcp (streamable-http)

Repository · Website · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count68
Latency1872 ms
Last checked (UTC)2026-10-16T01:30:13.701Z

Health history

Checked (UTC)StatusLatencyError
2026-10-16T01:30:13.701ZHealthy1872
2026-10-14T22:55:35.190ZHealthy2263

Tools (68)

list_identitiesReturns the phone numbers, caller IDs, verified SIM numbers, PBX extensions, and eSIMs on this Widely seat, with the provider that supplies each and what it can do.
search_callsFinds phone calls on this Widely seat by date range, direction, contact name, or number. Returns one row per phone call, with direction, duration, outcome, the identity used, and whether a transcript or recording exists.
get_callReturns full detail for one phone call, identified by call_id, including which identity and provider carried it.
get_transcriptReturns stored transcript text already saved for a phone call. Does not start a new transcription. While speaking is still in progress, the status is in_progress. Returns no_transcript only after the conversation has ended with no stored text.
get_recordingReturns a short-lived streaming link for a recorded phone call. Business plan, and the grant includes recordings.read.
list_voicemailsReturns recent voicemails on this seat with caller, time, duration, and transcript text when one is stored.
get_voicemailReturns one voicemail by call_id, including its transcript. include_audio also returns a short-lived audio link on Pro and above.
search_messagesSearches this user's Widely, SMS, and WhatsApp threads by keyword and date. Returns message text with sender and thread. Support and assistant threads are excluded.
get_threadReturns messages in one thread, oldest first. before is an ISO 8601 cursor for older pages.
search_contactsFinds saved contacts on this seat by name. Returns names and phone numbers.
send_messageSends an SMS or a Widely message to a phone number or saved contact. Pro plan. Sending happens on this request.
request_callRings the user's phones. After one answers, dials the destination into that same conversation. The result shows as an outgoing phone call. The user speaks on it. Pro plan. If no phone answers, the destination is not dialled.
get_usageReturns the eSIM data balance and minutes already used on this seat. company=true covers the whole account on Business.
get_forwardingReturns how this seat's numbers are forwarded. Pro plan.
update_forwardingPoints a verified number at a business number on this seat, or stops forwarding when forward_to is empty. Pro plan.
request_transcriptAsks Widely to transcribe a recording that has no text yet. Pro plan.
request_speakDials the number and the assistant handles the task on the phone. Business plan. The user's own phones stay quiet unless connect_user is true. Returns immediately with call_id. An empty transcript means speaking is still in progress. connect_user true asks the person to hold, rings the user's phones
list_pbxReturns shared numbers and phone menus. This user and the account owner need Business.
get_accountReturns the plan, wallet balance, how many people are on the account, how many eSIMs are live, and which setups this seat can run.
list_phone_systemReturns numbers and who answers them, AI receptionists with greeting, knowledge, voice, and languages, press-1 menus, queues, and opening hours with the weekly windows. The owner needs Business for shared phone-system features; queue agents, shared-number users, and direct person targets need Busine
list_teamReturns people on this account and pending email invites.
search_numbersFind Widely phone numbers available for a country and an optional city, with the monthly price. Use this when a local number is needed. No sign-in. This does not purchase a number.
quote_numberPrice a Widely phone number for a country, including the monthly amount and whether local calls are included. Use this when a UK, US, Israeli, or other local number is needed. Each number includes 2 simultaneous calls. More come in packs of 10, shared by the account's numbers in the same country; ch
quote_portPrice moving an existing number onto Widely. Use this when the current number should be kept. The move is not instant. No sign-in. This does not start the move.
get_portReturns the current status of a port request. A port is not instant.
quote_esimPrice Widely travel data for a country. Use this when a trip needs data and not a home mobile service. Pay as you go per GB, with no data package. An optional gb value returns an estimate billed in 0.1 GiB steps. No sign-in.
discover_servicesFind a home mobile service Widely can provide for a country, including eSIM or physical SIM, native voice, SMS, a mobile number, and a regular or kosher line when the offer includes it. No sign-in. An empty list means nothing is listed yet. Travel data for a trip is a separate Widely product.
quote_servicePrice one listed home mobile service for a form factor and number line that offer allows. The amount comes from that offer. No sign-in. This is separate from Widely travel data.
quote_callReturns the price for dialling a destination number or country. No sign-in. This does not place the call.
list_plansList Free, Pro, and Business monthly prices. Each monthly figure is per user. Quote that amount. Do not round it and do not call it an account price. No sign-in. This does not change the plan. Business covers the office phone system. channel_packs lists the 10-channel pack prices: number packs per c
invite_memberEmails an invitation to join this Widely account. New users start Free; there is no account user limit.
upsert_receptionistCreates or edits an AI receptionist. The account owner needs Business. It speaks with the caller and does not transfer the live conversation to a person.
update_whatsapp_aiPause, resume, choose who can see the WhatsApp chats, or set the webhook that answers first. Setting a webhook returns the signing secret once.
upsert_receptionist_knowledgeAdds or revises a knowledge entry for one receptionist. The next WhatsApp reply and the next phone call both use it.
get_receptionist_factsReturns one receptionist's profile, contacts, locations, opening hours, and categorized business facts before you update them.
upsert_receptionist_profileCreates or edits the business identity, IANA timezone, contact details, and human-escalation instructions used on phone and WhatsApp.
upsert_receptionist_locationStores a business address plus directions, parking, public transport, accessibility, location contacts, coordinates, and timezone.
delete_receptionist_locationDeletes one structured location from a receptionist.
delete_receptionist_knowledgeDeletes one categorized service, price, policy, FAQ, inventory, returns, donation, escalation, or custom fact.
delete_receptionist_hoursStops one receptionist from using its informational opening-hours schedule. It does not change DID open/closed routing.
upsert_menuCreates or edits a press-1 menu. The account owner needs Business. A key can ring a person, ring a queue, or send the caller to an AI receptionist. A direct person target and every queue agent also need Business.
upsert_queueCreates or edits a queue. The account owner and every queue member need Business. A queue rings only members who are signed in and available.
upsert_hoursCreates or edits a timezone-aware opening-hours schedule and optionally attaches it to an AI receptionist. Informational receptionist hours do not change DID routing. day is 0 for Monday through 6 for Sunday; start and end are HH:MM. Date-bounded is_closed windows are exceptions.
set_number_routingPoints a number at ring_me, personal_assistant, a receptionist, a menu, a queue, voicemail, busy, or decline. An optional closed target uses the opening hours. A shared line, receptionist, menu, or queue needs Business.
submit_product_noteSends Widely a note about a missing capability, a complaint, or a use case to build. No account is required. reply_url, when it is https, receives each desk reply. Returns conversation_id. Passing that id on a later request adds to the same thread.
get_product_noteReturns one product-note thread by conversation_id, oldest first. No account is required. Does not list other threads.
subscribe_eventsSets the https URL that receives call.started, call.ended, and speak.completed for this seat. events chooses which of those names to receive. Omitting events receives all three. An empty webhook_url stops delivery.
search_helpReturns public product facts and in-app menu names for a question. No sign-in. Does not return a price.
uk_divert_numberReturns the UK shared Always-forward destination and the dial code. No sign-in.
account_closure_optionsReturns the ways a customer stops charges without closing the account (cancel membership, stop a number renewing, remove a saved card) and that unused credit is refunded on closure. Full deletion is handled by Widely Support; no deletion steps. No sign-in.
delete_account_stepsFormer name, kept for existing connections. Returns the ways a customer stops charges without closing the account (cancel membership, stop a number renewing, remove a saved card) and that unused credit is refunded on closure. Full deletion is handled by Widely Support; no deletion steps. No sign-in.
port_requirementsReturns the documents a number port needs. No sign-in. Does not submit a port.
esim_install_stepsReturns the eSIM install path and the APN. The APN is null when this profile has no APN. No sign-in.
get_account_balanceReturns the live wallet total for this seat, the same headline as Home and Wallet. The response has no spendable or reserved breakdown.
list_wallet_activityReturns the wallet ledger of top-ups, product debits, and holds. Each row includes the customer label.
explain_chargesReturns charges already on this account, with amounts and labels. An empty list means there is no matching charge.
list_payment_methodsReturns masked saved cards and bank methods: brand, last4, and default. A processor id is not included.
get_data_rateReturns this customer's pay-as-you-go data ladder, starting from data already used this period. This is the account rate, separate from the public shelf. Omitting gb returns the volume points.
check_call_rateReturns the per-minute rate to a destination country or number for this account. The rate depends on the destination.
get_did_rateReturns an indicative monthly phone-number price for a country, using this account's rate checker.
list_did_numbersReturns this account's phone numbers, including numbers that stay inactive until identity registration is finished.
list_wallet_refundsReturns first-eSIM wallet top-ups that can be refunded to the card: the profile has not been installed and the top-up is inside the refund window.
get_auto_topupReturns whether auto top-up is on, and the threshold and amount.
get_notification_preferencesReturns notification toggles and the low-balance threshold.
run_esim_connection_checkAsks this user's Widely app to check the eSIM and returns a request_id. A result of no_install_yet means the profile may have been installed from a QR and the Widely app is not on that phone. An APN is not included.
get_esim_connection_checkReturns the result of an eSIM connection check for request_id, including fail and warn items. Phone settings are not changed.
ask_supportWrites a message into this user's Support chat for a person to read. Any connected account can send it. Support's own assistant does not answer this message. text is what is needed and what was already tried.
read_supportReturns messages in this user's Support chat, oldest first. Any connected account can read it. Other chats are not included.