SERVER

Iris

Rank #902

io.github.iris-eval/mcp-server

Stop shipping agents on vibes. Score every agent output for quality, safety, and cost.

31 versions

9 GitHub stars

by iris-eval (1 servers)View repository ↗Claim this server

First listed

Mar 14, 2026

Last publish date

Sep 22, 2026

OVERVIEW

Iris is a Model Context Protocol (MCP) server published by iris-eval. It ranks #902 of 132,345 servers tracked on MCP Toplist, and its repository has 9 GitHub stars. Iris is listed across 4 registries — Official MCP, Glama, PulseMCP and mcp.so, with 31 tracked versions. It was first listed on Mar 14, 2026 and most recently updated on Sep 22, 2026.

STANDING

#902of 132,345 tracked serversTop 1%

Ranks ahead of 131,443 of 132,345 servers on MCP Toplist.

CONNECT

Use Iris

No setupRuns out of the box

No credentials or required configuration declared — add it to your MCP client and go.

npm package

claude mcp add iris-eval -e "IRIS_API_KEY=<your IRIS_API_KEY>" -e "IRIS_API_KEY_FILE=<your IRIS_API_KEY_FILE>" -e "IRIS_ALLOW_UNAUTHENTICATED=<your IRIS_ALLOW_UNAUTHENTICATED>" -e "IRIS_DB_PATH=<your IRIS_DB_PATH>" -e "IRIS_SQLITE_DRIVER=<your IRIS_SQLITE_DRIVER>" -e "IRIS_LOG_LEVEL=<your IRIS_LOG_LEVEL>" -e "IRIS_HOME=<your IRIS_HOME>" -e "IRIS_ANTHROPIC_API_KEY=<your IRIS_ANTHROPIC_API_KEY>" -e "IRIS_OPENAI_API_KEY=<your IRIS_OPENAI_API_KEY>" -e "IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL=<your IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL>" -e "IRIS_CITATION_ALLOW_FETCH=<your IRIS_CITATION_ALLOW_FETCH>" -e "IRIS_DASHBOARD=<your IRIS_DASHBOARD>" -e "IRIS_DASHBOARD_PORT=<your IRIS_DASHBOARD_PORT>" -e "IRIS_PORT=<your IRIS_PORT>" -e "IRIS_OTEL_ENDPOINT=<your IRIS_OTEL_ENDPOINT>" -e "IRIS_CITATION_DOMAINS=<your IRIS_CITATION_DOMAINS>" -e "IRIS_TRANSPORT=<your IRIS_TRANSPORT>" -e "IRIS_HOST=<your IRIS_HOST>" -e "IRIS_ALLOWED_ORIGINS=<your IRIS_ALLOWED_ORIGINS>" -e "IRIS_DASHBOARD_HOST=<your IRIS_DASHBOARD_HOST>" -e "IRIS_OTEL_HEADERS=<your IRIS_OTEL_HEADERS>" -e "IRIS_OTEL_SERVICE_NAME=<your IRIS_OTEL_SERVICE_NAME>" -e "IRIS_OTEL_TIMEOUT_MS=<your IRIS_OTEL_TIMEOUT_MS>" -e "IRIS_WEBHOOK_URL=<your IRIS_WEBHOOK_URL>" -e "IRIS_WEBHOOK_SECRET=<your IRIS_WEBHOOK_SECRET>" -- npx -y @iris-eval/mcp-server

Replace each placeholder with your own value before saving.

npm package

[mcp_servers.iris-eval]
command = "npx"
args = ["-y", "@iris-eval/mcp-server"]

