{
  "markdown": "# Systemonomic MCP Servers\n\n<!-- mcp-name: io.github.TonyC23/systemonomic-mcp -->\n\nMCP (Model Context Protocol) servers that expose Systemonomic's Work Domain Analysis, ATSS assessment, and organizational design capabilities to AI agents (Claude Desktop, Cursor, Claude Code, etc.).\n\n## Quick Start\n\n### 1. Install\n\n```bash\npip install systemonomic-mcp\n```\n\n### 2. Get an API Key\n\n1. Log in to [Systemonomic](https://systemonomic.com)\n2. Go to **Profile** → **API Keys**\n3. Click **Generate API Key**\n4. Copy the key (starts with `sk_sys_`) — it's shown only once\n\n### 3. Configure\n\nSet the environment variable:\n\n```bash\nexport SYSTEMONOMIC_API_KEY=\"sk_sys_your_key_here\"\n```\n\nOptionally, point to a different API endpoint (defaults to production):\n\n```bash\nexport SYSTEMONOMIC_API_URL=\"https://your-dev-backend.up.railway.app\"\n```\n\n### 4. Add to Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"systemonomic-wda\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"systemonomic_mcp.wda_server\"],\n      \"env\": {\n        \"SYSTEMONOMIC_API_KEY\": \"sk_sys_your_key_here\"\n      }\n    },\n    \"systemonomic-atss\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"systemonomic_mcp.atss_server\"],\n      \"env\": {\n        \"SYSTEMONOMIC_API_KEY\": \"sk_sys_your_key_here\"\n      }\n    },\n    \"systemonomic-org\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"systemonomic_mcp.org_server\"],\n      \"env\": {\n        \"SYSTEMONOMIC_API_KEY\": \"sk_sys_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### 5. Add to Cursor\n\nIn Cursor Settings → MCP Servers, add each server:\n\n- **Name:** `systemonomic-wda`\n- **Command:** `python -m systemonomic_mcp.wda_server`\n- **Environment:** `SYSTEMONOMIC_API_KEY=sk_sys_...`\n\nRepeat for `atss_server` and `org_server`.\n\n## Available Servers\n\n### `systemonomic-wda` — Work Domain Analysis\n\n| Tool | Description |\n|------|-------------|\n| `list_projects` | List all projects |\n| `get_project_state` | Get complete project state |\n| `create_project` | Create a new project |\n| `get_project_stats` | Get project statistics |\n| `list_wda_nodes` | List WDA nodes |\n| `create_wda_node` | Create a node at a WDA level |\n| `update_wda_node` | Update a node's label/level/description |\n| `delete_wda_node` | Delete a node |\n| `list_wda_links` | List means-ends links |\n| `create_wda_link` | Link two nodes |\n| `delete_wda_link` | Remove a link |\n| `generate_wda` | AI-generate a full WDA from a text description |\n| `export_project` | Export project as JSON |\n| `import_wda` | Import nodes and links |\n\n### `systemonomic-atss` — Assessment & Tasks\n\n| Tool | Description |\n|------|-------------|\n| `list_tasks` | List project tasks |\n| `create_task` | Create a task |\n| `generate_tasks_from_wda` | Auto-generate tasks from WDA Objects |\n| `derive_task_suggestions` | AI-derived task suggestions |\n| `list_suggestions` | List pending suggestions |\n| `accept_suggestions` | Promote suggestions to tasks |\n| `run_atss_batch` | Run ATSS assessment on all tasks |\n| `get_atss_results` | Get stored assessment results |\n| `persist_atss_results` | Save assessment results |\n| `list_atss_runs` | List assessment run history |\n\n### `systemonomic-org` — Organizational Design\n\n| Tool | Description |\n|------|-------------|\n| `get_org_design` | Get current roles, org units, allocations |\n| `persist_org_design` | Save org design |\n| `propose_restructure` | AI-generated restructure proposal |\n| `apply_proposal` | Apply a restructure proposal |\n| `validate_raci` | Validate RACI matrix |\n| `create_org_snapshot` | Create version snapshot |\n| `list_org_snapshots` | List snapshots |\n| `export_org_design_json` | Export as JSON |\n| `generate_pdf_report` | Generate comprehensive PDF report |\n| `get_report_status` | Check report readiness |\n\n## Example Conversations\n\n### \"Help me model our procurement process\"\n\n> **You:** Generate a WDA for our university procurement department. They handle purchase requests, vendor management, contract negotiation, and compliance with government regulations.\n>\n> **Claude:** *Uses `create_project` → `generate_wda` → returns the generated hierarchy*\n\n### \"Assess which tasks can be automated\"\n\n> **You:** For the procurement project, derive tasks from the WDA and run an automation assessment.\n>\n> **Claude:** *Uses `generate_tasks_from_wda` → `run_atss_batch` → summarizes automation candidates*\n\n### \"Generate the full report\"\n\n> **You:** Create a PDF report for the procurement project.\n>\n> **Claude:** *Uses `generate_pdf_report` → saves the PDF*\n\n## Development\n\n```bash\n# Run a server locally for testing\ncd mcp\npip install -e .\nSYSTEMONOMIC_API_KEY=sk_sys_... python -m systemonomic_mcp.wda_server\n\n# Use the MCP inspector\nSYSTEMONOMIC_API_KEY=sk_sys_... mcp dev src/systemonomic_mcp/wda_server.py\n```\n",
  "bytes": 4783,
  "sha": "f8b13043cc4e03258f53492ab9d919af7c4fe13ba564f9f78d3d2d302ae710b7",
  "repo_slug": "tonyc23/systemonomic-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_tonyc23_systemonomic_mcp_abdf29a8/readme"
}