OSOP MCP Server

April 14, 2026 · View on GitHub

5 tools for AI agents to validate, record, diff, optimize, and view OSOP workflows.

Any MCP-compatible client (Claude, Cursor, Windsurf) becomes workflow-aware.

Tools

Tool	Description
`osop.validate`	Validate `.osop.yaml` or `.osoplog.yaml` against schema
`osop.record`	Execute workflow, produce `.osoplog` execution record
`osop.diff`	Compare two workflows or execution logs
`osop.optimize`	Synthesize better workflow from multiple execution logs
`osop.view`	Render `.sop` into standalone HTML document

pip install osop-mcp

Add to your project's .mcp.json:

{
  "mcpServers": {
    "osop": {
      "command": "python",
      "args": ["-m", "osop_mcp"]
    }
  }
}

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "osop": {
      "command": "python",
      "args": ["-m", "osop_mcp"],
      "env": {}
    }
  }
}

OSOP is the standard format for describing and logging AI agent workflows. 4 node types, 4 edge modes.

Apache License 2.0