English Français العربية

Iris Code

Official registry Developer tools

Local code-quality rules, findings, preview-first safe fixes and gate results for coding agents.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @iris-code/mcp
Claude Code 
claude mcp add iris-code -- npx -y @iris-code/mcp@0.2.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "iris-code": {
            "command": "npx",
            "args": [
                "-y",
                "@iris-code/mcp@0.2.2"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Iris Code MCP launcher
  2. Install
  3. What agents can do
  4. Boundaries
  5. Support and privacy
  6. Registry metadata release

Iris Code MCP launcher

Give coding agents your project's real code-quality rules, findings, safe fixes and gate results.

This repository contains the npm launcher and setup documentation for Iris Code's local MCP server. It starts the published @iris-code/cli package, which carries the implementation. The analysis engine's source is maintained separately and is not included here. The launcher declares the MIT license; this repository does not claim the whole Iris Code product is open source.

Install

Requires Node.js 18 or newer.

npx -y @iris-code/mcp

Add this to your client's MCP configuration:

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

Clients normally supply the current workspace root. For a client that does not provide MCP roots, append --root and your absolute project path to args. In JetBrains IDEs, use Tools | Iris Code | Set Up MCP Server from the installed Iris Code plugin.

What agents can do

ToolPurpose
iris_checkLocated findings and code-health measurements
iris_configResolved project thresholds and rules
iris_fix_safePreview and apply provable mechanical fixes
iris_refactor_planLocated refactor suggestions and a captured baseline
iris_verify_refactorVerify improvement against a baseline
iris_schemaReal database tables, columns and relations
iris_explainRule details behind findings
iris_gateQuality-gate result and failing rules
iris_check_dependencyDependency advisory evidence
iris_check_packagePackage risk before installation

Single-file workflows are Free and require no API key. Fresh project work requires sign-in and applicable access. Reopening owned evidence does not spend another project action. Paid access adds broader enforcement and project capabilities. See current pricing and the MCP guide.

Boundaries

Analysis runs locally. The server has no general shell-execution tool. Secret values are masked, and requested paths are confined to the project root, including symlink resolution. Safe fixes preview first; applying needs the preview's single-use token. Dependency and advisory lookups require network consent. Repository handoff policy and access checks still apply.

Support and privacy

Registry metadata release

Version 0.2.2 adds the official MCP Registry ownership name io.github.Daiveedjay/iris-code. Launcher behavior and the CLI dependency range are unchanged. The npm package's repository URL identifies the existing private release owner because npm trusted publishing requires it to match the workflow repository. This public repository supplies launcher source and documentation; npm publication still runs from the private release workflow.

Official MCP Registry identity: io.github.Daiveedjay/iris-code, published version 0.2.2. Verify the public registry metadata. The entry uses local stdio transport, not a hosted endpoint.

Frequently asked questions

What is Iris Code?

Local code-quality rules, findings, preview-first safe fixes and gate results for coding agents.

How do I install Iris Code?

It runs on your machine. In Claude Code: claude mcp add iris-code -- npx -y @iris-code/mcp@0.2.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Iris Code need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Iris Code open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Iris Code?

It is published by Daiveedjay. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.