@mag.ni/process

MCP server for MagniProcess by MagniFinance — design workflows that guide AI agents through tasks, decisions, and reporting.

Install

Run one command in your terminal:

Mac / Linux:

claude mcp add process -- npx -y "@mag.ni/process@latest"

Windows:

claude mcp add process -- cmd /c npx -y "@mag.ni/process@latest"

Restart Claude Code. On first use, a browser window opens for authentication. After signing in, the token is stored locally and reused automatically.

Updates are picked up automatically when the MCP server restarts — no manual upgrade needed.

Why project-level? Each MCP server instance maintains its own agent session. Installing globally causes session conflicts when multiple projects try to claim different agent identities simultaneously. Project-level installation keeps each project's session isolated.

Configuration

All settings have sensible defaults. Override via the env block in .mcp.json if needed:

| Variable | Default | Description | |----------|---------|-------------| | PROCESSES_API_URL | https://process.mag.ni | Process API endpoint | | PROCESSES_AUTH_URL | https://auth.mag.ni | OAuth authorization server | | PROCESSES_OAUTH_CLIENT_ID | process-mcp | OAuth client ID | | PROCESSES_OAUTH_CALLBACK_PORT | 19823 | Local port for OAuth callback |

Available Tools

Agent Management

| Tool | Description | |------|-------------| | list_agent_users | List all agent identities | | create_agent_user | Create a new agent identity | | delete_agent_user | Delete an unclaimed agent identity |

Session Management

| Tool | Description | |------|-------------| | claim_user | Claim an agent identity to start working | | heartbeat | Extend session lease | | release_user | Release claimed identity | | logout | Clear session and stored credentials |

Workflow Execution

| Tool | Description | |------|-------------| | get_my_instances | Get workflow instances assigned to you | | get_instance_details | Get current step, history, and metadata | | get_available_actions | Get actions at the current step | | take_action | Execute an action to advance the workflow | | get_diagram_context | Get full workflow structure | | get_instance_notes | Get notes on an instance | | add_instance_note | Add a note to an instance | | get_node_details | Get detailed instructions for steps |

Diagram Design

| Tool | Description | |------|-------------| | enter_design_mode | Enter design mode | | exit_design_mode | Exit design mode | | list_diagrams | List available diagrams | | get_diagram | Get diagram details | | create_diagram | Create a new diagram | | update_diagram | Update diagram properties | | create_node | Add a node to a diagram | | update_node | Modify a node | | delete_node | Remove a node | | create_arrow | Connect two nodes | | update_arrow | Modify a connection | | delete_arrow | Remove a connection | | delete_diagram | Delete a diagram | | duplicate_diagram | Copy a diagram |

Requirements

• Node.js 18+
• An MCP-compatible client (e.g. Claude Code)

License

MIT