Integrations pillar · v0.16.0

mcp-tool McpTool

MCP tool record.

$id · https://corpospec.com/schemas/v0.16.0/mcp-tool.schema.json

Fields

Field	Type	Required	Description
audit_logged	boolean	yes	Whether invocations are audit-logged.
created_at	IsoDate	yes	ISO 8601 date (YYYY-MM-DD).
description	string	yes
human_in_loop	HumanInLoopPolicy	yes	Approval / human-in-the-loop policy.
id	PathRef	yes	Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
max_runtime_seconds	integer	yes	Maximum runtime seconds before timeout.
name	string	yes	Tool name as exposed via MCP.
owner	PathRef	yes	Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
required_permissions	string[]	yes	Permission scopes required to invoke.
risk_tier	AiRiskTier	yes	Risk tier (mapped to EU AI Act risk levels).
server	PathRef	yes	PathRef to the MCP server hosting this tool.
side_effects	ToolSideEffect[]	yes	Side-effect category (max severity wins for safety).
status	McpToolStatus	yes	Lifecycle.
deprecated_on	IsoDate?	—
docs_ref	PathRef?	—	PathRef to docs.
governing_bdr	PathRef?	—	PathRef to the BDR governing this tool.
input_schema_ref	PathRef?	—	PathRef to the JSON-schema of the inputs.
min_confidence	number?	—	Minimum confidence to auto-invoke (0.0–1.0; relevant for ConditionalApprove).
output_schema_ref	PathRef?	—	PathRef to the JSON-schema of the outputs.

Shared types referenced within this schema.

AiRiskTier

Risk tier (mapped to EU AI Act risk levels).

HumanInLoopPolicy

Approval / human-in-the-loop policy.

IsoDate

ISO 8601 date (YYYY-MM-DD).

type: string

McpToolStatus

Lifecycle.

enum: "alpha", "beta", "stable", "deprecated", "removed"

PathRef

Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`

pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$

ToolSideEffect

Side-effect class.

# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/mcp-tool.schema.json