# covdbg

> covdbg is a freemium MCP server for developer tools. Measure C++ code coverage on Windows from PDBs and find uncovered code, no rebuild. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $12 a month
- **Platforms:** Windows, CLI, vscode
- **Website:** https://covdbg.com/docs/integrations/mcp/
- **Repository:** https://github.com/liasoft/covdbg-mcp
- **MCP Registry name:** com.covdbg/covdbg
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

covdbg behaves like a debugger: it starts an existing executable, reads its PDB and places lightweight probes while it runs, so no recompilation is needed. It handles x64, ARM64 and 32-bit x86 binaries. The MCP server is built into the covdbg executable and started with covdbg mcp, speaking stdio.

The workflow is a loop. The agent reads a guide, discovers executables and coverage databases, starts a run, waits for it, ranks files by uncovered lines and reads the uncovered segments with context. It then edits tests with its own tools and measures again. The server does not write source or tests itself. It can also run read-only SQL over .covdbg databases and merge them.

Runs need Windows, a PDB, a .covdbg.yaml and a sign-in via covdbg login or a project token in CI. Public GitHub Actions repos need no token. Pricing is free for personal and open-source use with one private repository, and $12 per user per month for teams.

## Features

- **No-rebuild coverage:** Probes binaries via their PDBs while they run.
- **Uncovered-code ranking:** Rank files by uncovered lines and read segments.
- **SQL queries:** Run read-only SQL over coverage databases.
- **Merge databases:** Combine coverage across checkouts and builds.
- **Guide tool:** Built-in workflow and configuration topics.
- **CI friendly:** Project token or GitHub Actions identity for public repos.

## Good for

- Have an agent add tests for uncovered Windows C++ code
- Find dead code with SQL against coverage data
- Merge coverage across several test binaries
- Measure coverage improvement after new tests

## Install

### Claude Code (Terminal)

```sh
claude mcp add covdbg --env COVDBG_PROJECT_TOKEN='<COVDBG_PROJECT_TOKEN>' -- npx -y https://github.com/liasoft/covdbg-mcp/releases/download/v1.5.1/covdbg.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "covdbg": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/liasoft/covdbg-mcp/releases/download/v1.5.1/covdbg.mcpb"
      ],
      "env": {
        "COVDBG_PROJECT_TOKEN": "<COVDBG_PROJECT_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "covdbg": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/liasoft/covdbg-mcp/releases/download/v1.5.1/covdbg.mcpb"
      ],
      "env": {
        "COVDBG_PROJECT_TOKEN": "<COVDBG_PROJECT_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "covdbg": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/liasoft/covdbg-mcp/releases/download/v1.5.1/covdbg.mcpb"
      ],
      "env": {
        "COVDBG_PROJECT_TOKEN": "<COVDBG_PROJECT_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "covdbg": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/liasoft/covdbg-mcp/releases/download/v1.5.1/covdbg.mcpb"
      ],
      "env": {
        "COVDBG_PROJECT_TOKEN": "<COVDBG_PROJECT_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "covdbg": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/liasoft/covdbg-mcp/releases/download/v1.5.1/covdbg.mcpb"
      ],
      "env": {
        "COVDBG_PROJECT_TOKEN": "<COVDBG_PROJECT_TOKEN>"
      }
    }
  }
}
```

## Tools

- `guide`: Reads workflow and configuration guidance.
- `discover`: Finds executables and coverage databases.
- `run`: Starts a coverage run.
- `wait_run`: Waits briefly or collects the result.
- `cancel_run`: Terminates a run.
- `open_coverage`: Opens an existing database read-only.
- `files`: Ranks files by uncovered lines.
- `code`: Reads uncovered source with context.
- `query`: Runs one read-only SQL statement.
- `merge`: Combines databases.
- `close`: Releases a session.

## FAQ

### What platform does it need?

Windows x64 or ARM64 with PDB debug symbols.

### What does it cost?

Free for personal use and open source; Team is $12 per user per month.

### Does it edit tests?

No, it supplies measurements and context; the agent edits.

### Does it send my code anywhere?

The pricing page says it never sends source code, file names, paths or coverage data.

### Is covdbg free?

covdbg has a free plan, with paid plans for more usage or features. Paid plans start at $12 a month.

### How do I add covdbg to Claude Code?

Run this command in your terminal: claude mcp add covdbg --env COVDBG_PROJECT_TOKEN='<COVDBG_PROJECT_TOKEN>' -- npx -y https://github.com/liasoft/covdbg-mcp/releases/download/v1.5.1/covdbg.mcpb

### What are the best alternatives to covdbg?

The closest alternatives to covdbg are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/covdbg
