Documentation Index
Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt
Use this file to discover all available pages before exploring further.
The Duvo MCP server exposes every Public API endpoint as a tool. Tool names are the OpenAPI operationId values — camelCase, stable identifiers. Renaming a value is a breaking change, so names only change in major releases.
New Public API endpoints automatically become MCP tools on the next deploy. There is no separate registration step.
Assignments
| Tool | Description |
|---|
listAgents | List Assignments for your team. |
createAgent | Create a new Assignment. |
getAgent | Get an Assignment by ID. |
updateAgent | Update an Assignment’s display name or delivery settings. |
deleteAgent | Delete an Assignment. Active Jobs are interrupted, and its schedules and Case Triggers are removed. |
Assignment Folders
| Tool | Description |
|---|
listAgentFolders | List folders for organizing Assignments. |
createAgentFolder | Create a new folder. |
updateAgentFolder | Rename or update a folder. |
deleteAgentFolder | Delete a folder. |
moveAgentsToFolder | Move one or more Assignments into a folder. |
Setups
A Setup is a versioned configuration of an Assignment — its SOP, Connections, and other settings.
| Tool | Description |
|---|
listAgentRevisions | List Setups for an Assignment. |
getRevision | Get a Setup by ID. |
createRevision | Create a new Setup for an existing Assignment. |
updateRevision | Update a Setup’s name or SOP. |
promoteRevision | Promote a Setup to active, making it the one used for new Jobs. |
Jobs
| Tool | Description |
|---|
listRuns | List Jobs for your team. |
startRun | Start a new Job on an Assignment. |
getRun | Get a Job’s current status and details. |
listRunMessages | List all messages exchanged during a Job. |
postRunMessage | Send a message to an active Job. |
respondToHumanRequest | Respond to a human-in-the-loop request from an active Job. |
stopRun | Stop an active Job. |
Assignment Memory
| Tool | Description |
|---|
listAgentMemoryFiles | List the memory files an Assignment has saved. |
getAgentMemoryFile | Get the contents of a single Assignment memory file. |
Files
| Tool | Description |
|---|
listFiles | List Files for your team. |
createFileUploadUrl | Generate a signed URL to upload a new file to team storage. |
getFileContent | Get the text content of a file. |
updateFileContent | Update the text content of a file. |
getFileDownloadUrl | Generate a signed download URL for a file. |
renameFile | Rename a file. |
deleteFile | Delete a file from team storage. |
Cases and Queues
Cases are individual work items routed through an Assignment. Queues group related cases.
| Tool | Description |
|---|
listQueues | List case queues for your team. |
createQueue | Create a new case queue. |
getQueue | Get a queue by ID. |
updateQueue | Update a queue’s name or settings. |
deleteQueue | Delete a queue. |
listQueueAgents | List Assignments attached to a queue. |
listCases | List cases in a queue. |
searchCases | Search for cases across queues. |
getCase | Get a case by ID. |
createCases | Create new cases in a queue. |
deleteCase | Delete a case. |
bulkRetryCases | Retry a batch of failed cases. |
bulkDelegateCases | Delegate a batch of cases to another queue or Assignment. |
bulkUpdateCaseStatus | Update the status of multiple cases at once. |
listCaseRuns | List Jobs for a specific case. |
listCaseRunRecentMessages | Get recent messages from the latest Job on a case. |
Case Labels
| Tool | Description |
|---|
listQueueLabels | List labels defined in a queue. |
createQueueLabel | Create a new label in a queue. |
updateQueueLabel | Update a queue label’s name or color. |
deleteQueueLabel | Delete a queue label. |
listCaseLabels | List labels currently assigned to a case. |
assignCaseLabels | Assign one or more labels to a case. |
unlinkCaseLabels | Remove labels from a case. |
Case Triggers
Case triggers automatically route new cases to a queue based on matching rules.
| Tool | Description |
|---|
listAgentCaseTriggers | List case triggers for an Assignment. |
createAgentCaseTrigger | Create a new case trigger. |
getAgentCaseTrigger | Get a case trigger by ID. |
updateAgentCaseTrigger | Update a case trigger’s rules or settings. |
deleteAgentCaseTrigger | Delete a case trigger. |
previewAgentCaseTriggerConflicts | Preview conflicts before saving a case trigger. |
Connections
| Tool | Description |
|---|
listIntegrations | List available connection types for your team. |
listConnections | List your team’s authorized Connections. |
getConnection | Get a Connection by ID. |
createConnection | Create a new Connection. |
updateConnection | Update a Connection’s settings. |
deleteConnection | Remove a Connection. |
getConnectionCredentials | Get credentials for a Connection. |
createCustomIntegration | Register a custom MCP server as a Connection type. |
deleteCustomIntegration | Remove a custom MCP server Connection type. |
probeMcpServer | Test connectivity to an MCP server URL. |
startNativeOAuth | Start an OAuth flow for a native provider (Gmail, Google Sheets, Outlook, etc.) and return an authorization URL. |
startComposioConnection | Start a Composio OAuth flow and return an authorization URL. |
connectComposioIntegration | Finalize a Composio-backed connection after completing the OAuth start step. |
authorizeMcpOAuth | Start an OAuth flow for a remote MCP server using Dynamic Client Registration and return an authorization URL. |
checkMcpOAuth | Probe an MCP server URL to discover whether it supports OAuth Dynamic Client Registration. |
listPluginCatalog | List built-in plugins that can be referenced by name in a Setup’s plugins array. |
Skills
| Tool | Description |
|---|
listSkills | List Skills for your team. |
listSystemSkills | List system-wide Skills available to all teams. |
createSkill | Create a new Skill. |
listSkillFiles | List files in a Skill. |
getSkillFileContent | Get the content of a Skill file. |
updateSkillFile | Update the content of a Skill file. |
downloadSkill | Download a Skill as an archive. |
deleteSkill | Delete a Skill. |
listSkillAssignments | List Assignments that use a Skill. |
Schedules
| Tool | Description |
|---|
listAgentSchedules | List schedules configured for an Assignment. |
createSchedule | Create a schedule for an Assignment. |
updateSchedule | Update an existing schedule. |
deleteSchedule | Delete a schedule. |
Secrets and Logins
| Tool | Description |
|---|
listSecrets | List stored secrets for your team. |
createSecret | Create a new stored secret. |
getSecret | Get a secret by ID. |
updateSecret | Update a secret. |
deleteSecret | Delete a secret. |
listCredentials | List stored Logins for your team. |
createCredential | Create a new Login. |
getCredential | Get a Login by ID. |
updateCredential | Update a Login. |
deleteCredential | Delete a Login. |
Setup Configuration
These tools attach Connections, Logins, and Secrets to a specific Setup.
| Tool | Description |
|---|
listRevisionIntegrations | List Connections attached to a Setup. |
attachRevisionIntegrations | Attach one or more Connections to a Setup. |
removeRevisionIntegration | Remove a Connection from a Setup. |
listRevisionIntegrationConnections | List Connection instances for an integration slot on a Setup. |
pinRevisionIntegrationConnection | Pin a specific Connection to an integration slot on a Setup. |
unpinRevisionIntegrationConnection | Unpin a Connection from an integration slot on a Setup. |
listRevisionIntegrationQueues | List queues configured for an integration slot on a Setup. |
replaceRevisionIntegrationQueues | Replace the queues configured for an integration slot on a Setup. |
listRevisionLogins | List Logins attached to a Setup. |
attachRevisionLogin | Attach a Login to a Setup. |
detachRevisionLogin | Remove a Login from a Setup. |
listRevisionSecrets | List Secrets attached to a Setup. |
attachRevisionSecret | Attach a Secret to a Setup. |
detachRevisionSecret | Remove a Secret from a Setup. |
Sandboxes
| Tool | Description |
|---|
createSandbox | Create a new sandbox environment. |
createSandboxUploadUrl | Generate a signed URL to upload files to a sandbox. |
listSandboxFiles | List files in a sandbox directory. |
uploadSandboxFile | Upload a file directly to a sandbox. |
Team
| Tool | Description |
|---|
getTeam | Get your team’s details. |
listTeamMembers | List members of your team. |
getProfile | Get your user profile. |
Process Intelligence
| Tool | Description |
|---|
listClarityProcesses | List process captures for your team. |
getClarityProcess | Get a process capture by ID. |
getLegacyClarityProcess | Get a legacy process capture by ID. |
listClarityExtraCaptureRequests | List pending extra capture requests for a process. |
assignClarityExtraCaptureRequest | Assign an extra capture request. |
generateClarityCurrentProcess | Generate the current process analysis from captures. |
generateClarityTransformationProposal | Generate an automation proposal for a process. |
stopClarityTransformationProposal | Stop a running transformation proposal generation. |
buildClarityAutomation | Build an Assignment from a transformation proposal. |
revertClarityCurrentProcess | Revert the current process to a previous snapshot. |
revertClarityTransformationProposal | Revert a transformation proposal to a previous snapshot. |
getClarityCurrentProcessSnapshot | Get a snapshot of the current process. |
getClarityTransformationProposalSnapshot | Get a snapshot of a transformation proposal. |
promoteClarityCurrentProcess | Promote the current process snapshot to active. |
promoteClarityTransformationProposal | Promote a transformation proposal snapshot to active. |
