Skip to content
Gemini CLI

Iris for Gemini CLI

io.github.iris-eval/mcp-server

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

client:Gemini CLI transport:stdio runtime:npm

Install Iris in Gemini CLI

~/.gemini/settings.json · windows: %USERPROFILE%\.gemini\settings.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

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

Gemini expands $VAR and ${VAR} inside env values, so a secret can live in your shell rather than this file. Gemini CLI docs

Iris in other clients