Mnemom · Schema

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.

Artificial IntelligenceTrustSecurityAgenticInternetPlatform

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:`), injected by the GET/PUT response. Server-assigned — do not send on a PUT.
version integer Response-only: monotonic card version, injected by the GET/PUT response. Server-assigned — do not send on a PUT.
View JSON Schema on GitHub

JSON Schema

mnemom-ai-unified-protection-card-schema.json Raw ↑
{
  "$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.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/mnemom-ai-unified-protection-card"
All schemas
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.