Tools & permissions
What your assistant can do once ErzyCall is connected, and what each permission grants.
These are the actions your assistant gains. You don't need to memorise the names — describe what you want in plain language and the assistant picks the right one.
Connected organization
| Tool | What it does |
|---|---|
get_organization | Shows the connected organization's ID, name, description, contact details, and profile timestamps |
Ask "Which organization am I connected to?" No organization ID is needed. This read requires organization:read; reconnect and approve the permission if your existing connection does not have it. For plan and balance details, use get_usage.
See the organization API reference for the response fields.
Calls
| Tool | What it does |
|---|---|
create_call | Dial a contact using a chosen script and phone number, or an inbound agent with inboundAssistantId on a Dedicated/LiveKit number |
cancel_call | Cancel a call that hasn't started yet — status new or scheduled only |
list_calls, get_call | Outcome, duration, transcript, recording link |
A call already dialling or connected cannot be cancelled through MCP — cancel_call returns an error once the call leaves the new / scheduled state. Hang up from the dashboard instead.
Contacts
| Tool | What it does |
|---|---|
list_contacts, search_contacts, get_contact | Find people |
create_contact, update_contact, delete_contact | Manage people |
list_contact_groups | View groups |
| Tool | What it does |
|---|---|
send_whatsapp_message | Send a message |
list_whatsapp_conversations, get_whatsapp_conversation | Read conversations |
list_whatsapp_accounts | View connected accounts |
list_whatsapp_agents | Discover agents across accounts, including disabled agents |
get_whatsapp_agent | Read one agent's stored settings, effective defaults, and revision |
update_whatsapp_agent | Save confirmed changes to a specific agent, with revision and retry protection |
Agent configuration requires fresh authorization for whatsapp_agents:read and whatsapp_agents:write. Existing WhatsApp permissions and refreshed tokens do not gain these permissions automatically. Reconnect and approve the new permissions.
Select the exact account and agentId, read its settings, review the exact changes, then confirm the update. Supply only changed fields, the returned revision as expectedRevision, and a stable idempotencyKey. Empty optional strings and arrays clear their values. Reuse the same key, revision, and payload on retry; if the agent changed, read and review the change again. Read back after saving. Saving sends no message and applies when the runtime next loads the agent.
See WhatsApp API reference for fields, limits, and error recovery.
Scripts, assistants & numbers
| Tool | What it does |
|---|---|
list_cases, get_case, create_case, update_case, delete_case | Find and manage call scripts |
list_outbound_assistants, get_outbound_assistant, create_outbound_assistant, update_outbound_assistant, delete_outbound_assistant | Outbound assistants |
list_inbound_assistants, get_inbound_assistant, update_inbound_assistant | Inbound assistants |
list_phone_numbers | Connected phone numbers |
Plan & usage
| Tool | What it does |
|---|---|
get_usage | Current plan, minutes left on the balance, minutes spent this period, days until it renews |
list_usage_history | Every balance movement — call usage, renewals, top-ups, adjustments |
Things to try
- "Make a test call to [name] and say it's a test of the ErzyCall system."
- "How did yesterday's calls go? Which ones didn't connect?"
- "Add Sarah Chen, +60 12 345 6789, to my contacts and tag her as a lead."
- "Send a WhatsApp to everyone in the Warm Leads group confirming Thursday's webinar."
- "Show me the script for the Customer Onboarding case."
- "Is there a recording of the call with Maria?"
- "How many minutes do I have left, and how many days until my plan renews?"
- "What did we spend on outbound calls this month?"
Permissions & safety
During sign-in ErzyCall shows exactly what it's granting. The list maps to these scopes:
| Permission | What it allows | Risk |
|---|---|---|
organization:read | View the connected organization's profile and contact details | Low |
calls:read | View calls and call results | Low |
calls:write | Create, schedule, and cancel calls | Places real calls |
contacts:read | View and search contacts | Low |
contacts:write | Create, update, and delete contacts | Changes data |
contact_groups:read | View contact groups | Low |
cases:read | View call scripts | Low |
cases:write | Create, update, and delete call scripts | Changes call behaviour |
assistants:read | View assistants | Low |
assistants:write | Create, update, and delete assistants | Changes behaviour |
phone_numbers:read | View connected phone numbers | Low |
whatsapp:read | View WhatsApp accounts and conversations | Low |
whatsapp:write | Send WhatsApp messages | Contacts real people |
whatsapp_agents:read | View agent configuration, including prompts and knowledge | Reads private configuration |
whatsapp_agents:write | Update prompts, knowledge, audience routing, and activation | Changes agent behavior |
usage:read | View plan, minute balance, and usage history | Low |
Calls cost money and reach real people. Keep confirmation prompts on for create_call and send_whatsapp_message until you trust the setup.
- Test on yourself first. Add your own number as a contact and run one call end to end before pointing it at a customer list.
- One organization at a time. The connection is bound to the org you picked at sign-in. To switch, disconnect and reconnect.
- To revoke: remove the connector in your AI tool. There is no separate revocation screen in the ErzyCall dashboard today.