github_search

github_search is a focused tool for querying GitHub activity. It searches for pull requests or commits by author within a date range and returns only the essential fields — no pagination tokens, no nested objects, no raw API noise. Unlike calling the GitHub API through fetch_external, this tool handles query construction, header setup (commits search requires a special Accept header), and response shaping automatically.

Prerequisites

GITHUB_TOKEN must be set in your environment
api.github.com must be in PROXY_ALLOWED_DOMAINS

The token must be configured for injection in FETCH_EXTERNAL_TOKEN_MAP:

PROXY_ALLOWED_DOMAINS=api.github.com
FETCH_EXTERNAL_TOKEN_MAP={"api.github.com":"GITHUB_TOKEN"}
GITHUB_TOKEN=ghp_xxxxxxxxxxxx

Parameters

string

required

What to search for. Must be either "prs" (pull requests) or "commits".

string

required

Repository in owner/repo format (e.g. "thezem/reacher").

string

required

GitHub username to filter by (e.g. "thezem").

string

required

ISO date string. Returns items created on or after this date (e.g. "2026-03-01"). For commits this filters by committer date.

number

Number of results to return. Min 1, max 100. Defaults to 25.

Return value

boolean

true on a successful GitHub API response.

array

Array of result objects. Shape depends on type.

Show PR fields (type: prs)

number

Pull request number.

string

PR title.

string

HTML URL to the PR on GitHub.

string

"open" or "closed".

boolean

Whether the PR is a draft.

boolean

Whether the PR has been merged.

string

ISO date (date portion only, e.g. "2026-03-10").

Show Commit fields (type: commits)

string

Short SHA (first 7 characters).

string

First line of the commit message only.

string

ISO date of the commit (date portion only, e.g. "2026-03-10").

string

HTML URL to the commit on GitHub.

Usage examples

{
  "type": "prs",
  "repo": "thezem/reacher",
  "author": "thezem",
  "created_after": "2026-01-01"
}

{
  "type": "prs",
  "repo": "thezem/reacher",
  "author": "thezem",
  "created_after": "2026-03-01",
  "per_page": 10
}

{
  "type": "commits",
  "repo": "thezem/reacher",
  "author": "thezem",
  "created_after": "2026-03-10"
}

Example output

{
  "success": true,
  "items": [
    {
      "number": 42,
      "title": "Add browser tool with CDP support",
      "url": "https://github.com/thezem/reacher/pull/42",
      "state": "closed",
      "draft": false,
      "merged": true,
      "created_at": "2026-03-12"
    }
  ]
}

{
  "success": true,
  "items": [
    {
      "sha": "a1b2c3d",
      "message": "fix: handle CDP connection timeout gracefully",
      "date": "2026-03-15",
      "url": "https://github.com/thezem/reacher/commit/a1b2c3d"
    }
  ]
}

The GitHub commits search API requires the Accept: application/vnd.github.cloak-preview header. This is handled automatically by the tool — you don’t need to pass it.

Get Started

Configuration

Tools

Deployment

Operations

Extending

Prerequisites

Parameters

Return value

Usage examples

Example output