[mcp_servers.iris-eval.env]
IRIS_API_KEY = "<your IRIS_API_KEY>"
IRIS_API_KEY_FILE = "<your IRIS_API_KEY_FILE>"
IRIS_ALLOW_UNAUTHENTICATED = "<your IRIS_ALLOW_UNAUTHENTICATED>"
IRIS_DB_PATH = "<your IRIS_DB_PATH>"
IRIS_SQLITE_DRIVER = "<your IRIS_SQLITE_DRIVER>"
IRIS_LOG_LEVEL = "<your IRIS_LOG_LEVEL>"
IRIS_HOME = "<your IRIS_HOME>"
IRIS_ANTHROPIC_API_KEY = "<your IRIS_ANTHROPIC_API_KEY>"
IRIS_OPENAI_API_KEY = "<your IRIS_OPENAI_API_KEY>"
IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL = "<your IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL>"
IRIS_CITATION_ALLOW_FETCH = "<your IRIS_CITATION_ALLOW_FETCH>"
IRIS_DASHBOARD = "<your IRIS_DASHBOARD>"
IRIS_DASHBOARD_PORT = "<your IRIS_DASHBOARD_PORT>"
IRIS_PORT = "<your IRIS_PORT>"
IRIS_OTEL_ENDPOINT = "<your IRIS_OTEL_ENDPOINT>"
IRIS_CITATION_DOMAINS = "<your IRIS_CITATION_DOMAINS>"
IRIS_TRANSPORT = "<your IRIS_TRANSPORT>"
IRIS_HOST = "<your IRIS_HOST>"
IRIS_ALLOWED_ORIGINS = "<your IRIS_ALLOWED_ORIGINS>"
IRIS_DASHBOARD_HOST = "<your IRIS_DASHBOARD_HOST>"
IRIS_OTEL_HEADERS = "<your IRIS_OTEL_HEADERS>"
IRIS_OTEL_SERVICE_NAME = "<your IRIS_OTEL_SERVICE_NAME>"
IRIS_OTEL_TIMEOUT_MS = "<your IRIS_OTEL_TIMEOUT_MS>"
IRIS_WEBHOOK_URL = "<your IRIS_WEBHOOK_URL>"
IRIS_WEBHOOK_SECRET = "<your IRIS_WEBHOOK_SECRET>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "iris-eval": {
      "command": "npx",
      "args": [
        "-y",
        "@iris-eval/mcp-server"
      ],
      "env": {
        "IRIS_API_KEY": "<your IRIS_API_KEY>",
        "IRIS_API_KEY_FILE": "<your IRIS_API_KEY_FILE>",
        "IRIS_ALLOW_UNAUTHENTICATED": "<your IRIS_ALLOW_UNAUTHENTICATED>",
        "IRIS_DB_PATH": "<your IRIS_DB_PATH>",
        "IRIS_SQLITE_DRIVER": "<your IRIS_SQLITE_DRIVER>",
        "IRIS_LOG_LEVEL": "<your IRIS_LOG_LEVEL>",
        "IRIS_HOME": "<your IRIS_HOME>",
        "IRIS_ANTHROPIC_API_KEY": "<your IRIS_ANTHROPIC_API_KEY>",
        "IRIS_OPENAI_API_KEY": "<your IRIS_OPENAI_API_KEY>",
        "IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL": "<your IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL>",
        "IRIS_CITATION_ALLOW_FETCH": "<your IRIS_CITATION_ALLOW_FETCH>",
        "IRIS_DASHBOARD": "<your IRIS_DASHBOARD>",
        "IRIS_DASHBOARD_PORT": "<your IRIS_DASHBOARD_PORT>",
        "IRIS_PORT": "<your IRIS_PORT>",
        "IRIS_OTEL_ENDPOINT": "<your IRIS_OTEL_ENDPOINT>",
        "IRIS_CITATION_DOMAINS": "<your IRIS_CITATION_DOMAINS>",
        "IRIS_TRANSPORT": "<your IRIS_TRANSPORT>",
        "IRIS_HOST": "<your IRIS_HOST>",
        "IRIS_ALLOWED_ORIGINS": "<your IRIS_ALLOWED_ORIGINS>",
        "IRIS_DASHBOARD_HOST": "<your IRIS_DASHBOARD_HOST>",
        "IRIS_OTEL_HEADERS": "<your IRIS_OTEL_HEADERS>",
        "IRIS_OTEL_SERVICE_NAME": "<your IRIS_OTEL_SERVICE_NAME>",
        "IRIS_OTEL_TIMEOUT_MS": "<your IRIS_OTEL_TIMEOUT_MS>",
        "IRIS_WEBHOOK_URL": "<your IRIS_WEBHOOK_URL>",
        "IRIS_WEBHOOK_SECRET": "<your IRIS_WEBHOOK_SECRET>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "iris-eval": {
      "command": "npx",
      "args": [
        "-y",
        "@iris-eval/mcp-server"
      ],
      "env": {
        "IRIS_API_KEY": "<your IRIS_API_KEY>",
        "IRIS_API_KEY_FILE": "<your IRIS_API_KEY_FILE>",
        "IRIS_ALLOW_UNAUTHENTICATED": "<your IRIS_ALLOW_UNAUTHENTICATED>",
        "IRIS_DB_PATH": "<your IRIS_DB_PATH>",
        "IRIS_SQLITE_DRIVER": "<your IRIS_SQLITE_DRIVER>",
        "IRIS_LOG_LEVEL": "<your IRIS_LOG_LEVEL>",
        "IRIS_HOME": "<your IRIS_HOME>",
        "IRIS_ANTHROPIC_API_KEY": "<your IRIS_ANTHROPIC_API_KEY>",
        "IRIS_OPENAI_API_KEY": "<your IRIS_OPENAI_API_KEY>",
        "IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL": "<your IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL>",
        "IRIS_CITATION_ALLOW_FETCH": "<your IRIS_CITATION_ALLOW_FETCH>",
        "IRIS_DASHBOARD": "<your IRIS_DASHBOARD>",
        "IRIS_DASHBOARD_PORT": "<your IRIS_DASHBOARD_PORT>",
        "IRIS_PORT": "<your IRIS_PORT>",
        "IRIS_OTEL_ENDPOINT": "<your IRIS_OTEL_ENDPOINT>",
        "IRIS_CITATION_DOMAINS": "<your IRIS_CITATION_DOMAINS>",
        "IRIS_TRANSPORT": "<your IRIS_TRANSPORT>",
        "IRIS_HOST": "<your IRIS_HOST>",
        "IRIS_ALLOWED_ORIGINS": "<your IRIS_ALLOWED_ORIGINS>",
        "IRIS_DASHBOARD_HOST": "<your IRIS_DASHBOARD_HOST>",
        "IRIS_OTEL_HEADERS": "<your IRIS_OTEL_HEADERS>",
        "IRIS_OTEL_SERVICE_NAME": "<your IRIS_OTEL_SERVICE_NAME>",
        "IRIS_OTEL_TIMEOUT_MS": "<your IRIS_OTEL_TIMEOUT_MS>",
        "IRIS_WEBHOOK_URL": "<your IRIS_WEBHOOK_URL>",
        "IRIS_WEBHOOK_SECRET": "<your IRIS_WEBHOOK_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

npm package

{
  "servers": {
    "iris-eval": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@iris-eval/mcp-server"
      ],
      "env": {
        "IRIS_API_KEY": "<your IRIS_API_KEY>",
        "IRIS_API_KEY_FILE": "<your IRIS_API_KEY_FILE>",
        "IRIS_ALLOW_UNAUTHENTICATED": "<your IRIS_ALLOW_UNAUTHENTICATED>",
        "IRIS_DB_PATH": "<your IRIS_DB_PATH>",
        "IRIS_SQLITE_DRIVER": "<your IRIS_SQLITE_DRIVER>",
        "IRIS_LOG_LEVEL": "<your IRIS_LOG_LEVEL>",
        "IRIS_HOME": "<your IRIS_HOME>",
        "IRIS_ANTHROPIC_API_KEY": "<your IRIS_ANTHROPIC_API_KEY>",
        "IRIS_OPENAI_API_KEY": "<your IRIS_OPENAI_API_KEY>",
        "IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL": "<your IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL>",
        "IRIS_CITATION_ALLOW_FETCH": "<your IRIS_CITATION_ALLOW_FETCH>",
        "IRIS_DASHBOARD": "<your IRIS_DASHBOARD>",
        "IRIS_DASHBOARD_PORT": "<your IRIS_DASHBOARD_PORT>",
        "IRIS_PORT": "<your IRIS_PORT>",
        "IRIS_OTEL_ENDPOINT": "<your IRIS_OTEL_ENDPOINT>",
        "IRIS_CITATION_DOMAINS": "<your IRIS_CITATION_DOMAINS>",
        "IRIS_TRANSPORT": "<your IRIS_TRANSPORT>",
        "IRIS_HOST": "<your IRIS_HOST>",
        "IRIS_ALLOWED_ORIGINS": "<your IRIS_ALLOWED_ORIGINS>",
        "IRIS_DASHBOARD_HOST": "<your IRIS_DASHBOARD_HOST>",
        "IRIS_OTEL_HEADERS": "<your IRIS_OTEL_HEADERS>",
        "IRIS_OTEL_SERVICE_NAME": "<your IRIS_OTEL_SERVICE_NAME>",
        "IRIS_OTEL_TIMEOUT_MS": "<your IRIS_OTEL_TIMEOUT_MS>",
        "IRIS_WEBHOOK_URL": "<your IRIS_WEBHOOK_URL>",
        "IRIS_WEBHOOK_SECRET": "<your IRIS_WEBHOOK_SECRET>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "iris-eval": {
      "command": "npx",
      "args": [
        "-y",
        "@iris-eval/mcp-server"
      ],
      "env": {
        "IRIS_API_KEY": "<your IRIS_API_KEY>",
        "IRIS_API_KEY_FILE": "<your IRIS_API_KEY_FILE>",
        "IRIS_ALLOW_UNAUTHENTICATED": "<your IRIS_ALLOW_UNAUTHENTICATED>",
        "IRIS_DB_PATH": "<your IRIS_DB_PATH>",
        "IRIS_SQLITE_DRIVER": "<your IRIS_SQLITE_DRIVER>",
        "IRIS_LOG_LEVEL": "<your IRIS_LOG_LEVEL>",
        "IRIS_HOME": "<your IRIS_HOME>",
        "IRIS_ANTHROPIC_API_KEY": "<your IRIS_ANTHROPIC_API_KEY>",
        "IRIS_OPENAI_API_KEY": "<your IRIS_OPENAI_API_KEY>",
        "IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL": "<your IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL>",
        "IRIS_CITATION_ALLOW_FETCH": "<your IRIS_CITATION_ALLOW_FETCH>",
        "IRIS_DASHBOARD": "<your IRIS_DASHBOARD>",
        "IRIS_DASHBOARD_PORT": "<your IRIS_DASHBOARD_PORT>",
        "IRIS_PORT": "<your IRIS_PORT>",
        "IRIS_OTEL_ENDPOINT": "<your IRIS_OTEL_ENDPOINT>",
        "IRIS_CITATION_DOMAINS": "<your IRIS_CITATION_DOMAINS>",
        "IRIS_TRANSPORT": "<your IRIS_TRANSPORT>",
        "IRIS_HOST": "<your IRIS_HOST>",
        "IRIS_ALLOWED_ORIGINS": "<your IRIS_ALLOWED_ORIGINS>",
        "IRIS_DASHBOARD_HOST": "<your IRIS_DASHBOARD_HOST>",
        "IRIS_OTEL_HEADERS": "<your IRIS_OTEL_HEADERS>",
        "IRIS_OTEL_SERVICE_NAME": "<your IRIS_OTEL_SERVICE_NAME>",
        "IRIS_OTEL_TIMEOUT_MS": "<your IRIS_OTEL_TIMEOUT_MS>",
        "IRIS_WEBHOOK_URL": "<your IRIS_WEBHOOK_URL>",
        "IRIS_WEBHOOK_SECRET": "<your IRIS_WEBHOOK_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "iris-eval": {
      "command": "npx",
      "args": [
        "-y",
        "@iris-eval/mcp-server"
      ],
      "env": {
        "IRIS_API_KEY": "<your IRIS_API_KEY>",
        "IRIS_API_KEY_FILE": "<your IRIS_API_KEY_FILE>",
        "IRIS_ALLOW_UNAUTHENTICATED": "<your IRIS_ALLOW_UNAUTHENTICATED>",
        "IRIS_DB_PATH": "<your IRIS_DB_PATH>",
        "IRIS_SQLITE_DRIVER": "<your IRIS_SQLITE_DRIVER>",
        "IRIS_LOG_LEVEL": "<your IRIS_LOG_LEVEL>",
        "IRIS_HOME": "<your IRIS_HOME>",
        "IRIS_ANTHROPIC_API_KEY": "<your IRIS_ANTHROPIC_API_KEY>",
        "IRIS_OPENAI_API_KEY": "<your IRIS_OPENAI_API_KEY>",
        "IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL": "<your IRIS_LLM_JUDGE_MAX_COST_USD_PER_EVAL>",
        "IRIS_CITATION_ALLOW_FETCH": "<your IRIS_CITATION_ALLOW_FETCH>",
        "IRIS_DASHBOARD": "<your IRIS_DASHBOARD>",
        "IRIS_DASHBOARD_PORT": "<your IRIS_DASHBOARD_PORT>",
        "IRIS_PORT": "<your IRIS_PORT>",
        "IRIS_OTEL_ENDPOINT": "<your IRIS_OTEL_ENDPOINT>",
        "IRIS_CITATION_DOMAINS": "<your IRIS_CITATION_DOMAINS>",
        "IRIS_TRANSPORT": "<your IRIS_TRANSPORT>",
        "IRIS_HOST": "<your IRIS_HOST>",
        "IRIS_ALLOWED_ORIGINS": "<your IRIS_ALLOWED_ORIGINS>",
        "IRIS_DASHBOARD_HOST": "<your IRIS_DASHBOARD_HOST>",
        "IRIS_OTEL_HEADERS": "<your IRIS_OTEL_HEADERS>",
        "IRIS_OTEL_SERVICE_NAME": "<your IRIS_OTEL_SERVICE_NAME>",
        "IRIS_OTEL_TIMEOUT_MS": "<your IRIS_OTEL_TIMEOUT_MS>",
        "IRIS_WEBHOOK_URL": "<your IRIS_WEBHOOK_URL>",
        "IRIS_WEBHOOK_SECRET": "<your IRIS_WEBHOOK_SECRET>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/io.github.iris-eval%2Fmcp-server.svg)](https://mcptoplist.com/server/io.github.iris-eval%2Fmcp-server)

HTML

<a href="https://mcptoplist.com/server/io.github.iris-eval%2Fmcp-server"><img src="https://mcptoplist.com/badge/io.github.iris-eval%2Fmcp-server.svg" alt="MCP Toplist: Top 1% of 132,345" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

REGISTRIES

Listed on 4 registries

ORGANIZATION

iris-eval

Organization

iris-eval

Servers in org

Versions across org

VERSIONS

Available versions (31)

Version	Published
0.16.0	Sep 22, 2026
0.15.0	Sep 21, 2026
0.14.0	Sep 20, 2026
0.13.0	Sep 8, 2026
0.12.1	Sep 8, 2026
0.12.0	Sep 7, 2026
0.11.0	Sep 6, 2026
0.10.0	Sep 5, 2026
0.9.0	Sep 5, 2026
0.8.2	Sep 5, 2026
0.8.1	Sep 4, 2026
0.8.0	Sep 4, 2026
0.7.0	Sep 4, 2026
0.6.0	Sep 3, 2026
0.5.1	Sep 3, 2026
0.5.0	Sep 3, 2026
0.4.5	Aug 7, 2026
0.4.4	Jun 12, 2026
0.4.2	May 9, 2026
0.4.0	Apr 24, 2026
0.3.0	Apr 22, 2026
0.2.4	Apr 17, 2026
0.2.3	Apr 17, 2026
0.2.2	Apr 17, 2026
0.2.1	Apr 16, 2026
0.1.8	Mar 26, 2026
0.1.7	Mar 26, 2026
0.1.6	Mar 23, 2026
0.1.4	Mar 20, 2026
0.1.3	Mar 15, 2026
0.1.0	Nov 25, 2024

FAQ

Frequently asked questions

Who maintains Iris?: Iris is maintained by iris-eval, which publishes 1 MCP server (31 total versions) tracked on MCP Toplist.
Is Iris listed on the Official MCP Registry?: Yes — Iris is listed on the Official MCP Registry, alongside Glama, PulseMCP and mcp.so.
How many versions does Iris have?: MCP Toplist tracks 31 versions of Iris, most recently published on Sep 22, 2026.
Where can I find the source code for Iris?: The source code for Iris is hosted at github.com/iris-eval/mcp-server.

Used in projects

Do you run this server?

Add to a project

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Official MCP Servers GitHub MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers