MCP serverio.github.duvoai/duvo

Accept a pending Process Landscape capture suggestion and create the durable capture request (manager+).

Accept a proposed area folder into the active process landscape, so it stops being a proposal and becomes part of the real structure (organization admin+). Only area folders can be

Accept a clarity interview invite link and gain process access.

Accept a pending Process Landscape team-assignment suggestion and durably assign the suggested team (manager+).

Accept the reviewed generated configuration and complete the builder run. The saved draft is not activated.

Activate a revision — promote a draft to live, or roll back to a historic one. Reconciles build/queue/trigger state to the new active revision and, when requested, re-pins the auto

Add an agent to an automation on a team that is on the Automations workspace, with or without revisions — membership is not versioned. The agent must not already belong to another

Add a queue to an automation on a team that is on the Automations workspace, with or without revisions — membership is not versioned. The queue must not already belong to another a

Add a person involved in the process behind a process landscape node. Name only records a placeholder; supplying an email also gives that person access to the process and emails th

Add a Policy question to this automation. Its key is `custom_` plus the label in snake_case, with `_2`, `_3` and so on appended when the key is taken, and it is placed at the end o

Answer a pending question the Duvo Pulse agent asked and resume the paused run (creator or team editors). Use the toolCallId from the dashboard's message transcript.

Assign one or more labels to a case. Creates the labels on the queue if they don't already exist.

Assign (or unassign, with `user_id: null`) a team member to fulfil an extra-capture request. Restricted to Lead Builders and above.

Assign an open Process Landscape capture request to a team member, or unassign it by sending userId: null (manager+).

Set the owning team of a process in the process landscape (organization admin+). On a proposed process this accepts the proposal and creates the real process for that team; on an e

Assign process tags to a process.

Attach one of your connections (data sources) to a Duvo Pulse dashboard so the agent can use its tools (requires edit access).

Put a queue on an existing Case schema, so both queues share one document and a later change moves them together. The queue must not already have a schema.

Attach one or more integrations to an agent revision. To pin specific connections after attachment, use pinRevisionIntegrationConnection. IMPORTANT for the case-queue-producer and

Attach a login to a revision so the agent can use it during Runs spawned from that revision. Personal logins can only be attached by their owner; team-shared logins require builder

Attach an env-var secret to a revision so its keys are injected into Runs spawned from that revision. Personal secrets can only be attached by their owner; team-shared secrets requ

Start an OAuth-based connection with a remote MCP server using Dynamic Client Registration. Returns an authorization URL the user must open in a browser; once they grant consent, D

Add one or more people to multiple Process Landscape nodes in a bounded batch. Email entries can create invitations; each node-person outcome reports success, conflict, or delivery

Hand an automation proposal for a v2 clarity process off to the workflow-builder pipeline. Builds from `transformation_proposal_id` when supplied, otherwise from the process's live

Invite several people to a team in one call, emailing each invitation immediately. Returns per-batch counts: `succeeded` were invited, `skipped` were already on the team, already h

Re-process multiple cases on a chosen agent. Any active runs on the selected cases are interrupted first; the cases are then reset to pending and assigned to the chosen agent for t

Set the priority of multiple cases. Priority only affects the order pending cases are picked up in: due postponed cases are handled first, then higher priority. It never interrupts

Update the status of multiple cases to pending, completed, failed, or canceled. Interrupts any active runs and releases their case ownership, but never cancels their human-in-the-l

Cancel a running builder run and pause its sandbox

Probe an MCP server URL to discover whether it supports OAuth Dynamic Client Registration. Returns the authorization endpoint and required scopes when supported. Useful as a precur

Complete a Miro artifact import after uploading to the signed URL. The uploaded bytes are validated before the import becomes a usable Clarity capture.

Complete a document capture after uploading to GCS via signed URL

Complete an image capture after uploading it to GCS via a signed URL

Complete an organization document capture after uploading to GCS; extracts text and stores it as a transcript so it feeds Process Landscape generation

Complete a team document capture after uploading to GCS; extracts text and stores it as a transcript so it feeds Process Landscape generation

Complete a video capture after uploading to GCS via signed URL

Connect an authorized same-team queue to a team-created Pulse before sampling it. Idempotent. This bounds dashboard data access; it never grants Process membership or case-action a

