These are the tools the MonoPbx MCP server offers. Each tool runs the same check as the matching REST API call, as the user who connected the assistant, so department limits and every other rule of the console apply. An assistant only sees the tools whose permission its connection holds (see scopes).
- Kind: read tools change nothing. Write tools change something or reach outside the company; their descriptions tell the assistant to confirm with the user first, and they count against the daily limits.
- Permission: the scope the connection needs. It is the permission of the REST call (when the call takes either of two permissions, both are listed and either one is enough), except for
clickToCall (self:call) and sendSms (messaging:write), which need a named scope through MCP.
- Untrusted: the answer holds text written by people outside the company (callers, SMS senders, customers, web pages). It starts with a note telling the assistant to treat that text as data only.
Tool names and arguments follow the REST API: a tool's arguments are the path and query parameters of the call, plus body for a JSON body and if_match for a change to a stored record. Lists take limit and cursor.
You and your calls
| Tool | Kind | Permission | What it does | Notes |
|---|
getMe | read | self:read | Who is connected and their effective permissions | |
getMyStatus | read | self:read | Your statuses and forwarding rules | |
listMyCalls | read | self:read | Your own call history | Untrusted |
getMyCall | read | self:read | One of your calls with its legs | Untrusted |
listMyContacts | read | self:read | List or search your personal contacts | Untrusted |
clickToCall | write | self:call | Rings your own phone, then dials the number | Reaches outside |
Voicemail and SMS
| Tool | Kind | Permission | What it does | Notes |
|---|
listVoicemailMailboxes | read | self:read | The voicemail mailboxes you can read | |
listVoicemailMessages | read | self:read | The messages of a mailbox | Untrusted |
getVoicemailTranscript | read | self:read | The transcript and AI summary of a voicemail message | Untrusted |
searchAllVoicemailTranscripts | read | self:read | Search the transcripts of all your voicemail | Untrusted |
listSmsConversations | read | self:read | Your SMS conversations | Untrusted |
listSmsMessages | read | self:read | The messages of an SMS conversation | Untrusted |
searchConversations | read | self:read | Search call transcripts and messages you may see | Untrusted |
sendSms | write | messaging:write | Sends an SMS or MMS from one of your numbers | Reaches outside; SMS limit |
People and directory
| Tool | Kind | Permission | What it does | Notes |
|---|
listDirectoryPeople | read | directory:read | The colleagues directory | |
getPresenceSnapshot | read | directory:read | Everyone's live presence now | |
listUsers | read | users:read | List users | |
getUser | read | users:read | One user | |
getUserStatus | read | users:write or team:status | A user's statuses and forwarding rules | |
updateUserStatus | write | users:write or team:status | Switches a user's current status or sets a temporary one | Changes how their calls are forwarded |
listDepartments | read | departments:read | List departments | |
getDepartment | read | departments:read | One department | |
listExtensions | read | extensions:read | List extensions | |
getExtension | read | extensions:read | One extension | |
listPhonebookContacts | read | contacts:read | List or search the company phonebook | Untrusted |
createPhonebookContact | write | contacts:write | Adds a contact to the company phonebook | |
updatePhonebookContact | write | contacts:write | Changes a phonebook contact | Needs if_match |
Calls, queues and reports
| Tool | Kind | Permission | What it does | Notes |
|---|
listCalls | read | call_history:read | The company's call history | Untrusted |
getCall | read | call_history:read | One call with its legs | Untrusted |
listActiveCalls | read | calls:control | The calls in progress | Untrusted |
listScheduleStatus | read | calls:control or team:status | Whether each schedule (business hours) is open now | |
listQueues | read | queues:read | List queues | |
getQueue | read | queues:read | One queue | |
listRingGroups | read | ring_groups:read | List ring groups | |
getRingGroup | read | ring_groups:read | One ring group | |
getQueuesLive | read | queues:monitor | Live snapshot of the queues: callers waiting, agents | |
getQueueWaits | read | queues:monitor | Live waits of the queues with the predicted wait of callback offers | |
setAgentPresence | write | queues:monitor | Logs a queue agent in or out, or pauses them | |
listQueueCallbacks | read | queues:read | A queue's callback requests | Untrusted |
getQueueCallbackSummary | read | queues:read | Summary of a queue's callbacks | |
getQueueReport | read | reports:read | Queue performance | |
getAgentReport | read | reports:read | Agent activity | |
getExtensionReport | read | reports:read | Extension statistics | |
getSlaReport | read | reports:read | Service level | |
getAbandonedReport | read | reports:read | Abandoned calls and callbacks | |
Dialer and AI campaigns
| Tool | Kind | Permission | What it does | Notes |
|---|
listCampaigns | read | queues:read | List dialer campaigns | |
getCampaign | read | queues:read | One dialer campaign | |
getCampaignLive | read | queues:read | The live picture of a dialer campaign | |
listCampaignContacts | read | queues:read | A campaign's contacts | Untrusted |
addCampaignContacts | write | queues:write | Adds contacts to a dialer campaign; they are called once it runs | Only numbers that agreed to be called |
listAiOutboundCampaigns | read | settings:read | List the outbound AI call campaigns | |
getAiOutboundCampaign | read | settings:read | One outbound AI call campaign | |
Starting, pausing and stopping a campaign stay in the console.
Jira and Confluence
| Tool | Kind | Permission | What it does | Notes |
|---|
searchJiraIssues | read | jira:read | Search Jira issues | Untrusted |
getJiraIssue | read | jira:read | Read a Jira issue | Untrusted |
getJiraIssueSla | read | jira:read | Check a Jira issue's SLA | |
searchAtlassianKnowledge | read | jira:read | Search the synced Confluence and service-desk articles | Untrusted |
createJiraTicket | write | jira:write | Creates a Jira issue | Jira limit |
addJiraComment | write | jira:write | Comments on a Jira issue | Jira limit |
updateJiraIssue | write | jira:write | Changes a Jira issue or moves it along its workflow | Jira limit |
createJiraIssue | write | jira:issues | Creates a Jira issue from a call, voicemail or chat record | Jira limit |
See Jira and the AI for setting up the Jira connection.
| Tool | Kind | Permission | What it does | Notes |
|---|
listIntegrationInstalls | read | integrations:read | The company's integration installs (settings and state; never their secrets) | |
getIntegrationInstall | read | integrations:read | One integration install | |
testIntegrationInstall | write | integrations:write | Tests an install's connection to the other system | Reaches outside |
syncIntegrationInstall | write | integrations:write | Re-checks an install against the other system now | Reaches outside |
listMcpAiTools | read | ai_tools:invoke | The company's own AI tools an owner offered to MCP clients | |
invokeAiTool | write | ai_tools:invoke | Calls one of those tools | Reaches outside; untrusted |
startAiReceptionistSetup | write | settings:write | Reads the company's public website and proposes an AI receptionist | Reaches outside; untrusted |
getAiReceptionistSetup | read | settings:read | One AI receptionist setup run | Untrusted |
recrawlAiReceptionistSetup | write | settings:write | Reads the run's website again | Reaches outside; untrusted |
The company's own AI tools that an owner offered to MCP clients also appear in the tool list under their own names (see AI tools, connectors and knowledge). A tool that asks for confirmation first answers with a read-back and a one-time confirmation_token and sends nothing; the assistant repeats the exact call with that confirmation_token only after the user said yes. The server runs the tool only for that token (same connection, same arguments, within 10 minutes, once). Putting an AI receptionist live on a number stays in the console.
Administration
| Tool | Kind | Permission | What it does | Notes |
|---|
getCompanyHealth | read | settings:read | The company's health checks | |
listBranchNodes | read | settings:read | Branch survival nodes and their link state | |
listTrunkStatus | read | trunks:read | The company's trunks with their live state | |
getVoicePlan | read | voice_plan:read | The company's MonoPbx Voice plan and bundles | |
getVoicePlanUsage | read | voice_plan:read | MonoPbx Voice usage of the period | |
listVoiceNumbers | read | voice_numbers:read | The MonoPbx Voice numbers | |
listScimActivity | read | audit:read | Who the identity provider provisioned or removed | |
getSiemSinkHealth | read | audit:read | Whether the company's SIEM export is up and how many events it sent or lost | |
Managing users, roles, API keys, trunks, settings, backups and the MCP access itself is never a tool.
Resources and prompts
- Resource
mpbx://guide/tools: a short guide for the assistant with the rules above and the tools this connection may call.
- Prompts:
missed-calls (argument days, 1 to 31), voicemail-triage and queue-day (argument queue). They only use read tools.