# 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) ## inspect_infrastructure Inspect a workspace's domains, inboxes, issuing Google OAuth clients, evidenced Microsoft directory/client associations, API egress IPs, masking state and historical send coverage. Investigate current resource relationships or filter a dated campaign-send cohort by domain or recorded IP. Results are paginated, read-only and limited to the selected Workspace. Do not infer recipient-facing MTA reputation, historical OAuth identity, email delivery, or active masking from configuration. Never use current assignments to fill historical coverage gaps. Scopes: inbox:read, domain:read, analytics:read Risk: read; confirmation: none; idempotency: none. ### Input schema (personal API key) ```json { "type": "object", "properties": { "workspaceId": { "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" }, "view": { "type": "string", "enum": [ "domains", "inboxes", "oauth", "microsoft", "ips" ] }, "search": { "type": "string", "maxLength": 320 }, "domain": { "type": "string", "maxLength": 320 }, "ip": { "type": "string", "maxLength": 320 }, "client": { "type": "string", "maxLength": 320 }, "tenant": { "type": "string", "maxLength": 320 }, "inbox": { "type": "string", "maxLength": 320 }, "provider": { "type": "string", "enum": [ "", "google_workspace", "microsoft_365", "other" ] }, "status": { "type": "string", "maxLength": 320 }, "page": { "type": "integer", "minimum": 1, "maximum": 10000 }, "sort": { "type": "string", "enum": [ "name", "inboxes" ] }, "from": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "to": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "workspaceId", "view", "search", "domain", "ip", "client", "tenant", "inbox", "provider", "status", "page", "sort", "from", "to" ], "patternProperties": { "^(?!(?:workspaceId|view|search|domain|ip|client|tenant|inbox|provider|status|page|sort|from|to)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "workspaceId", "view", "search", "domain", "ip", "client", "tenant", "inbox", "provider", "status", "page", "sort", "from", "to" ] } } ``` ### Input schema (OAuth / delegated agent) ```json { "type": "object", "properties": { "workspaceId": { "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" }, "view": { "type": "string", "enum": [ "domains", "inboxes", "oauth", "microsoft", "ips" ] }, "search": { "type": "string", "maxLength": 320 }, "domain": { "type": "string", "maxLength": 320 }, "ip": { "type": "string", "maxLength": 320 }, "client": { "type": "string", "maxLength": 320 }, "tenant": { "type": "string", "maxLength": 320 }, "inbox": { "type": "string", "maxLength": 320 }, "provider": { "type": "string", "enum": [ "", "google_workspace", "microsoft_365", "other" ] }, "status": { "type": "string", "maxLength": 320 }, "page": { "type": "integer", "minimum": 1, "maximum": 10000 }, "sort": { "type": "string", "enum": [ "name", "inboxes" ] }, "from": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "to": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "workspaceId", "view", "search", "domain", "ip", "client", "tenant", "inbox", "provider", "status", "page", "sort", "from", "to" ], "patternProperties": { "^(?!(?:workspaceId|view|search|domain|ip|client|tenant|inbox|provider|status|page|sort|from|to)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "workspaceId", "view", "search", "domain", "ip", "client", "tenant", "inbox", "provider", "status", "page", "sort", "from", "to" ] } } ``` ### Output schema (structuredContent) ```json { "type": "object", "properties": { "rows": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "label": { "type": "string" }, "inboxCount": { "type": "integer" }, "domainCount": { "type": "integer" }, "domains": { "type": "array", "items": { "type": "string" } }, "providers": { "type": "array", "items": { "type": "string" } }, "statuses": { "type": "array", "items": { "type": "string" } }, "routes": { "type": "array", "items": { "type": "string" } }, "ips": { "type": "array", "items": { "type": "string" } }, "clients": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "publicClientId": { "type": "string" }, "name": { "type": "string" }, "projectNumber": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "serviceClass": { "type": "string" }, "status": { "type": "string" } }, "required": [ "id", "publicClientId", "name", "projectNumber", "serviceClass", "status" ], "additionalProperties": true } }, "microsoftTenants": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "entraTenantId": { "type": "string" }, "displayName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "active", "draining", "disabled", "retired" ] } }, "required": [ "id", "entraTenantId", "displayName", "status" ], "additionalProperties": true } }, "microsoftClientIds": { "type": "array", "items": { "type": "string" } }, "microsoftInboxCount": { "type": "integer" }, "unknownMicrosoftTenants": { "type": "integer" }, "unknownMicrosoftClients": { "type": "integer" }, "microsoftTenantVerifiedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "boundaryId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "boundaryStatus": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "desiredClientId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reconsentRequired": { "type": "boolean" }, "masking": { "anyOf": [ { "type": "object", "properties": { "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "target": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "desiredRevision": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "activeRevision": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "activeProvider": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "activeMode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "activeTarget": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "checkedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "websiteRouteId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "phase": { "type": "string", "enum": [ "not_configured", "waiting_dns", "waiting_tls", "waiting_publication", "active", "degraded", "retired", "needs_attention", "published_unverified", "unknown" ] }, "reason": { "anyOf": [ { "type": "string", "enum": [ "ownership_required", "certificate_pending", "certificate_failed", "route_pending", "dns_pending", "health_mismatch", "origin_unavailable", "origin_redirects", "provider_unavailable", "provider_drift", "retiring", "provider_managed_dns", "deployment_unconfigured", "reconcile_failed" ] }, { "type": "null" } ] }, "updatedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "registrarDomainId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "provider", "mode", "target", "desiredRevision", "activeRevision", "activeProvider", "activeMode", "activeTarget", "checkedAt", "websiteRouteId", "phase", "reason", "updatedAt", "registrarDomainId" ], "additionalProperties": true }, { "type": "null" } ] } }, "required": [ "key", "label", "inboxCount", "domainCount", "domains", "providers", "statuses", "routes", "ips", "clients", "microsoftTenants", "microsoftClientIds", "microsoftInboxCount", "unknownMicrosoftTenants", "unknownMicrosoftClients", "microsoftTenantVerifiedAt", "boundaryId", "boundaryStatus", "desiredClientId", "reconsentRequired", "masking" ], "additionalProperties": true } }, "total": { "type": "integer" }, "pageSize": { "type": "integer" }, "metrics": { "type": "object", "properties": { "cohortSent": { "type": "integer" }, "missingRoute": { "type": "integer" }, "missingDomain": { "type": "integer" }, "sent": { "type": "integer" }, "contacted": { "type": "integer" }, "bounced": { "type": "integer" }, "allReplies": { "type": "integer" }, "humanReplies": { "type": "integer" }, "positiveReplies": { "type": "integer" }, "outOfOffice": { "type": "integer" }, "automaticReplies": { "type": "integer" }, "ipAttributed": { "type": "integer" }, "domainAttributed": { "type": "integer" }, "direct": { "type": "integer" }, "unknownRoute": { "type": "integer" }, "failedAttempts": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "unknownAttempts": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "cohortSent", "missingRoute", "missingDomain", "sent", "contacted", "bounced", "allReplies", "humanReplies", "positiveReplies", "outOfOffice", "automaticReplies", "ipAttributed", "domainAttributed", "direct", "unknownRoute", "failedAttempts", "unknownAttempts" ], "additionalProperties": true }, "history": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "occurredAt": { "type": "string" }, "kind": { "type": "string" }, "resource": { "type": "string" }, "detail": { "type": "string" }, "actor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "occurredAt", "kind", "resource", "detail", "actor", "reason" ], "additionalProperties": true } }, "historyLimited": { "type": "boolean" } }, "required": [ "rows", "total", "pageSize", "metrics", "history", "historyLimited" ], "additionalProperties": true } ``` ### Underlying API operations - `infrastructure.explore`: `POST /v1/workspaces/:workspaceId/infrastructure/explore`