Apply a suggestion: stage its change into the Agent's draft revision, then auto-clear any pending suggestions it makes moot.

Create a new agent. Optionally include a build configuration to create the first build in the same request.

Create a case trigger for an agent. An agent may have at most one case trigger; this returns 409 if one already exists.

Create a new agent folder.

Create a Slack channel trigger on an agent (Agent in the Duvo UI): the agent starts a Run whenever a matching message is posted in the channel. An agent can carry one trigger per c

Create a new automation. Its first agent is created alongside it so the caller lands on something editable. On a team on revision semantics the automation holds a single draft revi

Create a draft revision branched from a base revision (defaults to the active revision), copying its agent, queue, and trigger bindings.

Issue a signed URL for uploading a file to a case. The client must PUT the bytes to the returned URL with the returned Content-Type, then call the finalize endpoint so the attachme

Add one case-level evaluation rubric to a queue's current rubric set. Case-level rubrics judge the whole case (across every Run that touched it) as a Pass/Fail question at settleme

Create one or more cases in a queue. Provide either a single `case` object or a `cases` array (1-100); providing both returns 400. Each case takes a title (max 500 chars), optional

Create a signed upload URL for importing a Miro export into a Clarity v2 process. Supports SVG, XML, PNG, and JPEG exports. The caller must upload the file to the returned URL, the

Create a signed URL for uploading a PDF, TXT, Markdown, BPMN, XLSX, or CSV document directly to GCS

Create a process folder

Create a new automation guidance message for a clarity process

Create a signed URL for uploading a PNG, JPEG, WebP, or SVG image directly to GCS

Create or regenerate a process-scoped Clarity interview invite link. Only the process creator or team managers can create invite links; creating a new link invalidates any prior ac

Create an area folder in the process tree. An active area (the default) requires organization admin+; a "proposal" area may be added by any organization member.

Create a signed URL for uploading a PDF, TXT, Markdown, or BPMN document as an organization-level Clarity capture

Create a new Clarity v2 process for the current team (Builder+). Optional `name` defaults server-side when omitted. Response uses camelCase `createdAt` to match existing FE clients

Create process tags for an organization.

Create a process-to-process link in the organization's Clarity landscape when the caller can manage both endpoint teams. If the same live source, target, and type already exists, t

File an existing Clarity process into an area of the process landscape (team manager or organization admin+). Use this for a process that already exists but sits in Unsorted; use p

Create a signed URL for uploading a PDF, TXT, Markdown, or BPMN document as a team-level Clarity capture

Create a signed URL for uploading a video file directly to GCS

Create a new user-provided connection (custom MCP server) for the current team. OAuth-based integrations (native) require an interactive browser flow — start them with the dedicate

Create a login. At least one of `password` or `otp_secret` must be provided. Personal by default; pass `shared: true` to create a team-shared login (requires lead builder role).

Create a custom integration type (team-level catalog entry) that users can then connect as user-provided MCP connections. Requires manager-or-above role.

Add one Agent-specific evaluation rubric to a build. A build may hold at most 5 custom rubrics; this fails with 409 once that ceiling is reached. Defaults to the Agent's live build

Generate a signed URL for uploading a file directly to GCS.

Create a new team under an organization you administer. Requires an organization Admin, Executive, or Owner role.

Create a new Duvo Pulse dashboard from a natural-language prompt (e.g. 'open cases by queue this week') and dispatch the first generation turn. Generation is asynchronous — poll GE

Issue a presigned upload URL for a file to attach to a Duvo Pulse dashboard message (e.g. an HTML dashboard to copy, or a screenshot to match). POST the file bytes to the returned

Start a comment thread on a Duvo Pulse dashboard (requires view access). Pass `element` — captured from the dashboard canvas — to pin the thread to one element; omit it for a comme

Reply to a comment thread on a Duvo Pulse dashboard (requires view access). `commentId` must be a thread root; threads are one level deep. A thread already marked complete still ac

Create a new queue.

Create an immutable aggregation definition on a queue.

Declare a queue's first Case schema by hand, so a person can type a queue up front instead of waiting for its producing agent to declare the shape. Fails if the queue already has a

Create a label on a queue without assigning it to a case.

Create a new revision for an existing agent.

Create a new sandbox for file uploads. The returned sandbox_id can be passed to POST /v2/teams/:team_id/runs to stage data for a run.

Get a presigned URL for uploading a file into a sandbox. Use for files larger than 10MB; smaller files can be uploaded directly via POST /v2/sandboxes/:sandbox_id/files.

Create a schedule for an agent. The schedule fires against the agent's live build. The authenticated user owns the schedule.

Create an env-var secret. Personal by default; pass `shared: true` to create a team-shared secret (requires lead builder role).

Create or update a skill from a JSON body. The server constructs SKILL.md from the provided fields and stores it. If a skill with the same name already exists in the team, it is up

Open a draft revision of a skill, copying its files from the active revision (or from `source_revision_id`). Edit the draft with updateSkillRevisionFile and deleteSkillRevisionFile

Invite one person to a team. Pass `processId` to invite them to a specific Clarity process instead of the whole team (that requires the `team:clarity-member` role). Creating the in

Create or regenerate the team's shareable invite link — the one URL anyone can use to join the team. Regenerating invalidates the previous link, so anyone still holding the old URL

Reject a proposed process landscape node while it is still a proposal, removing it and any proposed descendants. Real processes nested underneath survive and move back to Unsorted.

Discard generated changes by restoring checkpoint_config and completing the builder run. The saved draft is not activated.

Delete an agent and cascade-clean its schedules, case triggers, builder runs, and handover targets. Any active jobs are interrupted and their sandboxes paused.

Delete a case trigger. Only the trigger creator or a builder/admin can delete it.

Delete an agent folder. If the folder contains assignments or subfolders, pass `force=true` to delete it and move the contained assignments to the root level.

Permanently delete one of your own event triggers on an agent. The agent stops starting Runs for that event and the trigger's filter config is lost. To keep the trigger but stop it

Soft-delete all notifications for the authenticated user's current team, read or unread. Returns the count of notifications that were deleted. Destructive — only call on explicit u

Soft-delete an automation. Its member agents and queues stop dispatching and disappear from listings, but their underlying rows and run history are preserved (not erased) so the au

Discard a draft revision and its bindings. Only drafts can be discarded; live and historic revisions are immutable history.

Delete a case. Interrupts any associated active runs first.

Remove a file from a case. The row is soft-deleted; deletion of the stored object is attempted best-effort.

Remove a single case-level evaluation rubric. Cases settled after this are no longer judged against it; already-judged cases keep their original verdicts. Removing the queue's last

Soft-delete an open or running artifact-chat conversation for the current user.

Delete a capture from a clarity process

Delete a process folder. Contained processes fall back to Unfiled.

Soft-delete a tree node and its descendants. Organization admins may delete any subtree; team managers may delete a childless process node owned by their team. The targeted node's

Delete an organization-scoped folder interview

Delete an organization-level Clarity interview

Delete a Clarity process. The creator or a team admin can delete it unless capture analysis is still in progress, or an automation still runs it — an automation holds the process's

Delete the active interview invite link for a process.

Delete process tags from an organization.

Delete a process-to-process link from the organization's Clarity landscape when the caller can manage both endpoint teams.

Delete a team-level Clarity interview

