Build with AI

Available tools

The DaVinci MCP Server exposes tools organized into functional categories under the davinci_admin collection. You don’t need to know the individual tool name. Describe what you want in natural language and your AI agent automatically selects the right tool.

You can find the full tool reference in the DaVinci MCP Server README.

Category What you can do

Applications

List applications and inspect flow policies.

Flows

List, describe, and version identity orchestration flows.

Connectors

Browse the connector catalog and inspect deployed connector instances.

Variables

List and inspect DaVinci flow variables.

Forms

List and inspect DaVinci form definitions.

Troubleshooting

Validate flows, list executions, and investigate failures.

Applications

List all DaVinci applications and retrieve their flow policy configurations.

Tool Description

list_applications

Returns a list of all DaVinci applications.

describe_application

Returns details of a single DaVinci application by ID.

list_application_flow_policies

Returns all flow policies for a DaVinci application.

describe_application_flow_policy

Returns details of a single flow policy for a DaVinci application.

Example prompts:

  • "List all DaVinci applications"

  • "Show me the details of application abc123"

  • "What flow policies are configured for the Login application?"

Flows

List and inspect identity orchestration flows, including their full node graphs, edge definitions, and version history.

Tool Description

list_flows

Returns a list of all DaVinci flows. Supports attributes to project the response to specific top-level fields. Flow type is derived from the trigger field: no trigger = standard flow; trigger.type AUTHENTICATION = PingOne flow; trigger.type AUTHENTICATION + trigger.subtype CIBA = CIBA flow; trigger.type SCHEDULE = scheduled flow; trigger.type BATCH_PROCESSING_SUBFLOW = batch processing subflow. readOnly: true means the flow is read-only.

describe_flow

Returns the complete definition of a DaVinci flow including the full node graph, edges, and settings. Supports attributes to project the response to specific top-level fields. See list_flows for flow type derivation.

list_flow_versions

Returns all versions of a specific DaVinci flow.

describe_flow_version

Returns the complete definition of a specific DaVinci flow version, including the full node graph, edges, settings, and trigger configuration. Supports expand to include related fields inline (for example, skcomponents).

Example prompts:

  • "List all DaVinci flows"

  • "Show me the full definition of the Login flow"

  • "How many versions does the Registration flow have?"

  • "Show me version 3 of the MFA flow"

Connectors

Browse the full DaVinci connector catalog and inspect deployed connector instances in your environment.

Tool Description

list_connectors

Returns a list of all available DaVinci connector types from the catalog.

describe_connector

Returns the full details of a single DaVinci connector type by ID, including metadata, capabilities, configurable properties, and required credentials.

list_connector_instances

Returns a list of all DaVinci connector instances.

describe_connector_instance

Returns details of a single deployed DaVinci connector instance by ID.

Example prompts:

  • "What connectors are available in DaVinci?"

  • "Show me the details of the PingOne connector"

  • "List all connector instances deployed in my environment"

Variables

List and inspect DaVinci variables and their configured values.

Tool Description

list_variables

Returns a list of all DaVinci variables. Supports limit (1-50), cursor for pagination, and a SCIM filter to narrow results.

describe_variable

Returns details of a single DaVinci variable by ID.

Example prompts:

  • "List all DaVinci variables"

  • "Show me details of the sessionTimeout variable"

Forms

List and inspect DaVinci form definitions and their full configurations.

Tool Description

list_forms

Returns a list of all DaVinci forms. Use for discovery and finding form IDs. Use describe_form for field-level details. Supports a SCIM filter on category (eq).

describe_form

Returns full configuration of a single DaVinci form including fields and layout.

Example prompts:

  • "List all DaVinci forms"

  • "Show me the full configuration of the Login form"

Troubleshooting tools

Diagnose and investigate DaVinci flow issues. Validate flow configuration before deployment, retrieve execution history, and inspect individual execution details including errors and stack traces. These tools can help speed up triage, root-cause analysis, and escalation handoffs for helpdesk and support teams.

These tools are provided under the davinci_troubleshooting collection.

Tool Description

validate_flow

Validates a DaVinci flow configuration using the DVLinter validation engine. Checks deployment readiness, identifies configuration errors and best-practice violations, and analyzes nodes (connectors and capabilities), connections (connector instances), node properties, and overall flow structure. Returns validation results including error and warning counts and specific issue descriptions. Error locations are reported in the linterError property within each node in graphData.elements.nodes for node-specific issues, and in the allLinterErrors property in graphData for flow-level errors and warnings. Zero errors indicate deployment-ready status. This is a read-only operation that does not modify the flow.

list_flow_executions

Returns a list of all executions for a specific DaVinci flow. Use to find execution IDs for troubleshooting, debugging, or monitoring. Supports limit (max 500), cursor for pagination, and a SCIM filter on timestamp (ge, le) with ISO 8601 dates, and transactionId (eq) for specific transaction lookup.

summarize_flow_execution

Returns detailed information about a specific DaVinci flow execution, including status (success or failure), timestamps, input and output data, errors with stack traces, and user context. Use to debug failures, analyze execution behavior, verify data transformations, or investigate user-specific issues. Supports limit (max 500), cursor for pagination, and a SCIM filter on timestamp (ge, le) with ISO 8601 dates.

Example prompts:

  • "Validate the Login flow and tell me if it’s ready to deploy"

  • "Are there any configuration errors or warnings in the MFA flow?"

  • "List the last 20 executions of the Registration flow"

  • "Show me all executions of the Login flow from yesterday"

  • "Find the execution with transaction ID abc-123 in the Login flow"

  • "What happened during execution xyz-456? Did it succeed?"

  • "Show me the error and stack trace for the failed execution xyz-456"

  • "What input data was passed to the last execution of the Password Reset flow?"

Common troubleshooting scenarios

Debugging a failed user authentication

Use list_flow_executions with a transactionId filter to find the specific execution, then use summarize_flow_execution to inspect the error and stack trace.

"Find executions of the Login flow with transaction ID abc-123 and summarize what went wrong."

Investigating recent failures across a flow

Use list_flow_executions with a timestamp range filter to retrieve recent executions, then use summarize_flow_execution on the failed ones.

"List all executions of the MFA flow in the last 24 hours and identify any that failed."

Verifying data transformations

Use summarize_flow_execution to inspect the input and output data of a specific execution and confirm values are being transformed as expected.

"Show me the input and output data for execution xyz-456 of the Registration flow."

Investigating user-specific issues

Use summarize_flow_execution to retrieve the user context associated with a specific execution.

"Find executions of user abc@acme.com and diagnose why they were unable to authenticate."