Raigal MCP server

The Raigal Model Context Protocol (MCP) server connects Raigal’s quality and pattern detection engines directly to coding agents and IDEs via npx --yes @methiu/raigal@latest mcp.

Prerequisites and authentication

Raigal MCP authenticates in one of two ways:

Local session: if you have already run raigal login on your machine, the MCP server detects your local credentials automatically without extra token configuration.
Environment variable: in headless environments or CI, provide your API token by setting RAIGAL_TOKEN=rgl_live_....

Client configuration

Run the setup command in your terminal:

claude mcp add raigal -- npx --yes @methiu/raigal@latest mcp

With an explicit API token:

claude mcp add raigal -e RAIGAL_TOKEN=rgl_live_... -- npx --yes @methiu/raigal@latest mcp

Open Cursor Settings (Cmd + , or Ctrl + ,).
Go to Features > MCP.
Select Add New MCP Server.
Configure the server:
- Name: raigal
- Type: command
- Command: npx --yes @methiu/raigal@latest mcp

To configure via .cursor/mcp.json instead:

{
  "mcpServers": {
    "raigal": {
      "command": "npx",
      "args": ["--yes", "@methiu/raigal@latest", "mcp"],
      "env": {
        "RAIGAL_TOKEN": "rgl_live_YOUR_TOKEN_HERE"
      }
    }
  }
}

Add the server to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "raigal": {
      "command": "npx",
      "args": ["--yes", "@methiu/raigal@latest", "mcp"],
      "env": {
        "RAIGAL_TOKEN": "rgl_live_YOUR_TOKEN_HERE"
      }
    }
  }
}

Add the server to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "raigal": {
      "command": "npx",
      "args": ["--yes", "@methiu/raigal@latest", "mcp"]
    }
  }
}

Open the Cline / Roo Code sidebar in VS Code.
Select the MCP Servers icon.
Select Edit Global MCP Settings and add:

{
  "mcpServers": {
    "raigal": {
      "command": "npx",
      "args": ["--yes", "@methiu/raigal@latest", "mcp"]
    }
  }
}

Add the server to ~/.gemini/config/mcp_config.json or to your repository’s .agents/mcp_config.json:

{
  "mcpServers": {
    "raigal": {
      "command": "npx",
      "args": ["--yes", "@methiu/raigal@latest", "mcp"]
    }
  }
}

Available tools

Once connected, agents can call four tools:

Tool	Description
`raigal_scan`	Checks the repository for pattern violations (unnecessary comments, swallowed exceptions, `as any` casts), security risks, lint issues, and formatting discrepancies, returning a score from 0 to 100.
`raigal_fix`	Runs automated, safe fixes for detected issues.
`raigal_why`	Explains why a specific rule triggered and suggests fixes.
`raigal_baseline`	Creates or updates a baseline so the agent focuses on newly introduced issues.

Agent prompt instructions

To instruct coding agents to verify their work before finishing, add this snippet to AGENTS.md, CLAUDE.md, or your agent prompt:

Before submitting code changes, run the `raigal_scan` MCP tool to check for AI anti-patterns, swallowed errors, and type regressions. If issues are found, use `raigal_fix` or resolve them before finishing.

Getting started

Core concepts

CLI reference

Automation & CI/CD

Cloud platform

Raigal MCP server

Prerequisites and authentication

Client configuration

Available tools

Agent prompt instructions

​Prerequisites and authentication

​Client configuration

​Available tools

​Agent prompt instructions

Prerequisites and authentication

Client configuration

Available tools

Agent prompt instructions