Iris Code
Project-aware code-quality rules, findings, safe fixes and gate results for coding agents
- 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/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"iris-code": {
"command": "npx",
"args": [
"-y",
"@iris-code/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"iris-code": {
"command": "npx",
"args": [
"-y",
"@iris-code/mcp"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools