npm package: @mag.ni/process
Description: MCP server for MagniProcess by MagniFinance — design workflows that guide AI agents through tasks, decisions, and reporting
Author: Mag.ni
Latest version: 1.0.14

# @mag.ni/process

MCP server for [MagniProcess](https://process.mag.ni) by [MagniFinance](https://mag.ni) — design workflows that guide AI agents through tasks, decisions, and reporting.

## Install

Run one command in your terminal:

**Mac / Linux:**
```bash
claude mcp add process -- npx -y "@mag.ni/process@latest"
```

**Windows:**
```bash
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](https://claude.com/claude-code))

## License

MIT