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.
# 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`
Scheduler Zero