Skip to content

cayu.runtime.mcp_manifest_policy

Public Cayu API. Definitions are grouped by their public source module, and definitions from private implementation modules appear on their package’s page; adding a symbol does not move existing links. The import shown at each entry is a supported public namespace. Read the Python API overview and install the required extra.

from cayu import copy_mcp_manifest_policy
copy_mcp_manifest_policy(policy: McpManifestPolicy | None) -> McpManifestPolicy | None

Release source · Runtime guarantees · Capability guides

from cayu import McpManifestPolicy

Controls whether changed MCP tool manifests may reach the model.

Bases: BaseModel.

Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.

Name Type Default
on_first_seen McpManifestPolicyAction McpManifestPolicyAction.ALLOW
on_unchanged McpManifestPolicyAction McpManifestPolicyAction.ALLOW
on_changed McpManifestPolicyAction McpManifestPolicyAction.BLOCK
on_server_changed McpManifestPolicyAction | None None
on_tools_added McpManifestPolicyAction | None None
on_tools_removed McpManifestPolicyAction | None None
on_tools_changed McpManifestPolicyAction | None None
McpManifestPolicy.decide(*, status: str, diff: Mapping[str, Any]) -> McpManifestPolicyDecision

Release source · Runtime guarantees · Capability guides

from cayu import McpManifestPolicyAction

Bases: StrEnum.

Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.

Name Type Default
ALLOW class attribute 'allow'
ALERT class attribute 'alert'
BLOCK class attribute 'block'

Release source · Runtime guarantees · Capability guides

from cayu import McpManifestPolicyDecision

Decision for one checked MCP tool manifest.

Bases: BaseModel.

Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.

Name Type Default
action McpManifestPolicyAction required
status str required
matched_changes list[str] Field(default_factory=list)
reason str required

Release source · Runtime guarantees · Capability guides

from cayu import McpManifestPolicyError

Raised when MCP manifest policy blocks a model step.

Bases: RuntimeError.

This type’s implementation and inherited behavior are available in the linked release source.

Release source · Runtime guarantees · Capability guides