dokugent mcp-schema¶

Generate an MCP-compliant schema for any registered agent plan.

This command outputs a structured JSON schema that aligns with the Messaging & Coordination Protocol (MCP), allowing agent definitions to communicate, interoperate, or be certified in multi-agent systems.

Usage¶

dokugent mcp-schema --agent ice-001 --server firewatch --output .dokugent/agents/ice-001-2025-05-21T12-00/mcp-firewatch/

Options¶

Flag	Description
`--agent`	Required. Agent ID to export schema for.
`--server`	Optional. Server name to generate a scoped schema for. Defaults to `default`.
`--output`	Optional. Path to write the schema file to.
`--dryrun`	Show the schema without writing to disk.
`--validate`	Check if schema complies with MCP conventions.

Example¶

dokugent mcp-schema --agent ice-001 --output mcp/ice-001.schema.json

This will generate a fully MCP-aligned schema from the agent’s existing plan.md, criteria.md, and metadata.yml.

When to Use¶

Use mcp-schema when:

Preparing an agent to participate in a multi-agent system
Integrating Dokugent-certified agents with external runtime orchestrators
Verifying schema compliance for third-party coordination layers
Generating versioned message schemas per server (e.g. firewatch, datasync, dispatch)

Output Structure¶

MCP schema files are generated per agent version and organized by server scope. Each schema includes both message and response formats.

.dokugent/agents/{agent-id}-{timestamp}/mcp-{server-name}/
  ├── outbound-message.schema.json   # Shape of messages this agent sends
  └── inbound-response.schema.json   # Expected structure of server replies

This structure ensures clarity and modularity for inter-agent coordination and versioned deployments.