Delete a connection (disconnects the user's connection and removes any triggers bound to it).

Delete a login by id. Deleting a team-shared login requires lead builder role.

Delete a custom integration type (team-level catalog entry) and cascade-remove related connections. Requires manager-or-above role.

Remove a single Agent-specific evaluation rubric. Future Runs on the build are no longer scored against it.

Delete a file from team storage.

Delete a Duvo Pulse dashboard. Only the creator can delete it.

Delete a comment or reply on a Duvo Pulse dashboard. Allowed for the comment's author and for the dashboard's creator. Deleting a thread root keeps its replies, rendered under a de

Delete a queue. Interrupts all associated active runs first and returns the number of deleted cases plus the IDs of runs that were stopped.

Soft-delete an aggregation definition.

Delete a label from a queue. Cascade-deletes all assignments of this label on existing cases.

Soft-delete all read notifications for the authenticated user's current team. Returns the count of notifications that were deleted. Destructive — only call on explicit user request

Delete a schedule. Owners may delete their own schedules; team superadmins may delete any schedule on agents in the current team. A schedule that migration folded into an automatio

Soft-delete an env-var secret. Deleting a team-shared secret requires lead builder role.

Delete a skill for the current team.

Delete a draft or historic skill revision and its files. The active revision can't be deleted — activate another revision first.

Delete a file from a skill revision. Deleting from a draft leaves the active revision untouched until the draft is promoted; deleting from the active revision changes what the skil

Permanently delete a Slack channel trigger you own. The agent stops starting Runs for that channel. To keep the trigger but stop it firing, update it with `enabled: false` instead.

Revoke a pending invitation so its link and email can no longer be used. Accepts either a team invitation (requires Superadmin or above on the invitation's team) or a Clarity proce

Delete the team's shareable invite link so the URL stops working. Per-person invitations are unaffected. Requires the Manager role or above.

Detach a connection (data source) from a Duvo Pulse dashboard (requires edit access).

Stop validating new cases on a queue. Typed cases already written keep their payload and their pinned schema version.

Detach a login from a revision. Personal logins can only be detached by their owner; team-shared logins require builder permissions.

Detach an env-var secret from a revision. Personal secrets can only be detached by their owner; team-shared secrets require builder permissions.

Disconnect a source from a team-created dashboard. Subsequent dashboard reads and writes immediately lose access. Idempotent; does not delete the queue or cases.

Dismiss a pending Process Landscape capture suggestion without creating a capture request (manager+).

Dismiss a pending Process Landscape team-assignment suggestion without changing the node's owner (manager+).

Dismiss an important notification for the authenticated user. A row pinned to their Important section is unpinned and the card stays, because the connection is still broken; a row

Download a custom skill as a ZIP archive. Only custom (team-owned) skills can be downloaded.

Duplicate an existing agent into a new agent named "Copy of <name>", carrying over its configuration. Use the include_* flags in the (optional) body to control what is copied; all

Duplicate a Clarity process with its analysis, captures, message history, and, for v2 processes, its live current map and automation proposal. Requires a team manager role.

Duplicate a Duvo Pulse dashboard, producing an idle clone of the current rendered dashboard. The conversation history, shares, and connections are not copied.

Evaluate an aggregation definition against the current data without persisting it.

Export a queue's cases, respecting the same status, severity, approval, priority, label, date-range, json_data field, and free-text filters as the list view. Set awaiting_my_approv

Render a Duvo Pulse dashboard to a self-contained static HTML snapshot (text/html, data baked in). 404 until the first generation turn has produced HTML; 409 for an openui dashboar

File every unfiled process the viewer can see into its suggested folder

Confirm an uploaded case attachment against storage. Answers with the attachment in its settled state — `ready` when the bytes are present, `failed` (with a reason) when the upload

Manually mark an in-progress organization interview as complete without requiring final media uploads

Generate portfolio intelligence from all completed clarity processes. Returns 202 Accepted immediately and processes in background.

Start a process-landscape generation run for the organization from its eligible Clarity captures (organization executives and owners)

Trigger a snapshot generation pipeline for a v2 clarity process, selected by kind. `current_process` runs the generateCurrentProcess pipeline (body fields are proposal-only and rej

Generate agent instructions or code into a saved draft. Poll the returned builder run, answer questions if requested, then accept or decline the reviewed checkpoint. This never act

Get an agent by ID.

Retrieve a single case trigger by id.

Get the contents of a single memory file for an agent.

Fetch a single suggestion. Poll this after a 202 from consume: an AOP apply in flight reports payload.apply.state (running/failed); once consumed, applied_revision_id carries the d

Get a single automation with its agent and queue counts, and the tab arrangement its detail view navigates by.

Get what the automation is set up to do right now: its member agents with the builds that are live, its queues' routing, and the triggers and schedules firing for it. The revision-

Get the automation's flow graph as it stands right now: the agents and queues it currently wires together, plus the producer, consumer, and handover edges between them. The revisio

Get the automation detail view's tab arrangement, plus metadata for the Pulse dashboards pinned into it. Pinned dashboards are filtered to the ones the calling identity may see.

Get case status counts for many Queues in ONE call. Use this after listQueues whenever you need per-Queue counts — cases waiting on a human, needing review, pending, failed — inste

Get the status of a builder run

Get a case by ID. Returns the case, its event history, and every case-approval batch ever created on the case (newest first).

Mint a short-lived signed URL for one case attachment. `disposition=inline` serves the file for the in-app viewer; `attachment` forces a download.

List a queue's active case-level evaluation rubrics — the Pass/Fail questions a whole case is judged against at settlement. Shows the queue's current version's set (auto-generated

Load the latest artifact-chat messages for one active conversation, returned oldest-first.

Get a single Clarity v2 capture including full transcript and video transcript. Use this when the process was loaded with captures=lite, or when only one capture's transcript is ne

Get a Clarity export run by ID

List the people attached to every authorized linked process node in the organization's Process Landscape. Returns a flat list where each person carries `nodeId` and `processId`, pl

Load a single organization Clarity interview with transcript

Get portfolio intelligence for the current team

Get the v2 read model for a clarity process: the process row (with operational fields like generation_error, generation_progress, generation_started_at, generation_last_activity_at

Get the active interview invite link for a process.

Get information about a clarity interview invite link (public).

Fetch the organization's full process landscape with process summaries, team assignments, and page-level stats

Get the sharing status for a clarity process

Fetch the full payload for a Clarity v2 process snapshot of either kind.

Fetch the organization's process tree, or the subtree under rootId. Narrow a large organization with `rootId` (one subtree) or `ownerTeamId` (one team's processes) — a whole-organi

Get clarity team settings for financial calculations

Get one of your connections by ID.

Get the header keys configured for a connection. Sensitive values (api keys, tokens, passwords) are returned as empty strings — the response only reveals which credential fields ar

Get a login by id. Returns the encrypted password/otp_secret blobs — only the owner or team members can access it.

List the evaluation rubrics a Run is scored against: the platform default rubrics plus the Agent-specific rubrics for a build. Defaults to the Agent's live build; pass build_id to

Aggregate evaluation counts and flag distribution for an Assignment's Jobs since the given timestamp.

Get the content of a text file.

Generate a signed download URL for a file.

Get a legacy v1 Clarity process with process metadata, generated analysis, automation guidance, generation progress, and captures. Use this for rows from listClarityProcesses where

Get a single notification by id for the authenticated user. Requires the Notification Center feature; returns 404 when it is not enabled for the team.

Get a single notification batch by id for the authenticated user, with per-type live-member counts, unread count, and worst severity. Serves cold deep links and sidebar retention f

Per-type notification counts for the authenticated user's current team. Narrow with `unread`, `important`, and with either `severity` (counts only that exact severity) or `minSever

List the notification feed for the authenticated user's current team, most recent activity first. Each item is either an individual notification or a notification batch (a per-agen

Get org-wide headline insight KPIs (run totals, success rate, distinct active agents and users) aggregated across every team in the organization. Requires an organization Admin, Ex

Get org-level insights metrics (runs, assignments, schedules) broken down per team across the organization. Requires an organization Admin, Executive, or Owner role.

Get org-level run-volume buckets (scheduled vs on-demand) at day/week/month granularity across the organization. Requires an organization Admin, Executive, or Owner role.

Get the profile of the authenticated user (the owner of the API key).

Get a Duvo Pulse dashboard's metadata and generation status. When status is completed and html_code_present is true, fetch the rendered HTML from GET /artifacts/{artifactId}/render

Mint a short-lived presigned URL to download or preview a file attached to a Duvo Pulse dashboard message. Returns 404 once the dashboard's sandbox has expired and the file is gone

Serve a Duvo Pulse dashboard's rendered HTML document (text/html, not JSON). 404 until the first generation turn has produced HTML.

Render a Duvo Pulse dashboard to a PDF document (application/pdf, not JSON). 404 until the first generation turn has produced HTML; 409 for an openui dashboard, whose substrate thi

Serve a specific version's rendered HTML document for a Duvo Pulse dashboard (text/html, requires edit access).

Get a queue by ID.

Read an aggregation definition's cached result.

Get a queue's Case schema settings: whether it requires typed cases, and the schema it validates them against.

Get a revision by ID.