# Iris Code

> Iris Code is a freemium MCP server for developer tools. Project-aware code-quality rules, findings, safe fixes and gate results for coding agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, jetbrains, vscode
- **Website:** https://www.iriscode.co/mcp
- **Repository:** https://github.com/daiveedjay/iris-code-mcp
- **MCP Registry name:** io.github.Daiveedjay/iris-code
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/iris-code
