Home / Servers / GitHub API / checks_list_for_ref
List check runs for a Git reference
An MCP tool from the GitHub API server, hosted on mcp.hjlabs.in.
List check runs for a Git reference Lists check runs for a commit ref. The ref can be a SHA, branch name, or a tag name. > [!NOTE] > The endpoints to manage checks only look for pushes in the repository where the check suite or check… [GET /repos/{owner}/{repo}/commits/{ref}/check-runs]
Name on the gateway: github_api__checks_list_for_ref · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
owner required | string | The account owner of the repository. The name is not case… |
repo required | string | The name of the repository without the .git extension. The… |
ref required | string | The commit reference. Can be a commit SHA, branch name… |
check_name | string | Returns check runs with the specified name. |
status | queued | in_progress | completed | Returns check runs with the specified status. |
filter | latest | all | Filters check runs by their completed_at timestamp. latest returns the most… |
per_page | integer | The number of results per page (max 100). For more information, see "Using… |
page | integer | The page number of the results to fetch. For more information, see "Using… |
app_id | integer | app_id parameter |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "github_api__checks_list_for_ref",
"arguments": {
"owner": "…",
"repo": "…",
"ref": "…"
}
}Or connect the GitHub API server directly, which lists 1,221 tools including this one:
claude mcp add --transport http hj-github-api https://mcp.hjlabs.in/mcp/github-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the list check runs for a git reference tool with owner set to ….