WayloAIWaylo Docs
MCP server

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.

ToolResourceDoesRoleAPI key
listActivityactivityList tenant activitytenant_adminNot available
assignAgentDocumentagent-documentsAssign a documentworkspace_adminagents:write
listAgentDocumentsagent-documentsList an agent’s documentsworkspace_vieweragents:read + documents:read
unassignAgentDocumentagent-documentsUnassign a documentworkspace_adminagents:write
assignAgentToolagent-toolsAssign a toolworkspace_adminagents:write
listAgentToolsagent-toolsList an agent's toolsworkspace_vieweragents:read + tools:read
unassignAgentToolagent-toolsUnassign a toolworkspace_adminagents:write
createAgentagentsCreate agentworkspace_adminagents:write
discardAgentDraftagentsDiscard agent draftworkspace_adminagents:write
getAgentagentsGet agentworkspace_vieweragents:read
getAgentDraftagentsGet agent draftworkspace_adminagents:read
getAgentVersionagentsGet agent versionworkspace_vieweragents:read
listAgentsagentsList agentsworkspace_vieweragents:read
listAgentVersionsagentsList agent versionsworkspace_vieweragents:read
publishAgentDraftagentsPublish agent draftworkspace_adminagents:write
restoreAgentVersionagentsRestore agent versionworkspace_adminagents:write
saveAgentDraftagentsSave agent draftworkspace_adminagents:write
updateAgentagentsUpdate agentworkspace_adminagents:write
listApiKeysapi-keysList API keystenant_adminNot available
getCurrentUserauthCurrent userauthenticatedNot available
createCatalogcatalogsCreate catalogworkspace_admincatalogs:write
createCatalogItemscatalogsCreate catalog itemsworkspace_admincatalogs:write
getCatalogcatalogsGet catalogworkspace_viewercatalogs:read
listCatalogItemscatalogsList catalog itemsworkspace_viewercatalogs:read
listCatalogscatalogsList catalogsworkspace_viewercatalogs:read
updateCatalogcatalogsUpdate catalogworkspace_admincatalogs:write
createCredentialcredentialsCreate credentialworkspace_admincredentials:write
getCredentialcredentialsGet credentialworkspace_viewercredentials:read
listCredentialscredentialsList credentialsworkspace_viewercredentials:read
updateCredentialcredentialsUpdate credentialworkspace_admincredentials:write
getDeliverydeliveriesGet deliveryworkspace_viewersessions:read
listDeliveriesdeliveriesList deliveriesworkspace_viewersessions:read
resendDeliverydeliveriesResend deliveryworkspace_adminsessions:write
createDestinationdestinationsCreate destinationworkspace_admindestinations:write
getDestinationdestinationsGet destinationworkspace_viewerdestinations:read
listDestinationsdestinationsList destinationsworkspace_viewerdestinations:read
rotateDestinationSecretdestinationsRotate signing secretworkspace_admindestinations:write
updateDestinationdestinationsUpdate destinationworkspace_admindestinations:write
deleteDocumentdocumentsDelete a documentworkspace_admindocuments:write
getDocumentdocumentsGet a documentworkspace_viewerdocuments:read
listDocumentsdocumentsList documentsworkspace_viewerdocuments:read
searchDocumentsdocumentsSearch documentsworkspace_viewerdocuments:read
updateDocumentdocumentsUpdate a documentworkspace_admindocuments:write
getOrderordersGet orderworkspace_viewerorders:read
listOrdersordersList ordersworkspace_viewerorders:read
getPhoneNumberphone-numbersGet phone numberworkspace_viewerphone_numbers:read
importPhoneNumberphone-numbersImport phone numberworkspace_adminphone_numbers:write
listPhoneNumbersphone-numbersList phone numbersworkspace_viewerphone_numbers:read
provisionPhoneNumberphone-numbersProvision phone numberworkspace_adminphone_numbers:write
updatePhoneNumberphone-numbersUpdate phone numberworkspace_adminphone_numbers:write
listPresetspresetsList presetsauthenticatedAny key
getProviderCatalogprovider-catalogGet provider catalogauthenticatedAny key
deleteProviderKeyprovider-keysDelete provider keytenant_adminprovider_keys:write
getProviderKeyUsageprovider-keysProvider key usagetenant_memberprovider_keys:read
listProviderKeysprovider-keysList provider keystenant_adminprovider_keys:read
putProviderKeyprovider-keysSet provider keytenant_adminprovider_keys:write
updateProviderKeySettingsprovider-keysUpdate key settingstenant_adminprovider_keys:write
validateProviderKeyprovider-keysValidate provider keytenant_adminprovider_keys:write
getSessionEventssession-eventsGet session eventsworkspace_adminsessions:read
getSessionItemssession-itemsGet session itemsworkspace_viewersessions:read
createWebSessionsessionsStart a web sessionworkspace_membersessions:write
getSessionsessionsGet sessionworkspace_viewersessions:read
listSessionssessionsList sessionsworkspace_viewersessions:read
getStatsstatsTenant statstenant_adminstats:read
createTelephonyConnectiontelephony-connectionsCreate connectiontenant_admintelephony:write
getTelephonyConnectiontelephony-connectionsGet connectiontenant_membertelephony:read
listTelephonyConnectionstelephony-connectionsList connectionstenant_membertelephony:read
resyncTelephonyConnectiontelephony-connectionsResync connectiontenant_admintelephony:write
updateTelephonyConnectiontelephony-connectionsUpdate connectiontenant_admintelephony:write
getTenantMetenantsGet my organizationtenant_memberNot available
createTooltoolsCreate toolworkspace_admintools:write
discoverMcpTooltoolsDiscover MCP functionsworkspace_admintools:write
discoverSavedMcpTooltoolsDiscover a saved MCP toolworkspace_admintools:write
getTooltoolsGet toolworkspace_viewertools:read
listToolstoolsList toolsworkspace_viewertools:read
updateTooltoolsUpdate toolworkspace_admintools:write
listTranscriptstranscriptsList transcriptsworkspace_viewertranscripts:read
getUserusersGet usertenant_adminNot available
listUsersusersList userstenant_adminNot available
createWorkspaceworkspacesCreate workspacetenant_adminworkspaces:write
getWorkspaceworkspacesGet workspacetenant_memberworkspaces:read
listWorkspaceMembersworkspacesList workspace memberstenant_memberNot available
listWorkspacesworkspacesList workspacestenant_memberworkspaces:read
updateWorkspaceworkspacesUpdate workspacetenant_adminworkspaces:write

On this page