koalr-mcp

Koalr MCP server — connect your engineering metrics, deploy risk scoring, and DORA performance data to Claude, Cursor, Windsurf, and any MCP-compatible AI assistant.

What can it do?

Once connected, ask your AI assistant things like:

"Score PR #847 in our API repo for deployment risk"
"Which open PRs are most likely to cause a production incident?"
"What is our DORA performance tier this month?"
"Show me all PRs open more than 3 days on the backend team"
"How is our AI coding tool adoption trending?"
"What was our MTTR for incidents last quarter?"
"Find developers with the highest PR throughput"
"What is our org-wide test coverage trend?"

Quick Start

1. Get an API Key

Go to app.koalr.com/settings/api-keys, create a key, and copy it. It starts with koalr_.

2. Install in your AI assistant

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "koalr": {
      "command": "npx",
      "args": ["-y", "koalr-mcp@latest"],
      "env": {
        "KOALR_API_KEY": "koalr_your_key_here"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "koalr": {
      "command": "npx",
      "args": ["-y", "koalr-mcp@latest"],
      "env": {
        "KOALR_API_KEY": "koalr_your_key_here"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "koalr": {
      "command": "npx",
      "args": ["-y", "koalr-mcp@latest"],
      "env": {
        "KOALR_API_KEY": "koalr_your_key_here"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add koalr \
  -e KOALR_API_KEY=koalr_your_key_here \
  -- npx -y koalr-mcp@latest

Available Tools

Deploy Risk

Tool	Description
`score_pr_for_deploy_risk`	Score a PR 0–100 for deployment risk using Koalr's 36-signal model. Returns factor breakdown: change entropy, DDL migrations, author expertise, CODEOWNERS violations, and more.

Organization

Tool	Description
`get_org_health`	Overall org health: DORA tier, cycle time, active teams, recent incidents
`get_well_being_summary`	Developer well-being: focus time, meeting load, burnout signals

DORA Metrics

Tool	Description
`get_dora_summary`	Deployment frequency, lead time for changes, change failure rate, MTTR
`get_dora_trend`	DORA trend over time (7d, 14d, 30d, 90d)

Pull Requests

Tool	Description
`get_pr_summary`	PR volume, cycle time, review turnaround for a period
`get_open_prs`	Currently open PRs with age, size, and review status
`get_at_risk_prs`	PRs flagged as at-risk: long open, large, stalled in review

Teams

Tool	Description
`list_teams`	All teams in your org
`get_team`	Team detail: members, DORA performance, recent activity
`list_team_members`	Members of a specific team

Developers

Tool	Description
`get_developer`	Individual developer profile: PR throughput, review activity, cycle time
`list_top_contributors`	Top contributors by PR throughput, reviews, or impact

Repositories

Tool	Description
`list_repositories`	All repos with language, activity, and health status
`get_repository`	Single repo detail: deployment frequency, cycle time, contributors

Incidents

Tool	Description
`list_recent_incidents`	Recent incidents from PagerDuty/OpsGenie with MTTR and severity

Coverage

Tool	Description
`get_coverage_summary`	Test coverage by repository with trend

AI Adoption

Tool	Description
`get_ai_adoption_summary`	GitHub Copilot and Cursor usage metrics
`get_ai_adoption_trend`	AI coding tool adoption trend over time

Search

Tool	Description
`search`	Search developers, repos, PRs, and teams by name

Environment Variables

Variable	Description	Default
`KOALR_API_KEY`	Your Koalr API key (required)	—
`KOALR_API_URL`	API base URL (for self-hosted Koalr)	`https://api.koalr.com`
`MCP_TRANSPORT`	Transport mode: `stdio` or `http`	`stdio`
`PORT`	Port for HTTP transport mode	`3010`

About Koalr

Koalr is an engineering metrics platform for software teams. It tracks DORA metrics, PR health, developer experience, and — uniquely — deployment risk prediction using a 36-signal ML model that scores every PR before it merges.

Koalr