Systemonomic MCP Servers

MCP (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.).

Quick Start

1. Install

cd mcp
pip install -e ".[cli]"

Or install dependencies directly:

pip install "mcp[cli]" httpx

2. Get an API Key

1. Log in to Systemonomic
2. Go to Profile → API Keys
3. Click Generate API Key
4. Copy the key (starts with sk_sys_) — it's shown only once

3. Configure

Set the environment variable:

export SYSTEMONOMIC_API_KEY="sk_sys_your_key_here"

Optionally, point to a different API endpoint (defaults to production):

export SYSTEMONOMIC_API_URL="https://your-dev-backend.up.railway.app"

4. Add to Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "systemonomic-wda": {
      "command": "python",
      "args": ["-m", "systemonomic_mcp.wda_server"],
      "env": {
        "SYSTEMONOMIC_API_KEY": "sk_sys_your_key_here"
      }
    },
    "systemonomic-atss": {
      "command": "python",
      "args": ["-m", "systemonomic_mcp.atss_server"],
      "env": {
        "SYSTEMONOMIC_API_KEY": "sk_sys_your_key_here"
      }
    },
    "systemonomic-org": {
      "command": "python",
      "args": ["-m", "systemonomic_mcp.org_server"],
      "env": {
        "SYSTEMONOMIC_API_KEY": "sk_sys_your_key_here"
      }
    }
  }
}

5. Add to Cursor

In Cursor Settings → MCP Servers, add each server:

• Name: systemonomic-wda
• Command: python -m systemonomic_mcp.wda_server
• Environment: SYSTEMONOMIC_API_KEY=sk_sys_...

Repeat for atss_server and org_server.

Available Servers

systemonomic-wda — Work Domain Analysis

systemonomic-atss — Assessment & Tasks

systemonomic-org — Organizational Design

Example Conversations

"Help me model our procurement process"

You: Generate a WDA for our university procurement department. They handle purchase requests, vendor management, contract negotiation, and compliance with government regulations.

Claude: Uses create_project → generate_wda → returns the generated hierarchy

"Assess which tasks can be automated"

You: For the procurement project, derive tasks from the WDA and run an automation assessment.

Claude: Uses generate_tasks_from_wda → run_atss_batch → summarizes automation candidates

"Generate the full report"

You: Create a PDF report for the procurement project.

Claude: Uses generate_pdf_report → saves the PDF

Development

# Run a server locally for testing
cd mcp
pip install -e .
SYSTEMONOMIC_API_KEY=sk_sys_... python -m systemonomic_mcp.wda_server

# Use the MCP inspector
SYSTEMONOMIC_API_KEY=sk_sys_... mcp dev src/systemonomic_mcp/wda_server.py