Stop shipping agents on vibes. Score every agent output for quality, safety, and cost.
To add Iris to Claude, run the install command below or copy the ready-made config for Claude Code, Claude Desktop, Cursor and VS Code further down. Restart your client after adding it and its tools show up in your next conversation. It needs 35 environment variables, listed below.
Install
npx -y @iris-eval/mcp-server@0.21.0Environment variables
IRIS_API_KEYSet in your MCP configIRIS_API_KEY_FILESet in your MCP configIRIS_ALLOW_UNAUTHENTICATEDSet in your MCP configIRIS_DB_PATHSet in your MCP configIRIS_SQLITE_DRIVERSet in your MCP configIRIS_SEARCH_BUDGET_MSSet in your MCP configIRIS_SEARCH_INDEXSet in your MCP configIRIS_LOG_LEVELSet in your MCP configIRIS_HOMESet in your MCP configIRIS_ANTHROPIC_API_KEYSet in your MCP configIRIS_OPENAI_API_KEYSet in your MCP configIRIS_LLM_JUDGE_MAX_COST_USD_PER_EVALSet in your MCP configIRIS_RELEVANCE_JUDGE_MODELSet in your MCP configIRIS_LLM_JUDGE_DAILY_BUDGET_USDSet in your MCP configIRIS_RELEVANCE_JUDGE_DAILY_BUDGET_USDSet in your MCP configIRIS_RELEVANCE_JUDGE_MAX_CALLS_PER_REQUESTSet in your MCP configIRIS_RELEVANCE_JUDGE_REDACTSet in your MCP configIRIS_CITATION_ALLOW_FETCHSet in your MCP configIRIS_DASHBOARDSet in your MCP configIRIS_DASHBOARD_PORTSet in your MCP configIRIS_PORTSet in your MCP configIRIS_OTEL_ENDPOINTSet in your MCP configIRIS_CITATION_DOMAINSSet in your MCP configIRIS_CITATION_MAX_COST_USD_TOTALSet in your MCP configIRIS_TRANSPORTSet in your MCP configIRIS_HOSTSet in your MCP configIRIS_ALLOWED_ORIGINSSet in your MCP configIRIS_MAX_INPUT_ELEMENTSSet in your MCP configIRIS_MAX_TOOL_INPUT_ELEMENTSSet in your MCP configIRIS_DASHBOARD_HOSTSet in your MCP configIRIS_OTEL_HEADERSSet in your MCP configIRIS_OTEL_SERVICE_NAMESet in your MCP configIRIS_OTEL_TIMEOUT_MSSet in your MCP configIRIS_WEBHOOK_URLSet in your MCP configIRIS_WEBHOOK_SECRETSet in your MCP configInstall with your client
claude mcp add iris --env IRIS_API_KEY=<YOUR_IRIS_API_KEY> --env IRIS_API_KEY_FILE=<YOUR_IRIS_API_KEY_FILE> --env IRIS_ALLOW_UNAUTHENTICATED=<YOUR_IRIS_ALLOW_UNAUTHENTICATED> --env IRIS_DB_PATH=<YOUR_IRIS_DB_PATH> --env IRIS_SQLITE_DRIVER=<YOUR_IRIS_SQLITE_DRIVER> --env IRIS_SEARCH_BUDGET_MS=<YOUR_IRIS_SEARCH_BUDGET_MS> --env IRIS_SEARCH_INDEX=<YOUR_IRIS_SEARCH_INDEX> --env IRIS_LOG_LEVEL=<YOUR_IRIS_LOG_LEVEL> --env IRIS_HOME=<YOUR_IRIS_HOME> --env IRIS_ANTHROPIC_API_KEY=<YOUR_IRIS_ANTHROPIC_API_KEY> --env IRIS_OPENAI_API_KEY=<YOUR_IRIS_OPENAI_API_KEY> --env IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL=<YOUR_IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL> --env IRIS_RELEVANCE_JUDGE_MODEL=<YOUR_IRIS_RELEVANCE_JUDGE_MODEL> --env IRIS_LLM_JUDGE_DAILY_BUDGET_USD=<YOUR_IRIS_LLM_JUDGE_DAILY_BUDGET_USD> --env IRIS_RELEVANCE_JUDGE_DAILY_BUDGET_USD=<YOUR_IRIS_RELEVANCE_JUDGE_DAILY_BUDGET_USD> --env IRIS_RELEVANCE_JUDGE_MAX_CALLS_PER_REQUEST=<YOUR_IRIS_RELEVANCE_JUDGE_MAX_CALLS_PER_REQUEST> --env IRIS_RELEVANCE_JUDGE_REDACT=<YOUR_IRIS_RELEVANCE_JUDGE_REDACT> --env IRIS_CITATION_ALLOW_FETCH=<YOUR_IRIS_CITATION_ALLOW_FETCH> --env IRIS_DASHBOARD=<YOUR_IRIS_DASHBOARD> --env IRIS_DASHBOARD_PORT=<YOUR_IRIS_DASHBOARD_PORT> --env IRIS_PORT=<YOUR_IRIS_PORT> --env IRIS_OTEL_ENDPOINT=<YOUR_IRIS_OTEL_ENDPOINT> --env IRIS_CITATION_DOMAINS=<YOUR_IRIS_CITATION_DOMAINS> --env IRIS_CITATION_MAX_COST_USD_TOTAL=<YOUR_IRIS_CITATION_MAX_COST_USD_TOTAL> --env IRIS_TRANSPORT=<YOUR_IRIS_TRANSPORT> --env IRIS_HOST=<YOUR_IRIS_HOST> --env IRIS_ALLOWED_ORIGINS=<YOUR_IRIS_ALLOWED_ORIGINS> --env IRIS_MAX_INPUT_ELEMENTS=<YOUR_IRIS_MAX_INPUT_ELEMENTS> --env IRIS_MAX_TOOL_INPUT_ELEMENTS=<YOUR_IRIS_MAX_TOOL_INPUT_ELEMENTS> --env IRIS_DASHBOARD_HOST=<YOUR_IRIS_DASHBOARD_HOST> --env IRIS_OTEL_HEADERS=<YOUR_IRIS_OTEL_HEADERS> --env IRIS_OTEL_SERVICE_NAME=<YOUR_IRIS_OTEL_SERVICE_NAME> --env IRIS_OTEL_TIMEOUT_MS=<YOUR_IRIS_OTEL_TIMEOUT_MS> --env IRIS_WEBHOOK_URL=<YOUR_IRIS_WEBHOOK_URL> --env IRIS_WEBHOOK_SECRET=<YOUR_IRIS_WEBHOOK_SECRET> -- npx -y @iris-eval/mcp-server@0.21.0
Run this in a terminal to add the server to Claude Code.
What this does
Iris exposes a set of tools to Claude over the Model Context Protocol. After you add it to claude_desktop_config.json (snippet above) and restart Claude Desktop, those tools become callable inside any conversation.
Requirements
This server needs the following environment variables to be set before it can run:
IRIS_API_KEY IRIS_API_KEY_FILE IRIS_ALLOW_UNAUTHENTICATED IRIS_DB_PATH IRIS_SQLITE_DRIVER IRIS_SEARCH_BUDGET_MS IRIS_SEARCH_INDEX IRIS_LOG_LEVEL IRIS_HOME IRIS_ANTHROPIC_API_KEY IRIS_OPENAI_API_KEY IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL IRIS_RELEVANCE_JUDGE_MODEL IRIS_LLM_JUDGE_DAILY_BUDGET_USD IRIS_RELEVANCE_JUDGE_DAILY_BUDGET_USD IRIS_RELEVANCE_JUDGE_MAX_CALLS_PER_REQUEST IRIS_RELEVANCE_JUDGE_REDACT IRIS_CITATION_ALLOW_FETCH IRIS_DASHBOARD IRIS_DASHBOARD_PORT IRIS_PORT IRIS_OTEL_ENDPOINT IRIS_CITATION_DOMAINS IRIS_CITATION_MAX_COST_USD_TOTAL IRIS_TRANSPORT IRIS_HOST IRIS_ALLOWED_ORIGINS IRIS_MAX_INPUT_ELEMENTS IRIS_MAX_TOOL_INPUT_ELEMENTS IRIS_DASHBOARD_HOST IRIS_OTEL_HEADERS IRIS_OTEL_SERVICE_NAME IRIS_OTEL_TIMEOUT_MS IRIS_WEBHOOK_URL IRIS_WEBHOOK_SECRET
Set these via the env object in your MCP config (see claude_desktop_config.json snippet above).
Frequently asked questions
How do I install Iris?
Run the Claude Code command in the install section to add Iris to Claude Code, or copy the ready-made config for your client from the install section on this page. Restart your client afterwards and the tools appear in your next conversation.
Which clients work with Iris?
This page carries setup and config for Claude Code, Claude Desktop, Cursor and VS Code. Any other MCP client that accepts a standard server config can connect to Iris as well.
Does Iris need an API key?
Yes. Before it can run, set these environment variables: IRIS_API_KEY, IRIS_API_KEY_FILE, IRIS_ALLOW_UNAUTHENTICATED, IRIS_DB_PATH, IRIS_SQLITE_DRIVER, IRIS_SEARCH_BUDGET_MS, IRIS_SEARCH_INDEX, IRIS_LOG_LEVEL, IRIS_HOME, IRIS_ANTHROPIC_API_KEY, IRIS_OPENAI_API_KEY, IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL, IRIS_RELEVANCE_JUDGE_MODEL, IRIS_LLM_JUDGE_DAILY_BUDGET_USD, IRIS_RELEVANCE_JUDGE_DAILY_BUDGET_USD, IRIS_RELEVANCE_JUDGE_MAX_CALLS_PER_REQUEST, IRIS_RELEVANCE_JUDGE_REDACT, IRIS_CITATION_ALLOW_FETCH, IRIS_DASHBOARD, IRIS_DASHBOARD_PORT, IRIS_PORT, IRIS_OTEL_ENDPOINT, IRIS_CITATION_DOMAINS, IRIS_CITATION_MAX_COST_USD_TOTAL, IRIS_TRANSPORT, IRIS_HOST, IRIS_ALLOWED_ORIGINS, IRIS_MAX_INPUT_ELEMENTS, IRIS_MAX_TOOL_INPUT_ELEMENTS, IRIS_DASHBOARD_HOST, IRIS_OTEL_HEADERS, IRIS_OTEL_SERVICE_NAME, IRIS_OTEL_TIMEOUT_MS, IRIS_WEBHOOK_URL, IRIS_WEBHOOK_SECRET. They go in the env block of your MCP config.
Imported from the Official MCP Registry. The details above come from the registry entry; the maker can claim this listing to correct them, add docs, and see its traffic.
Is this your MCP server?
Claim this listing to see its traffic, fix details yourself, and skip the review queue on future updates.
Add this badge to your README
Show visitors this server is listed in the ClaudeRules directory. The badge links straight to this listing.
[](https://clauderules.net/mcp/io-github-iris-eval-mcp-server)<a href="https://clauderules.net/mcp/io-github-iris-eval-mcp-server" target="_blank" rel="noopener noreferrer"><img src="https://clauderules.net/api/badge/io-github-iris-eval-mcp-server" alt="Listed on clauderules.net" /></a>More DevTools MCP servers
GitHub
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Serena MCP: the IDE for your agent
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.
Figma-Context-MCP
Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.
Inbox Zero
Search Gmail and Outlook, save drafts, manage email rules, and view email stats.