Orchestra MCP Server

Official

by orchestra-hq

Overview Schema Source Related Servers Discussions Admin

Python

Remote

List operations

list_operations

Read-only

Retrieve a paginated list of task operations for the workspace the credential resolves to.

Instructions

Retrieve a paginated list of task operations for the workspace the credential resolves to.

From 2026-10-01 the default changed from the last 7 days to the last 24 hours. Pass time_from and time_to explicitly to control the window.

Use operation filters to narrow results by operation type, integration, external ID, operation status, or task run ID.

Input Schema

Name	Required	Description
`page`	No	Page number. Must be greater than or equal to 1.
`status`	No	Filter by status.
`time_to`	No	End of the time window as an ISO 8601 datetime.
`page_size`	No	Number of items per page. Defaults to 50; maximum 100.
`time_from`	No	Start of the time window as an ISO 8601 datetime.
`external_id`	No	External system identifier to filter by.
`integration`	No	Integration identifier.
`task_run_id`	No	Task run ID.
`operation_type`	No	Filter by operation type. Comma-separated values are supported.
`X-Orchestra-Account-Id`	No	Act on this account rather than the one the credential resolves to. Omit it to use the credential's own account. An API key is issued to a single account, so it may only name that account; an OAuth token may name any account its grant covers.

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv2026.10.12-0Oct 14, 2026

changedInput schema / properties / integration / anyOf

