Home / Servers / GitHub API / checks_create

Create a check run

An MCP tool from the GitHub API server, hosted on mcp.hjlabs.in.

Create a check run Creates a new check run for a specific commit in a repository. To create a check run, you must use a GitHub App. OAuth apps and authenticated users are not able to create a check suite. In a check… [POST /repos/{owner}/{repo}/check-runs]

Name on the gateway: github_api__checks_create · may change things.

Parameters

NameTypeDescription
owner requiredstringThe account owner of the repository. The name is not case…
repo requiredstringThe name of the repository without the .git extension. The…
name requiredstringThe name of the check. For example, "code-coverage".
head_sha requiredstringThe SHA of the commit.
details_urlstringThe URL of the integrator's site that has the full details of the check. If…
external_idstringA reference for the run on the integrator's system.
statusqueued | in_progress | completed | waiting | requested | pendingThe current status of the check run. Only GitHub Actions can set a status of…
started_atstringThe time that the check run began. This is a timestamp in ISO 8601 format…
conclusionaction_required | cancelled | failure | neutral | success | skipped | stale | timed_out**Required if you provide completed_at or a status of completed**. The final…
completed_atstringThe time the check completed. This is a timestamp in ISO 8601 format…
outputobjectCheck runs can accept a variety of data in the output object, including a…
actionsarrayDisplays a button on GitHub that can be clicked to alert your app to do…

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:

call_tool arguments
{
  "name": "github_api__checks_create",
  "arguments": {
    "owner": "…",
    "repo": "…",
    "name": "…",
    "head_sha": "…"
  }
}

Or connect the GitHub API server directly, which lists 1,221 tools including this one:

Run in your terminal
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 create a check run tool with owner set to ….

More from GitHub API