# Codecov MCP by usefulapi

> Codecov MCP by usefulapi is a freemium MCP server for developer tools. Hosted MCP server that lets AI assistants read Codecov coverage, pulls and test results. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode
- **Website:** https://usefulapi.io/codecov/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/codecov
- **MCP Registry name:** io.usefulapi/codecov
- **Categories:** developer tools
- **Listing updated:** 2026-11-18

## About

The Codecov connector is a remote Model Context Protocol endpoint run by usefulapi, an independent service not affiliated with Codecov. Once connected, an assistant such as Claude or ChatGPT can query coverage totals, commit and branch history, pull request comparisons, flags, components and test analytics from your Codecov account.

Setup is done through a browser login where you supply your Codecov API key; the README says the server uses OAuth so no key goes into client config files. The 24 read-only tools cover reporting, while four meta tools handle usage checks, plan upgrades, cancellation and feature requests.

The server suits engineering leads and developers who want to ask coverage questions in plain language instead of navigating the Codecov dashboard. Free use is capped at 50 tool calls a month, with paid Pro and Pro+ tiers for heavier use.

## Features

- **Coverage totals and reports:** Reads overall and per-file coverage for a commit, defaulting to the default branch head.
- **Pull request comparison:** Lists files whose coverage changed between base and head commits or for a pull request.
- **Coverage trend tracking:** Shows coverage measurements over time, bucketed by an interval you choose, for a repository or flag.
- **Flag and component breakdown:** Lists components and flags with their coverage to find the least tested parts.
- **Test analytics lookup:** Filters test results by branch, commit, outcome and duration and summarizes failures.
- **Read-only data access:** All 24 data tools are marked read-only, so the assistant cannot change Codecov data.

## Good for

- Check the current coverage of a repository's default branch
- Find which files lost coverage in a pull request before merging
- Track whether coverage has risen or fallen over the past month
- Identify the weakest files and their uncovered lines
- Spot slow or failing tests across branches

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http codecov https://codecov.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://codecov.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "codecov": {
      "url": "https://codecov.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "codecov": {
      "type": "http",
      "url": "https://codecov.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "codecov": {
      "serverUrl": "https://codecov.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "codecov": {
      "type": "http",
      "url": "https://codecov.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `codecov_list_service_owners`: List owners (organizations/users) the token can see on a git service.
- `codecov_get_owner`: Get a single owner (org/user) detail.
- `codecov_list_users`: List users belonging to an owner (org), optionally filtered by activation/admin/search.
- `codecov_list_repos`: List repositories for an owner, optionally filtered by active state, names or search.
- `codecov_get_repo`: Get a single repository's detail.
- `codecov_get_repo_config`: Get a repository's Codecov configuration.
- `codecov_list_branches`: List a repository's branches, optionally filtered by author and ordering.
- `codecov_get_branch`: Get a single branch's detail, including its head commit's coverage totals.
- `codecov_list_commits`: List a repository's commits, optionally filtered by branch.
- `codecov_get_commit`: Get a single commit's detail, including its coverage totals and report.
- `codecov_list_commit_uploads`: List the coverage report uploads recorded for a commit.
- `codecov_list_pulls`: List a repository's pull requests, optionally filtered by state and start date.
- `codecov_get_pull`: Get a single pull request's detail, including its base/head coverage.
- `codecov_get_coverage_totals`: Coverage totals for a commit (defaults to default branch head), plus per-file totals.
- `codecov_get_coverage_report`: Full coverage report for a commit, totals plus per-file line coverage.
- `codecov_get_report_tree`: Coverage report as a file/directory tree for a commit.
- `codecov_get_file_coverage`: Line-by-line coverage for a single file.
- `codecov_get_coverage_trend`: Coverage measurements over time for a repository, bucketed by interval.
- `codecov_list_flags`: List a repository's coverage flags.
- `codecov_get_flag_coverage_trend`: Coverage measurements over time for a single flag, bucketed by interval.
- `codecov_list_components`: List a repository's components with their coverage.
- `codecov_compare`: Compare coverage between two commits (base vs. head) or for a pull request.
- `codecov_compare_impacted_files`: List the files whose coverage changed between two commits or for a pull request.
- `codecov_list_test_results`: List a repository's test-analytics results, optionally filtered by branch, commit, outcome and duration.

## FAQ

### Is this an official Codecov product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Codecov, according to its website.

### How do I connect it?

Add the server URL as a custom connector or remote MCP server in your client, then log in with your Codecov API key on the login page.

### Can the AI change my Codecov data?

The website states that all 24 Codecov data tools are read-only.

### What does it cost?

The Free plan allows 50 tool calls a month. Pro is $9/mo or $90/yr with 10,000 calls, and Pro+ is $39/mo or $390/yr with 100,000 calls.

### Is Codecov MCP by usefulapi free?

Codecov MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Codecov MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http codecov https://codecov.usefulapi.io/mcp

### What are the best alternatives to Codecov MCP by usefulapi?

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

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## 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/codecov-mcp-by-usefulapi
