Skip to content
MCP server

Iris Code

Project-aware code-quality rules, findings, safe fixes and gate results for coding agents

Runs locallyStatus and history
Pricing
Freemium
Platforms
CLI, jetbrains, vscode
Runs
Locally
Version
0.2.2
Listing updated
2 days ago

About Iris Code

Iris Code is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Iris Code's server lets an agent ask the same questions your pre-push hook or CI will ask, before it writes the code. Ten tools cover findings for a path, resolved thresholds, preview-then-apply safe fixes, refactor plans with a captured baseline, verification against that baseline, rule explanations, gate status, database schema structure and dependency or package risk.

Analysis runs locally with no general shell-execution tool. Secrets are masked, paths are confined to the project root, and applying a fix needs the single-use token from its preview. Dependency lookups use OSV advisories and need network consent. This repository holds only the MIT-licensed npm launcher and setup docs; the analysis engine is maintained separately.

Single-file work is free. Fresh multi-file project work needs sign-in and uses a monthly allowance, and Pro adds enforcement, custom thresholds and CI gates. Supported languages include JavaScript, TypeScript, Go, Python, Ruby, C#, Java and Rust.

Install

Run in a terminal

claude mcp add iris-code -- npx -y @iris-code/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "iris-code": {
      "command": "npx",
      "args": [
        "-y",
        "@iris-code/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "iris-code": {
      "command": "npx",
      "args": [
        "-y",
        "@iris-code/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "iris-code": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@iris-code/mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "iris-code": {
      "command": "npx",
      "args": [
        "-y",
        "@iris-code/mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "iris-code": {
      "command": "npx",
      "args": [
        "-y",
        "@iris-code/mcp"
      ]
    }
  }
}

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

iris_check
Located findings and code-health measurements for a path
iris_config
Resolved project thresholds and rules
iris_fix_safe
Preview and apply provably safe fixes
iris_refactor_plan
Refactor suggestions with a captured baseline
iris_verify_refactor
Compare code against the plan's baseline
iris_schema
Real database tables, columns and relations
iris_explain
Rule details behind findings
iris_gate
Quality-gate result and failing rules
iris_check_dependency
Advisory evidence for a dependency
iris_check_package
Package risk before installation

What it does

Real findings
Returns located findings with rule ids, line numbers and severity.
Safe fixes
Previews provably safe changes and refuses with a reason otherwise.
Refactor plans
Creates a plan with a baseline, then checks for regressions after edits.
Gate preview
Shows whether the configured gate would pass and which files fail.
Package guard
Checks dependencies and new packages against advisories.
Schema lookup
Gives real table and column names from backend schema declarations.

Good for

  • Have an agent check a file against project rules before editing
  • Block an agent from weakening tests to pass checks
  • Vet a package before the agent installs it
  • Plan a refactor and verify it afterwards

Pricing

Freemium

Free tier; Pro and Teams are paid, prices not published

Prices change. Check iriscode.co before you buy.

Iris Code FAQ

Is it free?

Single-file checks, project rules and gate preview are free; Pro adds broader enforcement and cloud scans.

Does my code leave my machine?

Editor analysis runs in-process; cloud scanning is an explicit opt-in per connected GitHub repository.

Is there a trial?

The pricing page says a 14-day Pro trial can be requested from your account without a card.

How do I run it?

`npx -y @iris-code/mcp` with Node 18 or newer.

Is Iris Code free?

Iris Code has a free plan, with paid plans for more usage or features.

How do I add Iris Code to Claude Code?

Run this command in your terminal: claude mcp add iris-code -- npx -y @iris-code/mcp

What are the best alternatives to Iris Code?

The closest alternatives to Iris Code are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Iris Code

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools