Github

Fetches core metadata for a repository, including owner, visibility, stars, and default branch.

Inputs:

• oauth_token (object, required) — GitHub token payload { "token": "...", "scopes": ["repo"] }
• owner (string, required) — Repository owner
• repo (string, required) — Repository name

Output:

{
	"ok": true,
	"data": {
		"full_name": "owner/repo",
		"default_branch": "main",
		"private": false
	}
}

usage Example:

POST /mcp/cl-github-mcp-server/get_repo
 
{
	"oauth_token": {"token": "${GITHUB_TOKEN}", "scopes": ["repo"]},
	"owner": "github",
	"repo": "docs"
}

Returns paginated branch metadata for a repository.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• page (integer, optional) — Page number
• perPage (integer, optional) — Items per page

Output:

{
	"ok": true,
	"data": [
		{"name"

Searches repositories by query with sorting and pagination.

Inputs:

• oauth_token (object, required) — GitHub token payload
• query (string, required) — Search query
• sort (string, optional) — stars, forks, updated
• order (string, optional) — asc or desc
• page (integer, optional) — Page number

Performs precise code search using GitHub query syntax.

Inputs:

• oauth_token (object, required) — GitHub token payload
• query (string, required) — Code search query
• sort (string, optional) — indexed
• order (string, optional) — asc or desc
• page (integer, optional) — Page number
• perPage (integer, optional) — Items per page

Output:

Finds users by profile attributes and query filters.

Inputs:

• oauth_token (object, required) — GitHub token payload
• query (string, required) — User search query
• sort (string, optional) — followers, repositories, joined
• order (string, optional) — asc or desc
• page (integer, optional) — Page number
• (integer, optional) — Items per page

Searches issues/PRs globally or scoped to a repository.

Inputs:

• oauth_token (object, required) — GitHub token payload
• query (string, required) — Issue search query
• sort (string, optional) — updated, created, comments
• order (string, optional) — asc or desc
• owner (string, optional) — Repository owner (requires )

Lists commits with optional filters such as author, date range, path, and SHA.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• sha (string, optional) — Branch or commit SHA
• author (string, optional) — Author login
• since (string, optional) — ISO date

Output:

{
	"ok": true

Fetches one commit and optionally includes changed files in the response.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• sha (string, required) — Commit SHA
• include_diff (boolean, optional) — Include file diff data

Output:

{
	"ok": true,
	"data": {
		"sha"

Returns issues with filters for state, labels, and pagination.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• state (string, optional) — open, closed, all
• labels (string, optional) — Comma-separated labels

Output:

Retrieves full metadata for a single issue.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• issue_number (integer, required) — Issue number

Output:

{
	"ok": true,
	"data": {
		"number": 101,
		"title": 

Lists comments on a single issue with pagination support.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• issue_number (integer, required) — Issue number
• page (integer, optional) — Page number
• perPage (integer, optional) — Results per page

Output:

{
	"ok": true

Creates a repository issue with optional body, assignees, labels, and milestone.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• title (string, required) — Issue title
• body (string, optional) — Issue body
• labels (array, optional) — Label names

Output:

{
	"ok": true,

Adds a markdown comment to an issue or pull request.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• issue_number (integer, required) — Issue/PR number
• body (string, required) — Comment body

Output:

{
	"ok": true,
	"data": {"id": 

Updates issue title, body, state, labels, assignees, and milestone.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• issue_number (integer, required) — Issue number
• state (string, optional) — open or closed
• state_reason (string, optional) — completed or

Returns file content or directory listing for a path and ref.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• path (string, optional) — File or directory path
• ref (string, optional) — Branch, tag, or commit SHA

Output:

{
	"ok": true,
	"data": {"type"

Finds organization repositories where one or more contributors have commit history.

Inputs:

• oauth_token (object, required) — GitHub token payload
• org (string, required) — Organization login
• contributor_usernames (string, required) — Comma-separated usernames
• repo_type (string, optional) — all, public, or private

Output:

{

Returns tag names, commit references, and archive URLs.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• page (integer, optional) — Page number
• perPage (integer, optional) — Results per page

Output:

{
	"ok": true,
	"data": {"tags": [{

Fetches metadata for one git tag reference.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• tag (string, required) — Tag name

Output:

{
	"ok": true,
	"data": {"ref": "refs/tags/v1.0.0", "object": {"sha"

Creates a repository in a personal account or organization.

Inputs:

• oauth_token (object, required) — GitHub token payload
• name (string, required) — Repository name
• description (string, optional) — Repository description
• private (boolean, optional) — Private visibility
• org (string, optional) — Organization target

Output:

{
	"ok": true,
	"data": {"id": 

Writes content to a file path, creating or updating with optional SHA protection.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• path (string, required) — File path
• content (string, required) — File content
• message (string, required) — Commit message

Output:

{
	"ok": true

Forks a repository into the authenticated user account or specified organization.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Source owner
• repo (string, required) — Source repository
• org (string, optional) — Destination organization

Output:

{
	"ok": true,
	"data": {"full_name": "my-user/repo", "fork": 

Creates a new branch from a specified SHA or the default branch head.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• branch_name (string, required) — New branch name
• sha (string, optional) — Base commit SHA

Output:

{
	"ok": true,
	"data": {"ref": 

Commits multiple file changes in one tree/commit update operation.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• files_json (string, required) — JSON array of file path/content objects
• message (string, required) — Commit message
• branch (string, optional) — Target branch

Output:

{
	"ok": true

Fetches PR data with method variants for files, status, comments, and review comments.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• pull_number (integer, required) — Pull request number
• method (string, optional) — get, get_files, get_status, get_comments,

Lists pull requests with filter and sorting options.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• state (string, optional) — open, closed, all
• sort (string, optional) — created, updated, ,

Searches pull requests using GitHub search syntax with optional repository scope.

Inputs:

• oauth_token (object, required) — GitHub token payload
• query (string, required) — Search query
• sort (string, optional) — Sort field
• order (string, optional) — asc or desc
• owner (string, optional) — Repository owner
• repo (string, optional) — Repository name

Output:

Creates a PR from head to base with optional draft mode and body.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• title (string, required) — PR title
• head (string, required) — Source branch
• base (string, required) — Target branch

Output:

{
	"ok": true

Updates PR title, body, state, base branch, draft state, and reviewer requests.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• pull_number (integer, required) — Pull request number
• title (string, optional) — Updated title
• state (string, optional) — open or closed

Output:

Merges a PR with merge, squash, or rebase strategy.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• pull_number (integer, required) — Pull request number
• merge_method (string, optional) — merge, squash, rebase

Output:

Updates the PR branch with latest changes from the base branch.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• pull_number (integer, required) — Pull request number
• expected_head_sha (string, optional) — Concurrency guard SHA

Output:

{
	"ok": true,
	"data": {"message"

Creates, submits, and deletes pending reviews, and resolves/unresolves review threads.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• pull_number (integer, required) — Pull request number
• method (string, required) — create, submit_pending, delete_pending, resolve_thread,

Adds a reply to an existing pull request review comment thread.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• pull_number (integer, required) — Pull request number
• comment_id (integer, required) — Comment ID to reply to
• body (string, required) — Reply text

Output:

{
	"ok": 

Returns the latest published release of a repository.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name

Output:

{
	"ok": true,
	"data": {"tag_name": "v2.3.0", "name": "Release 2.3.0", "draft": false

Lists repository releases with pagination.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• page (integer, optional) — Page number
• per_page (integer, optional) — Results per page

Output:

{
	"ok": true,
	"data": {"releases": [{

Fetches one release by tag name.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• tag (string, required) — Tag name

Output:

{
	"ok": true,
	"data": {"tag_name": "v2.3.0", "name": "Release 2.3.0"

Retrieves metadata for a specific repository label.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• name (string, required) — Label name

Output:

{
	"ok": true,
	"data": {"name": "bug", "color": "d73a4a"

Returns identity details for the token owner.

Inputs:

• oauth_token (object, required) — GitHub token payload

Output:

{
	"ok": true,
	"data": {"login": "octocat", "id": 1, "html_url": "https://github.com/octocat"}
}

usage Example:

Adds, removes, or reprioritizes sub-issues for a parent issue.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• issue_number (integer, required) — Parent issue number
• method (string, required) — add, remove, reprioritize
• sub_issue_id (integer, required) — Sub-issue identifier

Output:

Assigns GitHub Copilot coding agent to work on an issue.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• issue_number (integer, required) — Issue number
• base_ref (string, optional) — Branch to start from
• custom_instructions (string, optional) — Extra agent instructions

Output:

{
	"ok": 

Requests an automated Copilot review on a pull request.

Inputs:

• oauth_token (object, required) — GitHub token payload
• owner (string, required) — Repository owner
• repo (string, required) — Repository name
• pull_number (integer, required) — Pull request number

Output:

{
	"ok": true,
	"data": {"pull_number": 8, "status": 

• oauth_token — Structured token object with token and optional scopes list
• owner — GitHub repository owner or organization login
• repo — Repository name
• page / perPage / per_page — Pagination controls used by listing/search tools
• method — Operation selector for multiplexed tools (for example PR read/review operations)

Repository Resource:

owner/repo
Example: github/docs

branch Reference:

refs/heads/{branch_name}
Example: refs/heads/main

issue / Pull Request Number:

integer identifier
Example: 101

file Path Resource:

All tools require GitHub authentication. You can use a GitHub personal access token, or generate OAuth tokens with the included helper script.

Step 1: Create GitHub OAuth App

1. Go to GitHub Developer Settings
2. Open OAuth Apps and click New OAuth App
3. Set Authorization callback URL to http://127.0.0.1:3000/callback

Step 2: Configure Credentials

1. Add credentials to environment variables:
2. GITHUB_CLIENT_ID=...
3. GITHUB_CLIENT_SECRET=...
4. Optional: GITHUB_SCOPES=repo,read:org

Step 3: Authenticate

Run the OAuth helper script from project root:

Missing or Invalid Token

• Cause: oauth_token.token missing or malformed
• Solution:
  1. Provide oauth_token as { "token": "...", "scopes": [...] }
  2. Verify the token is active in GitHub settings
  3. Re-run OAuth flow or generate a new PAT

Missing Scope Error

• Cause: Token does not include required scope (repo in most tools)
• Solution:
  1. Regenerate token with required scopes
  2. Pass the granted scopes list in oauth_token.scopes

• GitHub REST API Documentation — Official GitHub REST API reference
• GitHub OAuth Apps Guide — OAuth setup and authorization flow
• FastMCP Docs — FastMCP framework documentation