Home / Servers / GitHub API / git_list_matching_refs

List matching references

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

List matching references Returns an array of references from your Git database that match the supplied name. The :ref in the URL must be formatted as heads/ for branches and tags/ for tags. If the :ref doesn't exist in the… [GET /repos/{owner}/{repo}/git/matching-refs/{ref}]

Name on the gateway: github_api__git_list_matching_refs · 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…
ref requiredstringThe Git reference. For more information, see "Git…

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

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 matching references tool with owner set to ….

More from GitHub API