Tools
Every tool the Waylo MCP server gives an agent.
Each tool is one Waylo API operation. Its name is the operation's id, and its input is the operation's path and query parameters, plus body for the request body. The API reference describes each one in full.
A tool runs under the same rules as the API and the dashboard. It returns the operation's HTTP status and response:
{ "status": 200, "body": { "user": { "name": "…", "email": "…" } } }A call that runs past 30 seconds returns an error. For anything other than a read, the change may still happen: check before retrying.
Which tools an agent sees
- Signed in as a person: every tool below. A tool still fails if your role doesn't allow it.
- With an API key: only the tools the key's scopes allow. A tool that needs two scopes needs both. A workspace key sees no organization-level tools.
A tool the agent doesn't see answers Unknown tool and does nothing.
Not available as tools
Only operations an API key can call are tools, plus a few reads for a person who signed in. So these are never tools:
- Signing in and out, and changes to your own account.
- Creating, rotating and revoking API keys.
- Adding, removing and changing members and their workspaces, and lifting a login lock.
- Editing the organization profile.
- Approving and disconnecting agents.
- Uploading and downloading document files.
All tools
Role is the least role a person needs. API key is the scope a key needs; "Not available" means only a person who signed in gets the tool.
| Tool | Resource | Does | Role | API key |
|---|---|---|---|---|
listActivity | activity | List tenant activity | tenant_admin | Not available |
assignAgentDocument | agent-documents | Assign a document | workspace_admin | agents:write |
listAgentDocuments | agent-documents | List an agent’s documents | workspace_viewer | agents:read + documents:read |
unassignAgentDocument | agent-documents | Unassign a document | workspace_admin | agents:write |
assignAgentTool | agent-tools | Assign a tool | workspace_admin | agents:write |
listAgentTools | agent-tools | List an agent's tools | workspace_viewer | agents:read + tools:read |
unassignAgentTool | agent-tools | Unassign a tool | workspace_admin | agents:write |
createAgent | agents | Create agent | workspace_admin | agents:write |
discardAgentDraft | agents | Discard agent draft | workspace_admin | agents:write |
getAgent | agents | Get agent | workspace_viewer | agents:read |
getAgentDraft | agents | Get agent draft | workspace_admin | agents:read |
getAgentVersion | agents | Get agent version | workspace_viewer | agents:read |
listAgents | agents | List agents | workspace_viewer | agents:read |
listAgentVersions | agents | List agent versions | workspace_viewer | agents:read |
publishAgentDraft | agents | Publish agent draft | workspace_admin | agents:write |
restoreAgentVersion | agents | Restore agent version | workspace_admin | agents:write |
saveAgentDraft | agents | Save agent draft | workspace_admin | agents:write |
updateAgent | agents | Update agent | workspace_admin | agents:write |
listApiKeys | api-keys | List API keys | tenant_admin | Not available |
getCurrentUser | auth | Current user | authenticated | Not available |
createCatalog | catalogs | Create catalog | workspace_admin | catalogs:write |
createCatalogItems | catalogs | Create catalog items | workspace_admin | catalogs:write |
getCatalog | catalogs | Get catalog | workspace_viewer | catalogs:read |
listCatalogItems | catalogs | List catalog items | workspace_viewer | catalogs:read |
listCatalogs | catalogs | List catalogs | workspace_viewer | catalogs:read |
updateCatalog | catalogs | Update catalog | workspace_admin | catalogs:write |
createCredential | credentials | Create credential | workspace_admin | credentials:write |
getCredential | credentials | Get credential | workspace_viewer | credentials:read |
listCredentials | credentials | List credentials | workspace_viewer | credentials:read |
updateCredential | credentials | Update credential | workspace_admin | credentials:write |
getDelivery | deliveries | Get delivery | workspace_viewer | sessions:read |
listDeliveries | deliveries | List deliveries | workspace_viewer | sessions:read |
resendDelivery | deliveries | Resend delivery | workspace_admin | sessions:write |
createDestination | destinations | Create destination | workspace_admin | destinations:write |
getDestination | destinations | Get destination | workspace_viewer | destinations:read |
listDestinations | destinations | List destinations | workspace_viewer | destinations:read |
rotateDestinationSecret | destinations | Rotate signing secret | workspace_admin | destinations:write |
updateDestination | destinations | Update destination | workspace_admin | destinations:write |
deleteDocument | documents | Delete a document | workspace_admin | documents:write |
getDocument | documents | Get a document | workspace_viewer | documents:read |
listDocuments | documents | List documents | workspace_viewer | documents:read |
searchDocuments | documents | Search documents | workspace_viewer | documents:read |
updateDocument | documents | Update a document | workspace_admin | documents:write |
getOrder | orders | Get order | workspace_viewer | orders:read |
listOrders | orders | List orders | workspace_viewer | orders:read |
getPhoneNumber | phone-numbers | Get phone number | workspace_viewer | phone_numbers:read |
importPhoneNumber | phone-numbers | Import phone number | workspace_admin | phone_numbers:write |
listPhoneNumbers | phone-numbers | List phone numbers | workspace_viewer | phone_numbers:read |
provisionPhoneNumber | phone-numbers | Provision phone number | workspace_admin | phone_numbers:write |
updatePhoneNumber | phone-numbers | Update phone number | workspace_admin | phone_numbers:write |
listPresets | presets | List presets | authenticated | Any key |
getProviderCatalog | provider-catalog | Get provider catalog | authenticated | Any key |
deleteProviderKey | provider-keys | Delete provider key | tenant_admin | provider_keys:write |
getProviderKeyUsage | provider-keys | Provider key usage | tenant_member | provider_keys:read |
listProviderKeys | provider-keys | List provider keys | tenant_admin | provider_keys:read |
putProviderKey | provider-keys | Set provider key | tenant_admin | provider_keys:write |
updateProviderKeySettings | provider-keys | Update key settings | tenant_admin | provider_keys:write |
validateProviderKey | provider-keys | Validate provider key | tenant_admin | provider_keys:write |
getSessionEvents | session-events | Get session events | workspace_admin | sessions:read |
getSessionItems | session-items | Get session items | workspace_viewer | sessions:read |
createWebSession | sessions | Start a web session | workspace_member | sessions:write |
getSession | sessions | Get session | workspace_viewer | sessions:read |
listSessions | sessions | List sessions | workspace_viewer | sessions:read |
getStats | stats | Tenant stats | tenant_admin | stats:read |
createTelephonyConnection | telephony-connections | Create connection | tenant_admin | telephony:write |
getTelephonyConnection | telephony-connections | Get connection | tenant_member | telephony:read |
listTelephonyConnections | telephony-connections | List connections | tenant_member | telephony:read |
resyncTelephonyConnection | telephony-connections | Resync connection | tenant_admin | telephony:write |
updateTelephonyConnection | telephony-connections | Update connection | tenant_admin | telephony:write |
getTenantMe | tenants | Get my organization | tenant_member | Not available |
createTool | tools | Create tool | workspace_admin | tools:write |
discoverMcpTool | tools | Discover MCP functions | workspace_admin | tools:write |
discoverSavedMcpTool | tools | Discover a saved MCP tool | workspace_admin | tools:write |
getTool | tools | Get tool | workspace_viewer | tools:read |
listTools | tools | List tools | workspace_viewer | tools:read |
updateTool | tools | Update tool | workspace_admin | tools:write |
listTranscripts | transcripts | List transcripts | workspace_viewer | transcripts:read |
getUser | users | Get user | tenant_admin | Not available |
listUsers | users | List users | tenant_admin | Not available |
createWorkspace | workspaces | Create workspace | tenant_admin | workspaces:write |
getWorkspace | workspaces | Get workspace | tenant_member | workspaces:read |
listWorkspaceMembers | workspaces | List workspace members | tenant_member | Not available |
listWorkspaces | workspaces | List workspaces | tenant_member | workspaces:read |
updateWorkspace | workspaces | Update workspace | tenant_admin | workspaces:write |