# MCP tool reference 1 callable tools. Use tools/call at https://mcp.schedulerzero.com/mcp with the exact tool name and arguments below. The /tools/ paths in this view are documentation identifiers, not HTTP endpoints. Request execution is disabled for this reference. Inputs are shown for personal API keys (bound) and for OAuth/delegated agents. Output schemas describe MCP structuredContent: native objects pass through; arrays, scalars and null use a data wrapper. Text content retains the native JSON result. [Connect a client](/mcp/connect) · [Authentication and authorization](/authentication) · [Generated auth guide](/auth.md) · [Download tool catalog](/mcp-catalog.json) · [Agent documentation](/llms.txt) ## get_operation Poll a durable operation's state, progress, structured failure, or result reference. Poll after starting async work until the operation reaches a terminal state. Do not poll faster than the operation's suggested interval; it wastes the caller's rate budget. Scopes: agent:operations:read Risk: read; confirmation: none; idempotency: none. ### Input schema (personal API key) ```json { "type": "object", "properties": { "operationId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" } }, "required": [ "operationId" ], "patternProperties": { "^(?!(?:operationId)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "operationId" ] } ] } } ``` ### Input schema (OAuth / delegated agent) ```json { "type": "object", "properties": { "operationId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" } }, "required": [ "operationId" ], "patternProperties": { "^(?!(?:operationId)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "operationId" ] } ] } } ``` ### Output schema (structuredContent) ```json { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "capabilityId": { "anyOf": [ { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,63}$" }, { "type": "null" } ] }, "workspaceId": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "state": { "type": "string", "enum": [ "queued", "running", "waiting_for_user", "succeeded", "partially_succeeded", "failed", "canceled", "canceling" ] }, "statusUrl": { "anyOf": [ { "$ref": "#/$defs/HttpUrl" }, { "$ref": "#/$defs/HttpResourcePath" } ] }, "submittedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "startedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "completedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "progress": { "type": "object", "properties": { "completed": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "message": { "$ref": "#/$defs/NonEmptyString" } }, "required": [ "completed" ], "patternProperties": { "^(?!(?:completed|total|message)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "completed", "total", "message" ] } }, "canCancel": { "type": "boolean" }, "failure": { "type": "object", "properties": { "code": { "$ref": "#/$defs/NonEmptyString" }, "safeMessage": { "$ref": "#/$defs/ShortText" }, "retryable": { "type": "boolean" }, "retryAfter": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "recoveryCapability": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,63}$" } }, "required": [ "code", "safeMessage", "retryable" ], "patternProperties": { "^(?!(?:code|safeMessage|retryable|retryAfter|recoveryCapability)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "code", "safeMessage", "retryable", "retryAfter", "recoveryCapability" ] } }, "result": { "anyOf": [ { "type": "object", "properties": { "capabilityId": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,63}$" }, "href": { "anyOf": [ { "$ref": "#/$defs/HttpUrl" }, { "$ref": "#/$defs/HttpResourcePath" } ] } }, "required": [ "capabilityId", "href" ], "patternProperties": { "^(?!(?:capabilityId|href)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "capabilityId", "href" ] } }, { "type": "object", "properties": { "providerOperation": { "type": "string", "enum": [ "usage", "enrich_email", "enrich_linkedin", "enrich_person", "lookup_phone", "search", "count", "export", "export_status", "profiles", "profile_leads", "set_profile_active" ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "integer", "minimum": 0 }, "outcome": { "type": "string", "enum": [ "ok", "failed", "skipped" ] }, "value": { "anyOf": [ { "type": "null" }, { "type": "boolean" }, { "type": "number" }, { "type": "string" }, { "$ref": "#/$defs/Arrays_" }, { "type": "object", "additionalProperties": { "$ref": "#/$defs/Union_" } } ] }, "errorCode": { "$ref": "#/$defs/NonEmptyString" } }, "required": [ "index", "outcome" ], "patternProperties": { "^(?!(?:index|outcome|value|errorCode)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "index", "outcome", "value", "errorCode" ] } }, "maxItems": 100 } }, "required": [ "providerOperation", "results" ], "patternProperties": { "^(?!(?:providerOperation|results)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "providerOperation", "results" ] } } ] } }, "required": [ "id", "capabilityId", "workspaceId", "state", "statusUrl", "submittedAt", "startedAt", "completedAt", "canCancel" ], "patternProperties": { "^(?!(?:id|capabilityId|workspaceId|state|statusUrl|submittedAt|startedAt|completedAt|progress|canCancel|failure|result)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "capabilityId", "workspaceId", "state", "statusUrl", "submittedAt", "startedAt", "completedAt", "progress", "canCancel", "failure", "result" ] }, "$defs": { "HttpUrl": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^https?:\\/\\/[^\\s/$.?#][^\\s]*$" }, "HttpResourcePath": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^\\/[A-Za-z0-9._~!$&'()*+,;=:@/%-]*$" }, "UtcDateTimeEncoded": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" }, "NonEmptyString": { "type": "string", "minLength": 1, "maxLength": 4096 }, "ShortText": { "type": "string", "minLength": 1, "maxLength": 256 }, "Union_": { "anyOf": [ { "type": "null" }, { "type": "boolean" }, { "type": "number" }, { "type": "string" }, { "$ref": "#/$defs/Arrays_" }, { "type": "object", "additionalProperties": { "$ref": "#/$defs/Union_" } } ] }, "Arrays_": { "type": "array", "items": { "$ref": "#/$defs/Union_" } } } } ``` ### Underlying API operations - `agent.getOperation`: `GET /agent/operations/:operationId`