MCP tool
get_supplier_dossier
Read the privacy-safe agent projection of the tenant-owned supplier dossier for one adapter, including effective status, revision, provenance freshness, commercial access, supported operations, billing, technical API/MCP evidence, privacy, support and explicit readiness blockers. Credentials, contacts, source/artifact references, digests, reviewer identities and free-text notes are never returned. This tool cannot draft, update or verify a dossier; those authority changes remain human-only in Operator.
Input
Pass fields from this schema as the tool arguments. Runtime ownership, product scope and readiness checks still apply.
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "adapter key from list_connections"
}
},
"required": [
"key"
]
}REST mapping and authority
The tool wraps this REST endpoint. The mapping identifies path/query/body transformations and approval or idempotency headers.
Request contract
{
"method": "GET",
"path": "/api/v1/connections/{key}/dossier",
"pathFields": [
"key"
],
"pathSchema": {
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "adapter key from list_connections"
}
},
"additionalProperties": false,
"required": [
"key"
]
},
"pathEncoding": "encodeURIComponent for each path field",
"governedAction": null,
"headers": {},
"querySchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"queryEncoding": "URLSearchParams; omit undefined fields, stringify supplied values",
"responseMapping": "REST JSON is returned as MCP structuredContent and a compatibility text block; privacy-sensitive tools validate their output schema."
}Output
This is the registered MCP output envelope. Nested fields are only modeled where the schema explicitly defines them.
Output JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"dossier": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"adapterKey": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"draft",
"verified",
"blocked"
]
},
"effectiveStatus": {
"type": "string",
"enum": [
"draft",
"verified",
"blocked",
"stale"
]
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"accessClass": {
"type": "string",
"enum": [
"open",
"own-account",
"approved",
"contract",
"infrastructure"
]
},
"verificationBlockers": {
"type": "array",
"items": {
"type": "string"
}
},
"provenanceCurrent": {
"type": "boolean"
},
"connectionBindingCurrent": {
"type": "boolean"
},
"verifiedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"updatedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"content": {
"type": "object",
"properties": {
"schemaVersion": {
"type": "number",
"const": 1
},
"identity": {
"type": "object",
"properties": {
"supplierName": {
"type": "string"
},
"productName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"channels": {
"type": "array",
"items": {
"type": "string",
"enum": [
"ctv",
"audio",
"tv",
"cinema",
"dooh",
"search",
"social"
]
}
},
"availableMarkets": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"supplierName",
"productName",
"channels",
"availableMarkets"
],
"additionalProperties": false
},
"commercialAccess": {
"type": "object",
"properties": {
"accessClass": {
"type": "string",
"enum": [
"open",
"own-account",
"approved",
"contract",
"infrastructure"
]
},
"accountScope": {
"type": "string",
"enum": [
"unknown",
"own-account-only",
"agency-multi-advertiser",
"reseller",
"managed-service"
]
},
"currentState": {
"type": "string",
"enum": [
"unknown",
"not-started",
"application-pending",
"approved",
"contracted",
"suspended",
"rejected",
"not-available"
]
},
"contractRequired": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"multiAdvertiserUseApproved": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"resaleApproved": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"onboardingLeadTime": {
"anyOf": [
{
"type": "object",
"properties": {
"minimumBusinessDays": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"maximumBusinessDays": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"minimumBusinessDays",
"maximumBusinessDays"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"minimumCommitment": {
"anyOf": [
{
"type": "object",
"properties": {
"amountMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"enum": [
"GBP",
"USD",
"EUR"
]
}
},
"required": [
"amountMinor",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"accessClass",
"accountScope",
"currentState",
"contractRequired",
"multiAdvertiserUseApproved",
"resaleApproved",
"onboardingLeadTime",
"minimumCommitment"
],
"additionalProperties": false
},
"operations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"operation": {
"type": "string",
"enum": [
"forecast",
"providerForecast",
"postcodeClassification",
"identityMapping",
"identityOptOut",
"activate",
"pause",
"resume",
"creative",
"report",
"audienceSync",
"deals",
"keywordSuggestions",
"conversionGoals",
"analytics",
"inventory"
]
},
"verificationStatus": {
"type": "string",
"enum": [
"unknown",
"sandbox-only",
"stub",
"client-built",
"contract-tested",
"spend-tested",
"report-verified"
]
},
"liveAccess": {
"type": "string",
"enum": [
"unknown",
"not-approved",
"approved",
"suspended",
"not-applicable"
]
},
"executionMode": {
"type": "string",
"enum": [
"unknown",
"rest-api",
"graphql-api",
"official-mcp",
"file-transfer",
"portal-workflow",
"email-workflow",
"managed-service",
"none"
]
},
"risk": {
"type": "string",
"enum": [
"read-only",
"non-spend-write",
"spend-authorizing",
"personal-data-transfer"
]
},
"requiredOAuthScopes": {
"type": "array",
"items": {
"type": "string"
}
},
"requiredCredentialFields": {
"type": "array",
"items": {
"type": "string"
}
},
"sandboxAvailable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"supportsIdempotency": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"supportsMultiAdvertiser": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"blockers": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"operation",
"verificationStatus",
"liveAccess",
"executionMode",
"risk",
"requiredOAuthScopes",
"requiredCredentialFields",
"sandboxAvailable",
"supportsIdempotency",
"supportsMultiAdvertiser",
"blockers"
],
"additionalProperties": false
}
},
"billing": {
"type": "object",
"properties": {
"billingModel": {
"type": "string",
"enum": [
"unknown",
"prepaid",
"card-on-file",
"postpaid-invoice",
"platform-billed",
"managed-service",
"mixed",
"not-applicable"
]
},
"supportedCurrencies": {
"type": "array",
"items": {
"type": "string",
"enum": [
"GBP",
"USD",
"EUR"
]
}
},
"requiresPreFunding": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"paymentTermsDays": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"spendCapBehavior": {
"type": "string",
"enum": [
"unknown",
"vendor-hard-cap",
"vendor-soft-cap",
"platform-only",
"not-supported",
"not-applicable"
]
},
"minimumCampaignSpend": {
"anyOf": [
{
"type": "object",
"properties": {
"amountMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"enum": [
"GBP",
"USD",
"EUR"
]
}
},
"required": [
"amountMinor",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"minimumMonthlyCommitment": {
"anyOf": [
{
"type": "object",
"properties": {
"amountMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"enum": [
"GBP",
"USD",
"EUR"
]
}
},
"required": [
"amountMinor",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"billingModel",
"supportedCurrencies",
"requiresPreFunding",
"paymentTermsDays",
"spendCapBehavior",
"minimumCampaignSpend",
"minimumMonthlyCommitment"
],
"additionalProperties": false
},
"technical": {
"type": "object",
"properties": {
"integrationModes": {
"type": "array",
"items": {
"type": "string",
"enum": [
"unknown",
"rest-api",
"graphql-api",
"official-mcp",
"file-transfer",
"portal-workflow",
"email-workflow",
"managed-service",
"none"
]
}
},
"apiVersion": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"authMethod": {
"type": "string",
"enum": [
"unknown",
"none",
"api-key",
"basic",
"oauth2-authorization-code",
"oauth2-client-credentials",
"rsa-signature",
"mutual-tls",
"vendor-session",
"manual"
]
},
"credentialFields": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"required": {
"type": "boolean"
},
"secret": {
"type": "boolean"
},
"rotates": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"required",
"secret",
"rotates"
],
"additionalProperties": false
}
},
"sandboxClass": {
"type": "string",
"enum": [
"unknown",
"true-sandbox",
"test-account",
"production-test-only",
"synthetic-only",
"unavailable"
]
},
"idempotencyClass": {
"type": "string",
"enum": [
"unknown",
"native-key",
"request-header",
"natural-key-only",
"not-supported",
"not-applicable"
]
},
"paginationClass": {
"type": "string",
"enum": [
"unknown",
"cursor",
"page",
"offset",
"stream",
"none"
]
},
"supportsWebhooks": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"usesAsynchronousJobs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"productionTestingRequired": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"mcp": {
"type": "object",
"properties": {
"availability": {
"type": "string",
"enum": [
"unknown",
"not-offered",
"supplier-hosted-beta",
"supplier-hosted-ga",
"official-self-hosted",
"third-party-only"
]
},
"transports": {
"type": "array",
"items": {
"type": "string",
"enum": [
"unknown",
"streamable-http",
"stdio",
"sse"
]
}
},
"protocolVersions": {
"type": "array",
"items": {
"type": "string"
}
},
"authMethod": {
"type": "string",
"enum": [
"unknown",
"none",
"api-key",
"basic",
"oauth2-authorization-code",
"oauth2-client-credentials",
"rsa-signature",
"mutual-tls",
"vendor-session",
"manual"
]
},
"tools": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"risk": {
"type": "string",
"enum": [
"read-only",
"non-spend-write",
"spend-authorizing",
"personal-data-transfer"
]
}
},
"required": [
"name",
"risk"
],
"additionalProperties": false
}
}
},
"required": [
"availability",
"transports",
"protocolVersions",
"authMethod",
"tools"
],
"additionalProperties": false
},
"blockers": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"integrationModes",
"apiVersion",
"authMethod",
"credentialFields",
"sandboxClass",
"idempotencyClass",
"paginationClass",
"supportsWebhooks",
"usesAsynchronousJobs",
"productionTestingRequired",
"mcp",
"blockers"
],
"additionalProperties": false
},
"creative": {
"type": "object",
"properties": {
"submissionMode": {
"type": "string",
"enum": [
"unknown",
"api",
"portal",
"email",
"managed-service",
"not-applicable"
]
},
"formats": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"mimeTypes": {
"type": "array",
"items": {
"type": "string"
}
},
"fileExtensions": {
"type": "array",
"items": {
"type": "string"
}
},
"dimensions": {
"type": "array",
"items": {
"type": "string"
}
},
"durationsSeconds": {
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"maximumBytes": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"mimeTypes",
"fileExtensions",
"dimensions",
"durationsSeconds",
"maximumBytes"
],
"additionalProperties": false
}
},
"requiresPreApproval": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"externalCreativeRefReturned": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"approvalStatusReadable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"approvalBoundToExactBytes": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"reviewSlaBusinessDays": {
"anyOf": [
{
"type": "object",
"properties": {
"minimumBusinessDays": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"maximumBusinessDays": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"minimumBusinessDays",
"maximumBusinessDays"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"approvalExpiryDays": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"blockers": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"submissionMode",
"formats",
"requiresPreApproval",
"externalCreativeRefReturned",
"approvalStatusReadable",
"approvalBoundToExactBytes",
"reviewSlaBusinessDays",
"approvalExpiryDays",
"blockers"
],
"additionalProperties": false
},
"privacy": {
"type": "object",
"properties": {
"supplierRole": {
"type": "string",
"enum": [
"unknown",
"controller",
"processor",
"joint-controller",
"independent-controller",
"not-applicable"
]
},
"chorusRole": {
"type": "string",
"enum": [
"unknown",
"controller",
"processor",
"joint-controller",
"independent-controller",
"not-applicable"
]
},
"dpaState": {
"type": "string",
"enum": [
"unknown",
"not-reviewed",
"available",
"executed",
"not-offered",
"not-applicable"
]
},
"personalDataHandled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"acceptedIdentifierClasses": {
"type": "array",
"items": {
"type": "string",
"enum": [
"household-key",
"maid-hash",
"euid",
"postcode-sector",
"full-postcode",
"email-hash",
"phone-hash",
"raw-device-id",
"other",
"none"
]
}
},
"rawDeviceIdentifiersRequired": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"retentionDays": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"dataResidencyRegions": {
"type": "array",
"items": {
"type": "string"
}
},
"blockers": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"supplierRole",
"chorusRole",
"dpaState",
"personalDataHandled",
"acceptedIdentifierClasses",
"rawDeviceIdentifiersRequired",
"retentionDays",
"dataResidencyRegions",
"blockers"
],
"additionalProperties": false
},
"support": {
"type": "object",
"properties": {
"accessState": {
"type": "string",
"enum": [
"unknown",
"not-established",
"established",
"unavailable"
]
},
"channels": {
"type": "array",
"items": {
"type": "string",
"enum": [
"unknown",
"email",
"ticket",
"phone",
"chat",
"account-manager",
"community"
]
}
},
"blockers": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"accessState",
"channels",
"blockers"
],
"additionalProperties": false
},
"evidence": {
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"unverified",
"partially-verified",
"verified",
"stale",
"disputed"
]
},
"lastReviewedOn": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"nextReviewOn": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"official-documentation",
"supplier-terms",
"supplier-correspondence",
"signed-contract",
"credentialed-read",
"contract-test",
"test-buy",
"delivery-report",
"invoice",
"support-case",
"other"
]
},
"title": {
"type": "string"
},
"publisher": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"observedOn": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"validUntil": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"assertedFacts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"kind",
"title",
"publisher",
"observedOn",
"validUntil",
"assertedFacts"
],
"additionalProperties": false
}
}
},
"required": [
"state",
"lastReviewedOn",
"nextReviewOn",
"items"
],
"additionalProperties": false
},
"readinessBlockers": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"schemaVersion",
"identity",
"commercialAccess",
"operations",
"billing",
"technical",
"creative",
"privacy",
"support",
"evidence",
"readinessBlockers"
],
"additionalProperties": false
}
},
"required": [
"id",
"adapterKey",
"status",
"effectiveStatus",
"revision",
"accessClass",
"verificationBlockers",
"provenanceCurrent",
"connectionBindingCurrent",
"verifiedAt",
"updatedAt",
"content"
],
"additionalProperties": false
}
},
"required": [
"dossier"
],
"additionalProperties": false
}Safety annotations
MCP annotations
{
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
}Annotations help a client present the tool. The API independently enforces authorization and exact action approvals. Error and retry guidance →