UnifiedProtectionCard
Unified protection card (ADR-037). Safe House thresholds + trusted-source policy for a single agent. Shape matches src/composition/types.ts::UnifiedProtectionCard (canonical) and what the runtime validator at src/composition/validate.ts accepts. The customer-facing docs at /concepts/protection-card and /specifications/protection-card-schema document this same shape.
Properties
| Name | Type | Description |
|---|---|---|
| card_version | string | |
| content_version | string | Optional. Which default content the card carries, e.g. `mnemom-agent-default/2.1.0` (semver within a lineage). Distinct from `card_version`, the schema version. New agents are born with it; compositio |
| card_id | string | |
| agent_id | string | |
| issued_at | string | |
| expires_at | stringnull | |
| mode | string | Strictest-wins composition: enforce > nudge > observe > off. |
| thresholds | object | Score bands. Must satisfy warn <= quarantine <= block; each value in [0, 1]. |
| screen_surfaces | object | Which request surfaces Safe House inspects. Composed across scopes by OR-per-field (any scope requiring inspection wins). |
| trusted_sources | object | Sources for which detectors short-circuit (each match logged in the trace). Composed as platform->agent intersection (compliance ceiling) with org+agent union inside that ceiling — an agent cannot wid |
| protected_surface | object | Org-declared protected surface policy (MNE-830). Strengthen-only UNION across platform → org → team → agent: each scope may add entries; none may remove. The composer always emits this block; callers |
| review | object | Review-hold policy (Safe House Review, Slice 2a — MNE-920 design). gate_on is the minimum verdict band per surface that escalates to a review-hold. Composition is strictest-wins; on_timeout defaults t |
| attended_default | boolean | Owner-declared default for whether a person is watching this agent's sessions. The gateway uses it only when the request carries no attended header or session key and no durable posture is stored; oth |
| tier_modes | object | Per-action risk tier modes for Safe House (C7 withhold, review, response-side withhold). Capped by `mode`: a tier can only lower it, and read-tier calls are never withheld. Composition is strictest-wi |
| trusted_mcp_servers | array | MCP servers whose calls are in_scope_write instead of out_of_scope. Composition is the intersection across the scopes that define it, so a server is trusted only when every defining scope trusts it. O |
| extensions | object | Free-form extension slot for non-canonical fields. Ignored by the composer; preserved on read for tooling that needs an audit-tail metadata bag. |
| _composition | object | |
| content_hash | string | Response-only: content hash of the composed card (`sha256: |
| version | integer | Response-only: monotonic card version, injected by the GET/PUT response. Server-assigned — do not send on a PUT. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/mnemom-ai/json-schema/mnemom-ai-unified-protection-card-schema.json",
"title": "UnifiedProtectionCard",
"description": "Unified protection card (ADR-037). Safe House thresholds + trusted-source policy for a single agent. Shape matches src/composition/types.ts::UnifiedProtectionCard (canonical) and what the runtime validator at src/composition/validate.ts accepts. The customer-facing docs at /concepts/protection-card and /specifications/protection-card-schema document this same shape.",
"x-generated": "2026-11-18",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/mnemom-ai-openapi.json#/components/schemas/UnifiedProtectionCard",
"type": "object",
"required": [
"card_version",
"agent_id",
"mode",
"thresholds",
"screen_surfaces",
"trusted_sources"
],
"properties": {
"card_version": {
"type": "string"
},
"content_version": {
"type": "string",
"description": "Optional. Which default content the card carries, e.g. `mnemom-agent-default/2.1.0` (semver within a lineage). Distinct from `card_version`, the schema version. New agents are born with it; composition carries the agent card's value onto the canonical card."
},
"card_id": {
"type": "string"
},
"agent_id": {
"type": "string"
},
"issued_at": {
"type": "string",
"format": "date-time"
},
"expires_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"mode": {
"type": "string",
"enum": [
"off",
"observe",
"nudge",
"enforce"
],
"description": "Strictest-wins composition: enforce > nudge > observe > off."
},
"thresholds": {
"type": "object",
"description": "Score bands. Must satisfy warn <= quarantine <= block; each value in [0, 1].",
"required": [
"warn",
"quarantine",
"block"
],
"properties": {
"warn": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"quarantine": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"block": {
"type": "number",
"minimum": 0,
"maximum": 1
}
}
},
"screen_surfaces": {
"type": "object",
"description": "Which request surfaces Safe House inspects. Composed across scopes by OR-per-field (any scope requiring inspection wins).",
"required": [
"incoming",
"outgoing",
"tool_calls",
"tool_responses"
],
"properties": {
"incoming": {
"type": "boolean",
"description": "The user/principal prompt entering the agent."
},
"outgoing": {
"type": "boolean",
"description": "The agent's response leaving the agent."
},
"tool_calls": {
"type": "boolean",
"description": "Tool-use invocations the agent makes."
},
"tool_responses": {
"type": "boolean",
"description": "Responses to tool calls returning to the agent."
}
}
},
"trusted_sources": {
"type": "object",
"description": "Sources for which detectors short-circuit (each match logged in the trace). Composed as platform->agent intersection (compliance ceiling) with org+agent union inside that ceiling — an agent cannot widen trust beyond what the platform allows.",
"required": [
"domains",
"agent_ids",
"ip_ranges"
],
"properties": {
"domains": {
"type": "array",
"items": {
"type": "string"
},
"description": "DNS names or host:port entries."
},
"agent_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Mnemom agent IDs (mnm-* / smolt-* prefixed)."
},
"ip_ranges": {
"type": "array",
"items": {
"type": "string"
},
"description": "IPv4 or IPv6 CIDR ranges."
}
}
},
"protected_surface": {
"type": "object",
"description": "Org-declared protected surface policy (MNE-830). Strengthen-only UNION across platform → org → team → agent: each scope may add entries; none may remove. The composer always emits this block; callers omit it to inherit the composed floor. See ADR-037 §protected_surface.",
"properties": {
"assets": {
"type": "array",
"description": "Protected assets. Intrinsic identity = `${kind}:${selector}` (normalized). Composer merges by identity, keeping the strictest entry per scope.",
"items": {
"type": "object",
"required": [
"kind",
"selector"
],
"properties": {
"kind": {
"type": "string",
"description": "Asset kind (e.g. `row`, `field`, `resource`, `table`)."
},
"selector": {
"type": "string",
"description": "Asset selector (e.g. `customer:critical-0000`, `replica_dsn`)."
},
"label": {
"type": "string",
"description": "Human-facing display label (optional)."
},
"reason": {
"type": "string",
"description": "Why this asset is protected (optional)."
},
"source_scope": {
"type": "string",
"description": "Composer-assigned provenance (`platform`, `org:<id>`, `team:<id>`, `agent:<id>`). Server-assigned — do not send on a PUT."
}
}
}
},
"forbidden_operations": {
"type": "array",
"description": "Operations that are unconditionally forbidden. Intrinsic identity = normalized `pattern`. Composer unions across scopes; on identity collision, severity → max.",
"items": {
"type": "object",
"required": [
"pattern"
],
"properties": {
"pattern": {
"type": "string",
"description": "Operation pattern (e.g. `TRUNCATE`, `unscoped UPDATE/DELETE`, `exfiltrate:pii`)."
},
"applies_to": {
"type": "array",
"items": {
"type": "string"
},
"description": "Asset identities (`${kind}:${selector}`) this operation applies to. Empty/absent means GLOBAL."
},
"severity": {
"type": "string",
"enum": [
"low",
"medium",
"high",
"critical"
],
"description": "Severity level. Composer merges to strictest across scopes."
},
"reason": {
"type": "string",
"description": "Why this operation is forbidden (optional)."
},
"source_scope": {
"type": "string",
"description": "Composer-assigned provenance. Server-assigned — do not send on a PUT."
}
}
}
},
"escalation_required": {
"type": "array",
"description": "Operations that require escalation before proceeding. Same intrinsic-identity + union rules as forbidden_operations (minus severity).",
"items": {
"type": "object",
"required": [
"pattern"
],
"properties": {
"pattern": {
"type": "string",
"description": "Operation pattern requiring escalation."
},
"applies_to": {
"type": "array",
"items": {
"type": "string"
},
"description": "Asset identities this escalation applies to. Empty/absent = GLOBAL."
},
"reason": {
"type": "string",
"description": "Why escalation is required (optional)."
},
"source_scope": {
"type": "string",
"description": "Composer-assigned provenance. Server-assigned — do not send on a PUT."
}
}
}
}
}
},
"review": {
"type": "object",
"description": "Review-hold policy (Safe House Review, Slice 2a — MNE-920 design). gate_on is the minimum verdict band per surface that escalates to a review-hold. Composition is strictest-wins; on_timeout defaults to 'reject' (fail-closed). reviewer.kind 'endpoint' is designed for MNE-1650 and not consumed yet.",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
},
"gate_on": {
"type": "object",
"properties": {
"incoming": {
"type": "string",
"enum": [
"off",
"warn",
"quarantine",
"block"
]
},
"outgoing": {
"type": "string",
"enum": [
"off",
"warn",
"quarantine",
"block"
]
},
"tool_calls": {
"type": "string",
"enum": [
"off",
"warn",
"quarantine",
"block"
]
},
"tool_responses": {
"type": "string",
"enum": [
"off",
"warn",
"quarantine",
"block"
]
},
"integrity": {
"type": "string",
"enum": [
"off",
"review_needed",
"boundary_violation"
]
}
}
},
"sla_seconds": {
"type": "number",
"minimum": 1
},
"on_timeout": {
"type": "string",
"enum": [
"reject",
"release"
]
},
"notify": {
"type": "object",
"properties": {
"sse": {
"type": "boolean"
},
"webhooks": {
"type": "boolean"
}
}
},
"reviewer": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"enum": [
"builtin_opus",
"endpoint"
]
},
"endpoint_url": {
"type": "string",
"format": "uri"
}
}
},
"quarantine_notice": {
"type": "string",
"maxLength": 2000
}
}
},
"attended_default": {
"type": "boolean",
"description": "Owner-declared default for whether a person is watching this agent's sessions. The gateway uses it only when the request carries no attended header or session key and no durable posture is stored; otherwise sessions are unattended. Composition is false-wins: any scope declaring false yields false. Omitted from the composed card when no scope defines it."
},
"tier_modes": {
"type": "object",
"additionalProperties": false,
"properties": {
"read": {
"type": "string",
"enum": [
"off",
"observe",
"nudge",
"enforce"
]
},
"in_scope_write": {
"type": "string",
"enum": [
"off",
"observe",
"nudge",
"enforce"
]
},
"out_of_scope": {
"type": "string",
"enum": [
"off",
"observe",
"nudge",
"enforce"
]
},
"protected": {
"type": "string",
"enum": [
"off",
"observe",
"nudge",
"enforce"
]
}
},
"description": "Per-action risk tier modes for Safe House (C7 withhold, review, response-side withhold). Capped by `mode`: a tier can only lower it, and read-tier calls are never withheld. Composition is strictest-wins per tier (enforce > nudge > observe > off). Omitted from the composed card when no scope defines it."
},
"trusted_mcp_servers": {
"type": "array",
"maxItems": 256,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"description": "MCP servers whose calls are in_scope_write instead of out_of_scope. Composition is the intersection across the scopes that define it, so a server is trusted only when every defining scope trusts it. Omitted from the composed card when no scope defines it."
},
"extensions": {
"type": "object",
"additionalProperties": true,
"description": "Free-form extension slot for non-canonical fields. Ignored by the composer; preserved on read for tooling that needs an audit-tail metadata bag."
},
"_composition": {
"$ref": "#/$defs/CompositionMetadata"
},
"content_hash": {
"type": "string",
"description": "Response-only: content hash of the composed card (`sha256:<hex>`), injected by the GET/PUT response. Server-assigned — do not send on a PUT."
},
"version": {
"type": "integer",
"description": "Response-only: monotonic card version, injected by the GET/PUT response. Server-assigned — do not send on a PUT."
}
},
"$defs": {
"CompositionMetadata": {
"type": "object",
"description": "System-managed block describing which scope sources merged into the canonical card. Only returned when `?include_composition=true`.",
"properties": {
"canonical_id": {
"type": "string"
},
"composed_at": {
"type": "string",
"format": "date-time"
},
"scopes_applied": {
"type": "array",
"items": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"description": "`platform`, `org:<id>`, or `agent:<id>`."
},
"version": {
"type": "integer"
},
"template_version": {
"type": "integer"
},
"card_id": {
"type": "string"
}
}
}
},
"exemptions_applied": {
"type": "array",
"items": {
"type": "string"
}
},
"source_card_id": {
"type": "string"
},
"source_policy_id": {
"type": "string"
}
}
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-schemas/mnemom-ai-unified-protection-card"
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.