GitHub MCP Server
for AI Agents

Create a new file or update an existing file in a repository

Update the status of a deployment

Submit a code review with comments and approval status

Attach binary files to a release

Create a new repository for the authenticated user

Create a new repository in an organization

Grant team access to a repository

Get jobs within a workflow run (requires run_id from list_workflow_runs)

Retrieve file or directory contents from a repository

Return the authenticated identity and auth type for the current GitHub connection. Wraps GET /user for identity. Maps to the StackOne IAM unified credentials schema (name, auth_type). auth_type is "oauth" for GitHub App connections and "api_key" for Personal Access Token connections.

List the GitHub teams in a single organization, mapped to the IAM unified group schema, cursor-paginated 100 per page. REQUIRES filter.organization_id (the org login). Each entry's id is a composite {org_login, team_slug} so unified_get_group can round-trip to GET /orgs/{org}/teams/{slug}. Type is always "team". Supports nested teams via parent_id (team slug of parent).

Retrieve a single GitHub team by team slug and organization, mapped to the IAM unified group schema. Wraps GET /orgs/{org}/teams/{team_slug}. Requires filter.organization_id (org login) and id (team slug as returned by unified_list_groups).

List the GitHub organizations the authenticated identity belongs to, mapped to the IAM unified organization schema. Wraps GET /user/orgs (paginated, page/per_page). Each entry's id is the org login (e.g. "acme") — the canonical, stable, human-readable identifier referenced by other IAM actions via filter.organization_id.

Retrieve a single GitHub organization by its login (e.g. "acme"), mapped to the IAM unified organization schema. Wraps GET /orgs/{org}. The {id} input must be the org login as returned by unified_list_organizations — passing a numeric org id will return 404. Returns the full profile (name, description, created_at, updated_at, plan).

Return the two stable org-membership IAM roles GitHub exposes ("admin" and "member") synthesized from GitHub's organization membership API. The role set is static, closed, and matches the role IDs embedded in IamUser.roles[] when expand=["roles"] is requested on unified_get_user. Custom Org Roles (GitHub Enterprise Cloud only) are intentionally NOT included.

Retrieve a single synthesized GitHub IAM role by stable key. Only "admin" and "member" are valid — any other id is rejected by input validation with a 400 because GitHub's role namespace is closed at the unified-API surface (Custom Org Roles are GHEC-only and not exposed here).

List the members of a single GitHub organization mapped to the IAM unified user schema, cursor-paginated 100 per page. REQUIRES filter.organization_id (the org login). GitHub has no connection-global user list — users are org-scoped. Each entry's id is the user's login (e.g. "octocat"). Members listing is sparse — call unified_get_user for full profile (name, email, created_at).

Retrieve a single GitHub user by login (e.g. "octocat"), mapped to the IAM unified user schema. Wraps GET /users/{username} for the full profile (name, email, created_at, avatar). Field coverage is fuller than unified_list_users — call this to enrich a member listing.

Retrieve list of organization memberships for the authenticated user

Retrieve list of public organization memberships for a specific user

List all users who are members of an organization

Get membership details for a user in an organization (requires organization member authentication)

List all organization memberships for the authenticated user with state and role details

List Git references in a repository matching a given ref prefix

Retrieve the most recent published release

Retrieve list of repositories for the authenticated user

Retrieve list of public repositories for a specific user

Retrieve list of repositories for an organization

Get all forks of a repository

Get all branches in a repository

Retrieve information about a specific branch

Find code across GitHub repositories

Find repositories matching criteria

Get security vulnerabilities detected by code scanning

Get exposed secrets detected in repository

Get vulnerability alerts for dependencies

Retrieve information about the authenticated user

Delete a file from a repository

Stop a running workflow (requires run_id from list_workflow_runs)

Retry a failed or completed workflow (requires run_id from list_workflow_runs)

Manually trigger a workflow run

Check if a user is a member of an organization (publicly or privately)

Integrate approved changes into the base branch

Create a personal copy of another repository