Previous value: -[
-  {
-    "enum": [
-      "AIRBYTE_CLOUD",
-      "AIRBYTE_SERVER",
-      "AIRFLOW",
-      "ARCH",
-      "ALTERYX_SERVER",
-      "ANTHROPIC",
-      "AWS_EC2",
-      "AWS_ECS",
-      "AWS_EMR",
-      "AWS_EKS",
-      "AWS_FIREHOSE",
-      "AWS_GLUE",
-      "AWS_LAMBDA",
-      "AWS_RDS",
-      "AWS_REDSHIFT",
-      "AWS_S3",
-      "AWS_BEDROCK",
-      "AWS_SAGEMAKER",
-      "AWS_SECRETS_MANAGER",
-      "AWS_SES",
-      "AWS_STEP_FUNCTIONS",
-      "AZURE",
-      "AZURE_CONTAINER_APPS",
-      "AZURE_DATA_FACTORY",
-      "AZURE_DATA_LAKE_STORAGE",
-      "AZURE_KEY_VAULT",
-      "AZURE_KUBERNETES_SERVICE",
-      "AZURE_LOGIC_APPS",
-      "AZURE_SYNAPSE_ANALYTICS",
-      "AZURE_VM",
-      "BAUPLAN",
-      "BOOMI",
-      "CDATA",
-      "CENSUS",
-      "CLICKHOUSE",
-      "COALESCE",
-      "COUNT",
-      "DATADOG",
-      "DATABRICKS",
-      "DATAPROC",
-      "DATAZEN",
-      "DBT",
-      "DBT_CORE",
-      "DLT",
-      "DOMO",
-      "DREMIO",
-      "DUCKDB",
-      "EMAIL",
-      "ESTUARY",
-      "ETLEAP",
-      "FABRIC",
-      "FABRIC_SYNAPSE",
-      "FIVETRAN",
-      "FORTRA",
-      "GCP_BIG_QUERY",
-      "GCP_CLOUD_RUN",
-      "GCP_CLOUD_FUNCTIONS",
-      "GCP_CLOUD_STORAGE",
-      "GCP_DATAFLOW",
-      "GCP_DATAFORM",
-      "GCP_DATASTREAM",
-      "GCP_LOOKER",
-      "GKE",
-      "GITHUB_ACTIONS",
-      "GOOGLE_CLOUD",
-      "HEVO",
-      "HEX",
-      "HIGHTOUCH",
-      "HTTP",
-      "HUBSPOT",
-      "INFORMATICA_IICS",
-      "INFORMATICA_POWERCENTER",
-      "KAFKA",
-      "KEBOOLA",
-      "KLEENE",
-      "LIGHTDASH",
-      "LINUX_SSH",
-      "MARIADB",
-      "MATILLION",
-      "MATILLION_ETL",
-      "METAPLANE",
-      "MICROSOFT_TEAMS",
-      "MICROSTRATEGY",
-      "MONGODB",
-      "MOTHERDUCK",
-      "MYSQL",
-      "N8N",
-      "NIMBLE",
-      "NOTION",
-      "OMNI",
-      "OPEN_AI",
-      "ORCHESTRA",
-      "PARADIME",
-      "PAGER_DUTY",
-      "PINECONE",
-      "PORTABLE",
-      "POSTGRES",
-      "POWER_AUTOMATE",
-      "POWER_BI",
-      "PREFECT_CLOUD",
-      "PYTHON",
-      "QLIK",
-      "QLIK_REPLICATE",
-      "QUICKBOOKS",
-      "RENDER",
-      "RIVERY",
-      "RUDDERSTACK",
-      "SALESFORCE",
-      "SAP",
-      "SFTP",
-      "SHAREPOINT",
-      "SIGMA",
-      "SISENSE",
-      "SLACK",
-      "SNOWFLAKE",
-      "SNOWPLOW",
-      "SODA",
-      "SQL_MESH",
-      "SQL_SERVER",
-      "STITCH",
-      "STREAMKAP",
-      "TABLEAU_CLOUD",
-      "TALEND_CLOUD",
-      "THOUGHTSPOT",
-      "TOBIKO_CLOUD",
-      "WEAVIATE",
-      "WEBHOOK",
-      "WELD",
-      "WINDOWS_SSH"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "AIRBYTE_CLOUD",
+      "AIRBYTE_SERVER",
+      "AIRFLOW",
+      "ARCH",
+      "ALTERYX_SERVER",
+      "ANTHROPIC",
+      "AWS_EC2",
+      "AWS_ECS",
+      "AWS_EMR",
+      "AWS_EKS",
+      "AWS_FIREHOSE",
+      "AWS_GLUE",
+      "AWS_LAMBDA",
+      "AWS_RDS",
+      "AWS_REDSHIFT",
+      "AWS_S3",
+      "AWS_BATCH",
+      "AWS_BEDROCK",
+      "AWS_SAGEMAKER",
+      "AWS_SECRETS_MANAGER",
+      "AWS_SES",
+      "AWS_STEP_FUNCTIONS",
+      "AZURE",
+      "AZURE_CONTAINER_APPS",
+      "AZURE_DATA_FACTORY",
+      "AZURE_DATA_LAKE_STORAGE",
+      "AZURE_KEY_VAULT",
+      "AZURE_KUBERNETES_SERVICE",
+      "AZURE_LOGIC_APPS",
+      "AZURE_SYNAPSE_ANALYTICS",
+      "AZURE_VM",
+      "BAUPLAN",
+      "BOOMI",
+      "CDATA",
+      "CENSUS",
+      "CLICKHOUSE",
+      "COALESCE",
+      "COUNT",
+      "DATADOG",
+      "DATABRICKS",
+      "DATAPROC",
+      "DATAZEN",
+      "DBT",
+      "DBT_CORE",
+      "DLT",
+      "DOMO",
+      "DREMIO",
+      "DUCKDB",
+      "EMAIL",
+      "ESTUARY",
+      "ETLEAP",
+      "FABRIC",
+      "FABRIC_SYNAPSE",
+      "FIVETRAN",
+      "FORTRA",
+      "GCP_BIG_QUERY",
+      "GCP_CLOUD_RUN",
+      "GCP_CLOUD_FUNCTIONS",
+      "GCP_CLOUD_STORAGE",
+      "GCP_DATAFLOW",
+      "GCP_DATAFORM",
+      "GCP_DATASTREAM",
+      "GCP_LOOKER",
+      "GKE",
+      "GITHUB_ACTIONS",
+      "GOOGLE_CLOUD",
+      "HEVO",
+      "HEX",
+      "HIGHTOUCH",
+      "HTTP",
+      "HUBSPOT",
+      "INFORMATICA_IICS",
+      "INFORMATICA_POWERCENTER",
+      "KAFKA",
+      "KEBOOLA",
+      "KLEENE",
+      "LIGHTDASH",
+      "LINUX_SSH",
+      "MARIADB",
+      "MATILLION",
+      "MATILLION_ETL",
+      "METAPLANE",
+      "MICROSOFT_TEAMS",
+      "MICROSTRATEGY",
+      "MONGODB",
+      "MOTHERDUCK",
+      "MYSQL",
+      "N8N",
+      "NIMBLE",
+      "NOTION",
+      "OMNI",
+      "OPEN_AI",
+      "ORCHESTRA",
+      "PARADIME",
+      "PAGER_DUTY",
+      "PINECONE",
+      "PORTABLE",
+      "POSTGRES",
+      "POWER_AUTOMATE",
+      "POWER_BI",
+      "PREFECT_CLOUD",
+      "PYTHON",
+      "QLIK",
+      "QLIK_REPLICATE",
+      "QUICKBOOKS",
+      "RENDER",
+      "RIVERY",
+      "RUDDERSTACK",
+      "SALESFORCE",
+      "SAP",
+      "SFTP",
+      "SHAREPOINT",
+      "SIGMA",
+      "SISENSE",
+      "SLACK",
+      "SNOWFLAKE",
+      "SNOWPLOW",
+      "SODA",
+      "SQL_MESH",
+      "SQL_SERVER",
+      "STITCH",
+      "STREAMKAP",
+      "TABLEAU_CLOUD",
+      "TALEND_CLOUD",
+      "THOUGHTSPOT",
+      "TOBIKO_CLOUD",
+      "TYPESAFE",
+      "WEAVIATE",
+      "WEBHOOK",
+      "WELD",
+      "WINDOWS_SSH"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedv0.1.1Sep 30, 2026

changedInput schema / properties / integration / anyOf

Previous value: -[
-  {
-    "enum": [
-      "AIRBYTE_CLOUD",
-      "AIRBYTE_SERVER",
-      "AIRFLOW",
-      "ARCH",
-      "ALTERYX_SERVER",
-      "ANTHROPIC",
-      "AWS_EC2",
-      "AWS_ECS",
-      "AWS_EMR",
-      "AWS_EKS",
-      "AWS_FIREHOSE",
-      "AWS_GLUE",
-      "AWS_LAMBDA",
-      "AWS_RDS",
-      "AWS_REDSHIFT",
-      "AWS_S3",
-      "AWS_BEDROCK",
-      "AWS_SAGEMAKER",
-      "AWS_SECRETS_MANAGER",
-      "AWS_SES",
-      "AWS_STEP_FUNCTIONS",
-      "AZURE",
-      "AZURE_CONTAINER_APPS",
-      "AZURE_DATA_FACTORY",
-      "AZURE_DATA_LAKE_STORAGE",
-      "AZURE_KEY_VAULT",
-      "AZURE_KUBERNETES_SERVICE",
-      "AZURE_LOGIC_APPS",
-      "AZURE_SYNAPSE_ANALYTICS",
-      "AZURE_VM",
-      "BAUPLAN",
-      "BOOMI",
-      "CDATA",
-      "CENSUS",
-      "CLICKHOUSE",
-      "COALESCE",
-      "COUNT",
-      "DATADOG",
-      "DATABRICKS",
-      "DATAPROC",
-      "DATAZEN",
-      "DBT",
-      "DBT_CORE",
-      "DLT",
-      "DOMO",
-      "DREMIO",
-      "DUCKDB",
-      "EMAIL",
-      "ESTUARY",
-      "ETLEAP",
-      "FABRIC",
-      "FABRIC_SYNAPSE",
-      "FIVETRAN",
-      "FORTRA",
-      "GCP_BIG_QUERY",
-      "GCP_CLOUD_RUN",
-      "GCP_CLOUD_FUNCTIONS",
-      "GCP_CLOUD_STORAGE",
-      "GCP_DATAFLOW",
-      "GCP_DATAFORM",
-      "GCP_DATASTREAM",
-      "GCP_LOOKER",
-      "GKE",
-      "GITHUB_ACTIONS",
-      "GOOGLE_CLOUD",
-      "HEVO",
-      "HEX",
-      "HIGHTOUCH",
-      "HTTP",
-      "HUBSPOT",
-      "INFORMATICA_IICS",
-      "INFORMATICA_POWERCENTER",
-      "KAFKA",
-      "KEBOOLA",
-      "KLEENE",
-      "LIGHTDASH",
-      "LINUX_SSH",
-      "MATILLION",
-      "MATILLION_ETL",
-      "METAPLANE",
-      "MICROSOFT_TEAMS",
-      "MICROSTRATEGY",
-      "MONGODB",
-      "MOTHERDUCK",
-      "MYSQL",
-      "N8N",
-      "NIMBLE",
-      "NOTION",
-      "OMNI",
-      "OPEN_AI",
-      "ORCHESTRA",
-      "PARADIME",
-      "PAGER_DUTY",
-      "PINECONE",
-      "PORTABLE",
-      "POSTGRES",
-      "POWER_AUTOMATE",
-      "POWER_BI",
-      "PREFECT_CLOUD",
-      "PYTHON",
-      "QLIK",
-      "QLIK_REPLICATE",
-      "QUICKBOOKS",
-      "RENDER",
-      "RIVERY",
-      "RUDDERSTACK",
-      "SALESFORCE",
-      "SAP",
-      "SFTP",
-      "SHAREPOINT",
-      "SIGMA",
-      "SISENSE",
-      "SLACK",
-      "SNOWFLAKE",
-      "SNOWPLOW",
-      "SODA",
-      "SQL_MESH",
-      "SQL_SERVER",
-      "STITCH",
-      "STREAMKAP",
-      "TABLEAU_CLOUD",
-      "TALEND_CLOUD",
-      "THOUGHTSPOT",
-      "TOBIKO_CLOUD",
-      "WEAVIATE",
-      "WEBHOOK",
-      "WELD",
-      "WINDOWS_SSH"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "AIRBYTE_CLOUD",
+      "AIRBYTE_SERVER",
+      "AIRFLOW",
+      "ARCH",
+      "ALTERYX_SERVER",
+      "ANTHROPIC",
+      "AWS_EC2",
+      "AWS_ECS",
+      "AWS_EMR",
+      "AWS_EKS",
+      "AWS_FIREHOSE",
+      "AWS_GLUE",
+      "AWS_LAMBDA",
+      "AWS_RDS",
+      "AWS_REDSHIFT",
+      "AWS_S3",
+      "AWS_BEDROCK",
+      "AWS_SAGEMAKER",
+      "AWS_SECRETS_MANAGER",
+      "AWS_SES",
+      "AWS_STEP_FUNCTIONS",
+      "AZURE",
+      "AZURE_CONTAINER_APPS",
+      "AZURE_DATA_FACTORY",
+      "AZURE_DATA_LAKE_STORAGE",
+      "AZURE_KEY_VAULT",
+      "AZURE_KUBERNETES_SERVICE",
+      "AZURE_LOGIC_APPS",
+      "AZURE_SYNAPSE_ANALYTICS",
+      "AZURE_VM",
+      "BAUPLAN",
+      "BOOMI",
+      "CDATA",
+      "CENSUS",
+      "CLICKHOUSE",
+      "COALESCE",
+      "COUNT",
+      "DATADOG",
+      "DATABRICKS",
+      "DATAPROC",
+      "DATAZEN",
+      "DBT",
+      "DBT_CORE",
+      "DLT",
+      "DOMO",
+      "DREMIO",
+      "DUCKDB",
+      "EMAIL",
+      "ESTUARY",
+      "ETLEAP",
+      "FABRIC",
+      "FABRIC_SYNAPSE",
+      "FIVETRAN",
+      "FORTRA",
+      "GCP_BIG_QUERY",
+      "GCP_CLOUD_RUN",
+      "GCP_CLOUD_FUNCTIONS",
+      "GCP_CLOUD_STORAGE",
+      "GCP_DATAFLOW",
+      "GCP_DATAFORM",
+      "GCP_DATASTREAM",
+      "GCP_LOOKER",
+      "GKE",
+      "GITHUB_ACTIONS",
+      "GOOGLE_CLOUD",
+      "HEVO",
+      "HEX",
+      "HIGHTOUCH",
+      "HTTP",
+      "HUBSPOT",
+      "INFORMATICA_IICS",
+      "INFORMATICA_POWERCENTER",
+      "KAFKA",
+      "KEBOOLA",
+      "KLEENE",
+      "LIGHTDASH",
+      "LINUX_SSH",
+      "MARIADB",
+      "MATILLION",
+      "MATILLION_ETL",
+      "METAPLANE",
+      "MICROSOFT_TEAMS",
+      "MICROSTRATEGY",
+      "MONGODB",
+      "MOTHERDUCK",
+      "MYSQL",
+      "N8N",
+      "NIMBLE",
+      "NOTION",
+      "OMNI",
+      "OPEN_AI",
+      "ORCHESTRA",
+      "PARADIME",
+      "PAGER_DUTY",
+      "PINECONE",
+      "PORTABLE",
+      "POSTGRES",
+      "POWER_AUTOMATE",
+      "POWER_BI",
+      "PREFECT_CLOUD",
+      "PYTHON",
+      "QLIK",
+      "QLIK_REPLICATE",
+      "QUICKBOOKS",
+      "RENDER",
+      "RIVERY",
+      "RUDDERSTACK",
+      "SALESFORCE",
+      "SAP",
+      "SFTP",
+      "SHAREPOINT",
+      "SIGMA",
+      "SISENSE",
+      "SLACK",
+      "SNOWFLAKE",
+      "SNOWPLOW",
+      "SODA",
+      "SQL_MESH",
+      "SQL_SERVER",
+      "STITCH",
+      "STREAMKAP",
+      "TABLEAU_CLOUD",
+      "TALEND_CLOUD",
+      "THOUGHTSPOT",
+      "TOBIKO_CLOUD",
+      "WEAVIATE",
+      "WEBHOOK",
+      "WELD",
+      "WINDOWS_SSH"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

First observedv0.1.0Sep 26, 2026

TDQS

A3.6/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, so the safety profile is covered. The description does add genuinely useful behavior beyond annotations: the default 24-hour window, the 7-day maximum range per request, the 2023-01-01 floor on time_from, and the 2026-10-01 default change. It does not mention pagination limits or rate limiting, but with annotations carrying safety the added time-window semantics are solid context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The note block is front-loaded with the operation purpose first, then the temporal constraints, then the filter guidance. Every sentence carries real information, though the migration note about the 2026-10-01 default change is slightly redundant with the preceding default-window sentence.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need no explanation, and the description covers the subtle temporal windowing rules thoroughly for a 10-parameter list tool. The one gap is the absence of any routing signal relative to the many list_* siblings, which matters given how crowded this tool namespace is.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3, and the description exceeds it by supplying semantics the schema's one-line descriptions lack: the default window when time_from/time_to are omitted, the 7-day cap, the earliest allowable time_from, and confirmation that comma-separated operation_type values are filterable. This meaningfully enriches the two temporal parameters that otherwise look identical in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Retrieve a paginated list of task operations') plus the scoping boundary ('the workspace the credential resolves to'). It does not, however, distinguish this tool from closely named siblings like list_task_runs or list_task_run_artifacts, leaving the agent to infer how 'operations' relate to 'task runs'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains how to narrow results ('Use operation filters to narrow results by operation type, integration, external ID, operation status, or task run ID') and fully details the time-window rules, but it never says when to choose this tool over alternatives such as list_task_runs or list_task_run_logs. Usage is implied rather than routed.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server