Home / Servers / GitHub API / actions_list_workflow_runs_for_repo

List workflow runs for a repository

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

List workflow runs for a repository Lists all workflow runs for a repository. You can use parameters to narrow the list of results. For more information about using parameters, see Parameters. Anyone with read access to the repository… [GET /repos/{owner}/{repo}/actions/runs]

Name on the gateway: github_api__actions_list_workflow_runs_for_repo · read-only.

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…
actorstringReturns someone's workflow runs. Use the login for the user who created the…
branchstringReturns workflow runs associated with a branch. Use the name of the branch of…
eventstringReturns workflow run triggered by the event you specify. For example, push…
statuscompleted | action_required | cancelled | failure | neutral | skipped | stale | success | timed_out | in_progress | queued | requested | waiting | pendingReturns workflow runs with the check run status or conclusion that you…
per_pageintegerThe number of results per page (max 100). For more information, see "Using…
pageintegerThe page number of the results to fetch. For more information, see "Using…
createdstringReturns workflow runs created within the given date-time range. For more…
exclude_pull_requestsbooleanIf true pull requests are omitted from the response (empty array).
check_suite_idintegerReturns workflow runs with the check_suite_id that you specify.
head_shastringOnly returns workflow runs that are associated with the specified head_sha.

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__actions_list_workflow_runs_for_repo",
  "arguments": {
    "owner": "…",
    "repo": "…"
  }
}

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 list workflow runs for a repository tool with owner set to ….

More from GitHub API