# koalr-mcp

Koalr — Deployment Intelligence MCP Server

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add koalr/koalr-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list koalr/koalr-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get koalr/koalr-mcp dora.summary

# Call a tool
npx -y @smithery/cli@latest tool call koalr/koalr-mcp dora.summary '{}'
```

## Direct MCP Connection

Endpoint: `https://koalr-mcp--koalr.run.tools`

**Required config:**
- `apiKey` (query) — Your Koalr API key. Generate one at app.koalr.com/settings/api-keys — starts with koalr_

## Tools (20)

- `dora.summary` — Get DORA metrics (deploy frequency, lead time for changes, change failure rate, MTTR) for the organization or a specifi…
- `dora.trend` — Get DORA metric trend over time to see how deployment frequency, lead time, change failure rate, or MTTR has changed we…
- `pr.summary` — Get pull request metrics including cycle time (time from first commit to merge), throughput (PRs merged per week), revi…
- `pr.open` — List currently open pull requests with their age in hours, size (additions + deletions), and reviewer assignments. Use …
- `pr.at_risk` — Get pull requests at risk of becoming long-running or blocked. These are PRs that have been open for more than 3 days, …
- `teams.list` — List all engineering teams in the organization with their member counts and slugs. Use this to discover team IDs needed…
- `teams.get` — Get details and metrics for a specific team including DORA performance, cycle time, and member count. Use this when ask…
- `teams.members` — List all members of a specific team with their GitHub logins and roles. Use this to understand team composition or find…
- `repos.list` — List all repositories connected to Koalr with their health scores, activity levels, and basic stats. Use this to get an…
- `repos.get` — Get detailed metrics for a specific repository including deployment frequency, PR cycle time, contributor count, and co…
- `developers.get` — Get metrics for an individual developer including their PR throughput, review activity, average cycle time, and code co…
- `developers.top` — List the most active contributors ranked by commits and PRs merged over a time window. Use this to identify key contrib…
- `search` — Search across all Koalr entities: developers (by name or GitHub login), repositories (by name), pull requests (by title…
- `coverage.summary` — Get test coverage summary per repository showing overall coverage percentage, lines covered, and coverage trend. Use th…
- `incidents.list` — List recent production incidents from PagerDuty or OpsGenie with their severity, MTTR (mean time to recovery), and affe…
- `ai.summary` — Get AI coding tool adoption metrics including GitHub Copilot acceptance rate, Cursor active users, AI-generated code pe…
- `ai.trend` — Get the trend of AI tool adoption over time showing weekly active users, acceptance rates, and code attribution percent…
- `org.health` — Get a comprehensive organization health snapshot: DORA performance tier (Elite/High/Medium/Low), cycle time percentile …
- `org.wellbeing` — Get team well-being scores across pillars: focus time (uninterrupted deep work hours), meeting load (percentage of time…
- `risk.score` — Score a specific pull request for deployment risk using Koalr's 36-signal model. Returns a 0–100 risk score with a deta…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get koalr/koalr-mcp <tool-name>
```

## Prompts (5)

- `koalr-quickstart` — A prompt that gives your agent an overview of what the Koalr MCP server can do and example queries to get started inves…
- `koalr-deploy-risk` (owner, repo, prNumber) — A workflow prompt that guides your agent through assessing the deployment risk of a pull request using Koalr risk.score.
- `koalr-dora-review` (teamId, days) — A workflow prompt for running a complete DORA metrics performance review across the org or a specific team, including t…
- `koalr-incident-investigation` (days) — A workflow prompt that guides your agent through investigating a production incident by correlating it with deploy acti…
- `koalr-team-health-check` (teamId, teamName) — A workflow prompt for running a complete health check on a specific team — covering delivery metrics, well-being, at-ri…