Content
# OSOP MCP Server
**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 |
## Installation
```bash
pip install osop-mcp
```
## Usage
### Claude Code
Add to your project's `.mcp.json`:
```json
{
"mcpServers": {
"osop": {
"command": "python",
"args": ["-m", "osop_mcp"]
}
}
}
```
### Claude Desktop
Add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"osop": {
"command": "python",
"args": ["-m", "osop_mcp"],
"env": {}
}
}
}
```
## What is OSOP?
OSOP is the standard format for describing and logging AI agent workflows. 4 node types, 4 edge modes.
- **CLI**: `pip install osop` (validate, record, diff, optimize, view)
- **Spec**: [osop-spec](https://github.com/Archie0125/osop-spec)
- **Editor**: [osop-editor](https://osop-editor.vercel.app)
## License
Apache License 2.0
