Skip to main content
Glama
koalr
by koalr

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.

npm version

Quick Start

Generate an API Key

  1. Go to app.koalr.com/settings/api-keys

  2. Create a new API key with the scopes you need

  3. Copy the key (shown once) — it starts with koalr_

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 your Cursor MCP settings (~/.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

Related MCP server: Tesults MCP

Environment Variables

Variable

Description

Default

KOALR_API_KEY

Your Koalr API key (required). Starts with koalr_.

KOALR_API_URL

Koalr API base URL (for self-hosted or local dev)

http://localhost:3001

MCP_TRANSPORT

Transport mode: stdio (default) or http

stdio

PORT

Port for HTTP transport mode

3010

Available Tools

Deploy Risk

Tool

Description

score_pr_for_deploy_risk

Score a pull request 0–100 using 36 research-validated signals

Organization

Tool

Description

get_org_health

Comprehensive org health: DORA tier, cycle time, teams, incidents

get_well_being_summary

Developer well-being: focus time, meeting load, burnout signals

DORA Metrics

Tool

Description

get_dora_summary

Deploy frequency, lead time, change failure rate, MTTR

get_dora_trend

Weekly trend for any DORA metric

Pull Requests

Tool

Description

get_pr_summary

Cycle time, throughput, review health metrics

get_open_prs

Currently open PRs with age and risk indicators

get_at_risk_prs

PRs at risk of being long-running or blocked

Teams

Tool

Description

list_teams

All teams with IDs and member counts

get_team

Team-level DORA and flow metrics

list_team_members

Team roster with GitHub logins

Repositories

Tool

Description

list_repositories

All repos with health scores

get_repository

Repo metrics: deployment frequency, cycle time, contributors

Developers

Tool

Description

get_developer

Individual developer metrics and recent activity

list_top_contributors

Most active contributors by commits and PRs

Tool

Description

search

Search developers, repos, PRs, and teams by name

Coverage

Tool

Description

get_coverage_summary

Test coverage by repository with trend

Incidents

Tool

Description

list_recent_incidents

Recent incidents from PagerDuty/OpsGenie with MTTR

AI Adoption

Tool

Description

get_ai_adoption_summary

GitHub Copilot and Cursor usage metrics

get_ai_adoption_trend

AI tool adoption trend over time

Example Prompts

Once connected, you can ask your AI agent things like:

  • "What is our team's DORA performance tier this month?"

  • "Show me all PRs that have been open for more than 3 days"

  • "Which developers have the highest PR throughput on the backend team?"

  • "How is our AI coding tool adoption trending?"

  • "What was our MTTR for incidents last quarter?"

  • "Find the auth-service repository and show me its deployment frequency"

HTTP Transport (Remote Hosting)

For hosting the MCP server remotely (e.g., at mcp.koalr.com):

MCP_TRANSPORT=http PORT=3010 KOALR_API_KEY=koalr_... node dist/index.js

The server exposes POST /mcp and GET /mcp endpoints following the MCP Streamable HTTP transport spec.

Local Development

# From repo root
pnpm install
pnpm exec turbo build --filter=koalr-mcp

# Run in stdio mode (test with MCP Inspector)
KOALR_API_KEY=koalr_... node apps/mcp/dist/index.js

# Run in HTTP mode
MCP_TRANSPORT=http KOALR_API_KEY=koalr_... node apps/mcp/dist/index.js
A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    Connects AI coding assistants to Gaffer test history and coverage data to analyze project health, debug failures, and identify untested code areas. It enables tools to track test stability, cluster failures by root cause, and monitor code coverage trends across projects.
    3
    344
    1
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    Connect AI agents to your test results, insights, and targets. Query test runs, failures, flaky tests, and regressions across frameworks including Playwright, Jest, Pytest, Cypress and more.
    37
    MIT
  • A
    license
    -
    quality
    A
    maintenance
    Enables AI agents to query architecture context, data contracts, and blast radius to prevent cross-repo architectural breakage before merging.
    30
    Apache 2.0

View all related MCP servers

Related MCP Connectors

  • Generate answers & visualizations from your engineering data to track software development health.

  • Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

  • BuildPulse CI test analytics for AI agents — flaky tests, coverage, and CI run history.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/koalr/koalr-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server