Available MCP Tools

This is the catalog of tools the Duvo MCP server makes available once your host is connected. It 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.

Agents

Tool	Description
`listAgents`	List Agents for your team.
`createAgent`	Create a new Assignment.
`getAgent`	Get an Agent by ID.
`updateAgent`	Update an Agent’s display name or delivery settings.
`deleteAgent`	Delete an Assignment. Active Runs are interrupted, and its schedules and Case Triggers are removed.
`getEvalScores`	Get aggregate evaluation scores for an Agent’s Runs since a given time.
`getEvalRubrics`	List the platform and Assignment-specific evaluation rubrics for a build.

Agent Folders

Tool	Description
`listAgentFolders`	List folders for organizing Agents.
`createAgentFolder`	Create a new folder.
`updateAgentFolder`	Rename or update a folder.
`deleteAgentFolder`	Delete a folder.
`moveAgentsToFolder`	Move one or more Agents into a folder.

Setups

A Setup is a versioned configuration of an Agent — its AOP, Connections, and other settings.

Tool	Description
`listAgentRevisions`	List Setups for an Agent.
`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 Runs.

Runs

Tool	Description
`listRuns`	List Runs for your team.
`startRun`	Start a new Run on an Assignment.
`getRun`	Get a Run’s current status and details.
`listRunMessages`	List all messages exchanged during a Run.
`postRunMessage`	Send a message to an active Run.
`respondToHumanRequest`	Respond to a human-in-the-loop request from an active Run.
`stopRun`	Stop an active Run.
`getRunEvaluation`	Get the latest evaluation for a completed Run.

Agent Memory

Tool	Description
`listAgentMemoryFiles`	List the memory files an Agent has saved.
`getAgentMemoryFile`	Get the contents of a single Agent 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 Agent. Queues group related cases.

Tool	Description
`listQueues`	List queues for your team.
`createQueue`	Create a new queue.
`getQueue`	Get a queue by ID.
`updateQueue`	Update a queue’s name or settings.
`deleteQueue`	Delete a queue.
`listQueueAgents`	List Agents 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.
`bulkReprocessCases`	Re-process a batch of cases on a chosen Assignment.
`bulkUpdateCaseStatus`	Update the status of multiple cases at once.
`listCaseRuns`	List Runs for a specific case.
`listCaseRunRecentMessages`	Get recent messages from the latest Run 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 Agent.
`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.

Triggers

Event triggers start a Run automatically when an external event fires (for example, an email arrives, a Linear issue is created, or a file changes in Google Drive).

Tool	Description
`listAgentTriggers`	List the event triggers you own for an Agent.
`upsertAgentTrigger`	Create or update an event trigger for an Agent.
`listAgentTriggerTypes`	List the available trigger types for an Agent by Connection.

Suggestions

Duvo proposes improvements to an Assignment based on its past Runs — for example, adding, removing, or replacing a Connection. These tools manage the suggestions inbox.

Tool	Description
`listAgentSuggestions`	List an Assignment’s pending or historical suggestions.
`consumeAgentSuggestion`	Apply a suggestion to the Assignment’s draft Setup.
`rejectAgentSuggestion`	Dismiss a pending suggestion.

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 Agents that use a Skill.

Schedules

Tool	Description
`listAgentSchedules`	List schedules configured for an Agent.
`createSchedule`	Create a schedule for an Agent.
`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.
`getRevisionCaseQueueSetup`	Check that a Setup’s case-queue slots each point at a queue.
`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
`listMyTeams`	List teams the authenticated caller can act on.
`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.
`getClarityCurrentProcessSnapshot`	Get a snapshot of the current process.
`getClarityTransformationProposalSnapshot`	Get a snapshot of a transformation proposal.

Connect to the Duvo MCP server — set up a host before calling these tools
Public API Reference — exact request and response shapes for each tool

​Agents

​Agent Folders

​Setups

​Runs

​Agent Memory

​Files

​Cases and Queues

​Case Labels

​Case Triggers

​Triggers

​Suggestions

​Connections

​Skills

​Schedules

​Secrets and Logins

​Setup Configuration

​Sandboxes

​Team

​Process Intelligence

​Related