Codecov MCP by usefulapi is an MCP server published by io.usefulapi, hosted at codecov.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 24 tools, including codecov_list_service_owners, codecov_get_owner, codecov_list_users, codecov_list_repos, codecov_get_repo.
Read Codecov coverage reports, commits, pulls, flags and components.
3,991 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List owners (organizations/users) the token can see on a git service. Codecov REST: GET /{service}/.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results (1-based). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| pageSize | integer | Number of results per page (maps to `page_size`). |
{
"name": "codecov_list_service_owners",
"title": "List service owners",
"description": "List owners (organizations/users) the token can see on a git service. Codecov REST: GET /{service}/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number for paginated results (1-based)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"pageSize": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results per page (maps to `page_size`)."
}
}
},
"annotations": {
"title": "List service owners",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Get a single owner (org/user) detail. Codecov REST: GET /{service}/{owner_username}/.
| Parameter | Type | Description |
|---|---|---|
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
{
"name": "codecov_get_owner",
"title": "Get owner",
"description": "Get a single owner (org/user) detail. Codecov REST: GET /{service}/{owner_username}/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner"
],
"properties": {
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
}
}
},
"annotations": {
"title": "Get owner",
"readOnlyHint": true
}
}List users belonging to an owner (org), optionally filtered by activation/admin/search. Codecov REST: GET /{service}/{owner_username}/users/.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results (1-based). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| search | string | Free-text search over user name / username. |
| isAdmin | boolean | Filter by admin status (maps to `is_admin`). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| pageSize | integer | Number of results per page (maps to `page_size`). |
| activated | boolean | Filter by whether the user's seat is activated. |
{
"name": "codecov_list_users",
"title": "List users",
"description": "List users belonging to an owner (org), optionally filtered by activation/admin/search. Codecov REST: GET /{service}/{owner_username}/users/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number for paginated results (1-based)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"search": {
"type": "string",
"description": "Free-text search over user name / username."
},
"isAdmin": {
"type": "boolean",
"description": "Filter by admin status (maps to `is_admin`)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"pageSize": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results per page (maps to `page_size`)."
},
"activated": {
"type": "boolean",
"description": "Filter by whether the user's seat is activated."
}
}
},
"annotations": {
"title": "List users",
"readOnlyHint": true
}
}List repositories for an owner, optionally filtered by active state, names or search. Codecov REST: GET /{service}/{owner_username}/repos/.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results (1-based). |
| names | array | Filter to specific repository names (each is sent as a repeated `names` query param). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| active | boolean | Filter to repos that are active (receiving coverage) or not. |
| search | string | Free-text search over repository name. |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| pageSize | integer | Number of results per page (maps to `page_size`). |
{
"name": "codecov_list_repos",
"title": "List repositories",
"description": "List repositories for an owner, optionally filtered by active state, names or search. Codecov REST: GET /{service}/{owner_username}/repos/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number for paginated results (1-based)."
},
"names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter to specific repository names (each is sent as a repeated `names` query param)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"active": {
"type": "boolean",
"description": "Filter to repos that are active (receiving coverage) or not."
},
"search": {
"type": "string",
"description": "Free-text search over repository name."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"pageSize": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results per page (maps to `page_size`)."
}
}
},
"annotations": {
"title": "List repositories",
"readOnlyHint": true
}
}Get a single repository's detail. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/.
| Parameter | Type | Description |
|---|---|---|
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
{
"name": "codecov_get_repo",
"title": "Get repository",
"description": "Get a single repository's detail. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
}
}
},
"annotations": {
"title": "Get repository",
"readOnlyHint": true
}
}Get a repository's Codecov configuration. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/config/.
| Parameter | Type | Description |
|---|---|---|
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
{
"name": "codecov_get_repo_config",
"title": "Get repository config",
"description": "Get a repository's Codecov configuration. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/config/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
}
}
},
"annotations": {
"title": "Get repository config",
"readOnlyHint": true
}
}List a repository's branches, optionally filtered by author and ordering. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/branches/.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results (1-based). |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| author | string | Filter branches by author username. |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| ordering | string | Ordering field, e.g. 'updatestamp' or '-updatestamp'. |
| pageSize | integer | Number of results per page (maps to `page_size`). |
{
"name": "codecov_list_branches",
"title": "List branches",
"description": "List a repository's branches, optionally filtered by author and ordering. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/branches/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number for paginated results (1-based)."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"author": {
"type": "string",
"description": "Filter branches by author username."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"ordering": {
"type": "string",
"description": "Ordering field, e.g. 'updatestamp' or '-updatestamp'."
},
"pageSize": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results per page (maps to `page_size`)."
}
}
},
"annotations": {
"title": "List branches",
"readOnlyHint": true
}
}Get a single branch's detail, including its head commit's coverage totals. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/branches/{name}/.
| Parameter | Type | Description |
|---|---|---|
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| branch * | string | Branch name, e.g. 'main' (required). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
{
"name": "codecov_get_branch",
"title": "Get branch",
"description": "Get a single branch's detail, including its head commit's coverage totals. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/branches/{name}/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo",
"branch"
],
"properties": {
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"branch": {
"type": "string",
"minLength": 1,
"description": "Branch name, e.g. 'main' (required)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
}
}
},
"annotations": {
"title": "Get branch",
"readOnlyHint": true
}
}List a repository's commits, optionally filtered by branch. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/commits/.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results (1-based). |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| branch | string | Filter commits to a branch, e.g. 'main'. |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| pageSize | integer | Number of results per page (maps to `page_size`). |
{
"name": "codecov_list_commits",
"title": "List commits",
"description": "List a repository's commits, optionally filtered by branch. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/commits/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number for paginated results (1-based)."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"branch": {
"type": "string",
"description": "Filter commits to a branch, e.g. 'main'."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"pageSize": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results per page (maps to `page_size`)."
}
}
},
"annotations": {
"title": "List commits",
"readOnlyHint": true
}
}Get a single commit's detail, including its coverage totals and report. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/commits/{commitid}/.
| Parameter | Type | Description |
|---|---|---|
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| commitid * | string | Commit SHA (required). |
{
"name": "codecov_get_commit",
"title": "Get commit",
"description": "Get a single commit's detail, including its coverage totals and report. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/commits/{commitid}/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo",
"commitid"
],
"properties": {
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"commitid": {
"type": "string",
"minLength": 1,
"description": "Commit SHA (required)."
}
}
},
"annotations": {
"title": "Get commit",
"readOnlyHint": true
}
}List the coverage report uploads recorded for a commit. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/commits/{commitid}/uploads/.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results (1-based). |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| commitid * | string | Commit SHA (required). |
| pageSize | integer | Number of results per page (maps to `page_size`). |
{
"name": "codecov_list_commit_uploads",
"title": "List commit uploads",
"description": "List the coverage report uploads recorded for a commit. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/commits/{commitid}/uploads/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo",
"commitid"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number for paginated results (1-based)."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"commitid": {
"type": "string",
"minLength": 1,
"description": "Commit SHA (required)."
},
"pageSize": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results per page (maps to `page_size`)."
}
}
},
"annotations": {
"title": "List commit uploads",
"readOnlyHint": true
}
}List a repository's pull requests, optionally filtered by state and start date. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/pulls/.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results (1-based). |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| state | string | Filter by pull state, e.g. 'open', 'closed' or 'merged'. |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| ordering | string | Ordering field, e.g. 'pullid' or '-pullid'. |
| pageSize | integer | Number of results per page (maps to `page_size`). |
| startDate | string | Only include pulls updated on/after this date, yyyy-mm-dd (maps to `start_date`). |
{
"name": "codecov_list_pulls",
"title": "List pull requests",
"description": "List a repository's pull requests, optionally filtered by state and start date. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/pulls/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number for paginated results (1-based)."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"state": {
"type": "string",
"description": "Filter by pull state, e.g. 'open', 'closed' or 'merged'."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"ordering": {
"type": "string",
"description": "Ordering field, e.g. 'pullid' or '-pullid'."
},
"pageSize": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results per page (maps to `page_size`)."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Only include pulls updated on/after this date, yyyy-mm-dd (maps to `start_date`)."
}
}
},
"annotations": {
"title": "List pull requests",
"readOnlyHint": true
}
}Get a single pull request's detail, including its base/head coverage. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/pulls/{pullid}/.
| Parameter | Type | Description |
|---|---|---|
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| pullid * | string | Pull request number/id (required). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
{
"name": "codecov_get_pull",
"title": "Get pull request",
"description": "Get a single pull request's detail, including its base/head coverage. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/pulls/{pullid}/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo",
"pullid"
],
"properties": {
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"pullid": {
"type": "string",
"minLength": 1,
"description": "Pull request number/id (required)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
}
}
},
"annotations": {
"title": "Get pull request",
"readOnlyHint": true
}
}Coverage totals for a commit (defaults to default branch head), plus per-file totals. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/totals/.
| Parameter | Type | Description |
|---|---|---|
| sha | string | Commit SHA to report on (defaults to the default branch head). |
| flag | string | Restrict totals to a coverage flag. |
| path | string | Restrict totals to a file or directory path prefix. |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| branch | string | Branch whose head to report on. |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| componentId | string | Restrict totals to a component (maps to `component_id`). |
{
"name": "codecov_get_coverage_totals",
"title": "Get coverage totals",
"description": "Coverage totals for a commit (defaults to default branch head), plus per-file totals. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/totals/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo"
],
"properties": {
"sha": {
"type": "string",
"description": "Commit SHA to report on (defaults to the default branch head)."
},
"flag": {
"type": "string",
"description": "Restrict totals to a coverage flag."
},
"path": {
"type": "string",
"description": "Restrict totals to a file or directory path prefix."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"branch": {
"type": "string",
"description": "Branch whose head to report on."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"componentId": {
"type": "string",
"description": "Restrict totals to a component (maps to `component_id`)."
}
}
},
"annotations": {
"title": "Get coverage totals",
"readOnlyHint": true
}
}Full coverage report for a commit (defaults to default branch head) — totals plus per-file line coverage. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/report/.
| Parameter | Type | Description |
|---|---|---|
| sha | string | Commit SHA to report on (defaults to the default branch head). |
| flag | string | Restrict the report to a coverage flag. |
| path | string | Restrict the report to a file or directory path prefix. |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| branch | string | Branch whose head to report on. |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| componentId | string | Restrict the report to a component (maps to `component_id`). |
{
"name": "codecov_get_coverage_report",
"title": "Get coverage report",
"description": "Full coverage report for a commit (defaults to default branch head) — totals plus per-file line coverage. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/report/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo"
],
"properties": {
"sha": {
"type": "string",
"description": "Commit SHA to report on (defaults to the default branch head)."
},
"flag": {
"type": "string",
"description": "Restrict the report to a coverage flag."
},
"path": {
"type": "string",
"description": "Restrict the report to a file or directory path prefix."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"branch": {
"type": "string",
"description": "Branch whose head to report on."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"componentId": {
"type": "string",
"description": "Restrict the report to a component (maps to `component_id`)."
}
}
},
"annotations": {
"title": "Get coverage report",
"readOnlyHint": true
}
}Coverage report as a file/directory tree for a commit (defaults to default branch head). Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/report/tree.
| Parameter | Type | Description |
|---|---|---|
| sha | string | Commit SHA to report on (defaults to the default branch head). |
| flag | string | Restrict the tree to a coverage flag. |
| path | string | Restrict the tree to a directory path prefix. |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| depth | integer | Maximum tree depth to return. |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| branch | string | Branch whose head to report on. |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| componentId | string | Restrict the tree to a component (maps to `component_id`). |
{
"name": "codecov_get_report_tree",
"title": "Get report tree",
"description": "Coverage report as a file/directory tree for a commit (defaults to default branch head). Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/report/tree.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo"
],
"properties": {
"sha": {
"type": "string",
"description": "Commit SHA to report on (defaults to the default branch head)."
},
"flag": {
"type": "string",
"description": "Restrict the tree to a coverage flag."
},
"path": {
"type": "string",
"description": "Restrict the tree to a directory path prefix."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"depth": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Maximum tree depth to return."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"branch": {
"type": "string",
"description": "Branch whose head to report on."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"componentId": {
"type": "string",
"description": "Restrict the tree to a component (maps to `component_id`)."
}
}
},
"annotations": {
"title": "Get report tree",
"readOnlyHint": true
}
}Line-by-line coverage for a single file. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/file_report/{path}/.
| Parameter | Type | Description |
|---|---|---|
| sha | string | Commit SHA to report on (defaults to the default branch head). |
| path * | string | File path within the repo, e.g. 'src/app.ts' (required; slashes are URL-encoded). |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| branch | string | Branch whose head to report on. |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
{
"name": "codecov_get_file_coverage",
"title": "Get file coverage",
"description": "Line-by-line coverage for a single file. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/file_report/{path}/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo",
"path"
],
"properties": {
"sha": {
"type": "string",
"description": "Commit SHA to report on (defaults to the default branch head)."
},
"path": {
"type": "string",
"minLength": 1,
"description": "File path within the repo, e.g. 'src/app.ts' (required; slashes are URL-encoded)."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"branch": {
"type": "string",
"description": "Branch whose head to report on."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
}
}
},
"annotations": {
"title": "Get file coverage",
"readOnlyHint": true
}
}Coverage measurements over time for a repository, bucketed by interval. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/coverage/.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results (1-based). |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| branch | string | Branch to measure (defaults to the default branch). |
| endDate | string | End of the range, yyyy-mm-dd (maps to `end_date`). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| interval | string | Aggregation interval for the trend — '1d', '7d' or '30d'. |
| pageSize | integer | Number of results per page (maps to `page_size`). |
| startDate | string | Start of the range, yyyy-mm-dd (maps to `start_date`). |
{
"name": "codecov_get_coverage_trend",
"title": "Get coverage trend",
"description": "Coverage measurements over time for a repository, bucketed by interval. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/coverage/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number for paginated results (1-based)."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"branch": {
"type": "string",
"description": "Branch to measure (defaults to the default branch)."
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End of the range, yyyy-mm-dd (maps to `end_date`)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"interval": {
"enum": [
"1d",
"7d",
"30d"
],
"type": "string",
"description": "Aggregation interval for the trend — '1d', '7d' or '30d'."
},
"pageSize": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results per page (maps to `page_size`)."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start of the range, yyyy-mm-dd (maps to `start_date`)."
}
}
},
"annotations": {
"title": "Get coverage trend",
"readOnlyHint": true
}
}List a repository's coverage flags. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/flags/.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results (1-based). |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| pageSize | integer | Number of results per page (maps to `page_size`). |
{
"name": "codecov_list_flags",
"title": "List flags",
"description": "List a repository's coverage flags. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/flags/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number for paginated results (1-based)."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"pageSize": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results per page (maps to `page_size`)."
}
}
},
"annotations": {
"title": "List flags",
"readOnlyHint": true
}
}Coverage measurements over time for a single flag, bucketed by interval. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/flags/{flag_name}/coverage/.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results (1-based). |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| branch | string | Branch to measure (defaults to the default branch). |
| endDate | string | End of the range, yyyy-mm-dd (maps to `end_date`). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| interval | string | Aggregation interval for the trend — '1d', '7d' or '30d'. |
| pageSize | integer | Number of results per page (maps to `page_size`). |
| flag_name * | string | Coverage flag name (required). |
| startDate | string | Start of the range, yyyy-mm-dd (maps to `start_date`). |
{
"name": "codecov_get_flag_coverage_trend",
"title": "Get flag coverage trend",
"description": "Coverage measurements over time for a single flag, bucketed by interval. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/flags/{flag_name}/coverage/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo",
"flag_name"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number for paginated results (1-based)."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"branch": {
"type": "string",
"description": "Branch to measure (defaults to the default branch)."
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End of the range, yyyy-mm-dd (maps to `end_date`)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"interval": {
"enum": [
"1d",
"7d",
"30d"
],
"type": "string",
"description": "Aggregation interval for the trend — '1d', '7d' or '30d'."
},
"pageSize": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results per page (maps to `page_size`)."
},
"flag_name": {
"type": "string",
"minLength": 1,
"description": "Coverage flag name (required)."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start of the range, yyyy-mm-dd (maps to `start_date`)."
}
}
},
"annotations": {
"title": "Get flag coverage trend",
"readOnlyHint": true
}
}List a repository's components with their coverage. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/components/.
| Parameter | Type | Description |
|---|---|---|
| sha | string | Commit SHA to report components on. |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| branch | string | Branch to report components on (defaults to the default branch). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
{
"name": "codecov_list_components",
"title": "List components",
"description": "List a repository's components with their coverage. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/components/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo"
],
"properties": {
"sha": {
"type": "string",
"description": "Commit SHA to report components on."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"branch": {
"type": "string",
"description": "Branch to report components on (defaults to the default branch)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
}
}
},
"annotations": {
"title": "List components",
"readOnlyHint": true
}
}Compare coverage between two commits (base vs. head) or for a pull request. Provide EITHER both `base` and `head`, OR `pullid`. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/compare/.
| Parameter | Type | Description |
|---|---|---|
| base | string | Base commit SHA (use together with `head`). |
| head | string | Head commit SHA (use together with `base`). |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| pullid | string | Pull request id to compare (use instead of base/head). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
{
"name": "codecov_compare",
"title": "Compare coverage",
"description": "Compare coverage between two commits (base vs. head) or for a pull request. Provide EITHER both `base` and `head`, OR `pullid`. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/compare/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo"
],
"properties": {
"base": {
"type": "string",
"description": "Base commit SHA (use together with `head`)."
},
"head": {
"type": "string",
"description": "Head commit SHA (use together with `base`)."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"pullid": {
"type": "string",
"description": "Pull request id to compare (use instead of base/head)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
}
}
},
"annotations": {
"title": "Compare coverage",
"readOnlyHint": true
}
}List the files whose coverage changed between two commits (base vs. head) or for a pull request. Provide EITHER both `base` and `head`, OR `pullid`. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/compare/impacted_files.
| Parameter | Type | Description |
|---|---|---|
| base | string | Base commit SHA (use together with `head`). |
| head | string | Head commit SHA (use together with `base`). |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| pullid | string | Pull request id to compare (use instead of base/head). |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
{
"name": "codecov_compare_impacted_files",
"title": "Compare impacted files",
"description": "List the files whose coverage changed between two commits (base vs. head) or for a pull request. Provide EITHER both `base` and `head`, OR `pullid`. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/compare/impacted_files.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo"
],
"properties": {
"base": {
"type": "string",
"description": "Base commit SHA (use together with `head`)."
},
"head": {
"type": "string",
"description": "Head commit SHA (use together with `base`)."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"pullid": {
"type": "string",
"description": "Pull request id to compare (use instead of base/head)."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
}
}
},
"annotations": {
"title": "Compare impacted files",
"readOnlyHint": true
}
}List a repository's test-analytics results, optionally filtered by branch, commit, outcome and duration. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/test-results/.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results (1-based). |
| repo * | string | Repository name, e.g. 'codecov-api' (required). |
| owner * | string | Owner username — the organization or user login on the git service, e.g. 'codecov' (required). |
| branch | string | Filter to a branch, e.g. 'main'. |
| outcome | string | Filter by test outcome — 'pass', 'failure', 'error' or 'skip'. |
| service | string | Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'. |
| commitId | string | Filter to a commit SHA (maps to `commit_id`). |
| pageSize | integer | Number of results per page (maps to `page_size`). |
| durationMax | number | Maximum test duration in seconds (maps to `duration_max`). |
| durationMin | number | Minimum test duration in seconds (maps to `duration_min`). |
{
"name": "codecov_list_test_results",
"title": "List test results",
"description": "List a repository's test-analytics results, optionally filtered by branch, commit, outcome and duration. Codecov REST: GET /{service}/{owner_username}/repos/{repo_name}/test-results/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner",
"repo"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number for paginated results (1-based)."
},
"repo": {
"type": "string",
"minLength": 1,
"description": "Repository name, e.g. 'codecov-api' (required)."
},
"owner": {
"type": "string",
"minLength": 1,
"description": "Owner username — the organization or user login on the git service, e.g. 'codecov' (required)."
},
"branch": {
"type": "string",
"description": "Filter to a branch, e.g. 'main'."
},
"outcome": {
"enum": [
"pass",
"failure",
"error",
"skip"
],
"type": "string",
"description": "Filter by test outcome — 'pass', 'failure', 'error' or 'skip'."
},
"service": {
"enum": [
"github",
"gitlab",
"bitbucket",
"github_enterprise",
"gitlab_enterprise",
"bitbucket_server"
],
"type": "string",
"default": "github",
"description": "Git service provider — one of 'github' (default), 'gitlab', 'bitbucket', 'github_enterprise', 'gitlab_enterprise' or 'bitbucket_server'."
},
"commitId": {
"type": "string",
"description": "Filter to a commit SHA (maps to `commit_id`)."
},
"pageSize": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results per page (maps to `page_size`)."
},
"durationMax": {
"type": "number",
"description": "Maximum test duration in seconds (maps to `duration_max`)."
},
"durationMin": {
"type": "number",
"description": "Minimum test duration in seconds (maps to `duration_min`)."
}
}
},
"annotations": {
"title": "List test results",
"readOnlyHint": true
}
}Tools for Codecov, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "What is the current test coverage on my main repository?"; "Has our coverage gone up or down over the past month?"; "Which files lost coverage in my latest pull request?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Codecov data. Free plan: 50 tool calls per month. Run codecov_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run codecov_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run codecov_upgrade without a plan: it returns both plans, each with a payment link for the user to open. codecov_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.