GitHub
io.github.github/github-mcp-server
Verified
Official
Remote HTTP
3 tools changed since you approved them
GitHub sent notifications/tools/list_changed on 12 August. The changed
tools ask before every call until you approve the new versions.
Server
Update available- Publisher
- GitHub, namespace proven by GitHub sign-in
- Version
- 0.14.2 0.15.0 is in the registry
- Repository
github.com/github/github-mcp-server- Endpoint
-
https://api.githubcopilot.com/mcp/ - Transport
- Streamable HTTP, one session per chat
- Protocol
- 2025-11-25
- Capabilities
- tools · listChanged resources prompts logging
- Added
- 3 March 2026 by Priya Raman, for the organisation
Health
A ping every five minutes, and every real call timed.
- Last checked
- , 142 ms
- Median, 24 hours
- 156 ms
- 95th percentile
- 412 ms
- Errors, 24 hours
- 4 of 1,026 calls (0.4%)
- Uptime, 30 days
- 99.94%
Most used, last 7 days
Tools nobody calls still cost budget in every prompt.
get_file_contents
2,310 calls
list_issues
1,104 calls
create_issue
212 calls, 9 denied
create_branch
0 calls
Unused for 30 days. Blocking it frees budget for the tools people call.
Default for new tools
Applies when the server announces a tool nobody has reviewed yet.
Groups are as declared by the server
Read-only, write and destructive come from the tool annotations
(readOnlyHint, destructiveHint), which anyone
running a server can set. Treat them as a hint for sorting, never as proof
that a tool is safe. A tool whose description or schema changes goes back
to Ask until somebody approves it.
Read-only 6
The server marks these readOnlyHint: true.
-
get_meDetails of the GitHub account the connector is signed in as.
Reads only{ "type": "object", "properties": {}, "required": [] } -
get_file_contentsContents of a file or directory in a repository.
Reads only Open world{ "type": "object", "properties": { "owner": { "type": "string", "description": "Repository owner" }, "repo": { "type": "string", "description": "Repository name" }, "path": { "type": "string", "description": "Path to the file or directory" }, "ref": { "type": "string", "description": "Branch, tag or commit SHA" } }, "required": [ "owner", "repo", "path" ] } -
list_issuesIssues in a repository, filtered by state, labels and date.
Reads only Open world{ "type": "object", "properties": { "owner": { "type": "string", "description": "Repository owner" }, "repo": { "type": "string", "description": "Repository name" }, "state": { "type": "string", "enum": [ "open", "closed", "all" ] }, "labels": { "type": "array", "items": { "type": "string" } } }, "required": [ "owner", "repo" ] } -
search_codeChangedSearch code across every repository the account can read, including private ones.
Reads only Open world{ "type": "object", "properties": { "query": { "type": "string", "description": "GitHub code search syntax" }, "perPage": { "type": "integer", "description": "Results per page, up to 100" }, "page": { "type": "integer", "description": "Page number" } }, "required": [ "query" ] } -
list_pull_requestsPull requests in a repository, by state, base and head branch.
Reads only Open world{ "type": "object", "properties": { "owner": { "type": "string", "description": "Repository owner" }, "repo": { "type": "string", "description": "Repository name" }, "state": { "type": "string", "enum": [ "open", "closed", "all" ] } }, "required": [ "owner", "repo" ] } -
search_repositoriesSearch public and private repositories by name, topic and language.
Reads only Open world{ "type": "object", "properties": { "query": { "type": "string", "description": "Repository search syntax" }, "page": { "type": "integer", "description": "Page number" } }, "required": [ "query" ] }
Write 5
Not read-only, and not marked destructive.
-
create_issueChangedOpen a new issue in a repository, with labels and assignees.
Open world{ "type": "object", "properties": { "owner": { "type": "string", "description": "Repository owner" }, "repo": { "type": "string", "description": "Repository name" }, "title": { "type": "string", "description": "Issue title" }, "body": { "type": "string", "description": "Issue body in Markdown" }, "labels": { "type": "array", "items": { "type": "string" } }, "assignees": { "type": "array", "items": { "type": "string" } } }, "required": [ "owner", "repo", "title" ] } -
add_issue_commentAdd a comment to an issue or pull request.
Open world{ "type": "object", "properties": { "owner": { "type": "string", "description": "Repository owner" }, "repo": { "type": "string", "description": "Repository name" }, "issue_number": { "type": "integer", "description": "Issue or pull request number" }, "body": { "type": "string", "description": "Comment in Markdown" } }, "required": [ "owner", "repo", "issue_number", "body" ] } -
create_pull_requestOpen a pull request from a head branch into a base branch.
Open world{ "type": "object", "properties": { "owner": { "type": "string", "description": "Repository owner" }, "repo": { "type": "string", "description": "Repository name" }, "title": { "type": "string", "description": "Title" }, "head": { "type": "string", "description": "Branch with the changes" }, "base": { "type": "string", "description": "Branch to merge into" }, "draft": { "type": "boolean" } }, "required": [ "owner", "repo", "title", "head", "base" ] } -
create_branchCreate a branch from an existing one.
Idempotent Open world{ "type": "object", "properties": { "owner": { "type": "string", "description": "Repository owner" }, "repo": { "type": "string", "description": "Repository name" }, "branch": { "type": "string", "description": "New branch name" }, "from_branch": { "type": "string", "description": "Source branch" } }, "required": [ "owner", "repo", "branch" ] } -
push_filesCommit several files to a branch in one push.
Open world{ "type": "object", "properties": { "owner": { "type": "string", "description": "Repository owner" }, "repo": { "type": "string", "description": "Repository name" }, "branch": { "type": "string", "description": "Branch to push to" }, "files": { "type": "array", "items": { "type": "object" } }, "message": { "type": "string", "description": "Commit message" } }, "required": [ "owner", "repo", "branch", "files", "message" ] }
Destructive 3
The server marks these destructiveHint: true.
-
merge_pull_requestChangedMerge a pull request into its base branch.
Destructive Open world{ "type": "object", "properties": { "owner": { "type": "string", "description": "Repository owner" }, "repo": { "type": "string", "description": "Repository name" }, "pullNumber": { "type": "integer", "description": "Pull request number" }, "merge_method": { "type": "string", "enum": [ "merge", "squash", "rebase" ] }, "delete_branch": { "type": "boolean", "default": true } }, "required": [ "owner", "repo", "pullNumber" ] } -
delete_workflow_run_logsDelete the logs of a GitHub Actions workflow run.
Destructive Idempotent Open world{ "type": "object", "properties": { "owner": { "type": "string", "description": "Repository owner" }, "repo": { "type": "string", "description": "Repository name" }, "run_id": { "type": "integer", "description": "Workflow run ID" } }, "required": [ "owner", "repo", "run_id" ] } -
delete_fileDelete a file from a branch with a commit.
Destructive Open worldBlock · Set by admin
{ "type": "object", "properties": { "owner": { "type": "string", "description": "Repository owner" }, "repo": { "type": "string", "description": "Repository name" }, "path": { "type": "string", "description": "Path to the file" }, "branch": { "type": "string", "description": "Branch" }, "message": { "type": "string", "description": "Commit message" } }, "required": [ "owner", "repo", "path", "branch", "message" ] }
Resource templates
Content an assistant can attach to a chat by address, without calling a tool.
| Template | What it returns | Type | Readable |
|---|---|---|---|
repo://{owner}/{repo}/contents{/path*} |
A file or directory on the default branch | Varies by file | |
repo://{owner}/{repo}/refs/heads/{branch}/contents{/path*} |
A file or directory on a named branch | Varies by file | |
repo://{owner}/{repo}/sha/{sha}/contents{/path*} |
A file or directory at one commit | Varies by file | |
repo://{owner}/{repo}/refs/pull/{prNumber}/head/contents{/path*} |
A file as it is in an open pull request | Varies by file |
Prompts
Templates the server offers. People pick them; assistants never run them on their own.
-
issue_to_fix_workflowTurn an issue into a branch, a fix and a draft pull request. Arguments:
owner,repo,issue_number. -
summarise_pull_requestWhat changed, what is risky and what to test. Arguments:
owner,repo,pullNumber.
OAuth sign-in
OAuth 2.1 with PKCE, discovered from the server.
- Signed in as
- priya-raman, by Priya Raman
- Authorisation server
https://github.com/login/oauth- Resource metadata
https://api.githubcopilot.com/.well-known/oauth-protected-resource/mcp- Resource indicator
https://api.githubcopilot.com/mcp/Tokens are bound to this server only (RFC 8707)- Code challenge
- S256 Supported
- Access token
- Expires in 7 hours Refreshed automatically, refresh token rotates on use
Scopes
Requested from the server's 401 challenge, against what you granted.
| Scope | Requested | Granted |
|---|---|---|
repo | At sign-in | Granted |
read:org | At sign-in | Granted |
read:user | At sign-in | Granted |
notifications | At sign-in | Granted |
gist | At sign-in | Granted |
workflow |
Step-up, 403 insufficient_scope |
Not granted Asked for when a tool first needs it |
Service key
For scheduled agents, which cannot complete a browser sign-in. Sent as the
Authorization header; only the last four characters are stored in view.
- Fine-grained token
-
- Expires
- 2 November 2026
- Last used
- by the nightly triage agent
| Arguments | ||||||
|---|---|---|---|---|---|---|
get_file_contents |
Priya Raman | {"owner":"northwind","repo":"checkout-web","path":"src/pay.ts"} |
Success | 131 ms | Allowed by policy | |
create_issue |
Priya Raman | {"owner":"northwind","repo":"checkout-web","title":"Pay button unresponsive on Safari 17.5","labels":["bug","p1"]} |
Success | 402 ms | Approved by person | |
list_issues |
Sam Okafor | {"owner":"northwind","repo":"api","state":"open","labels":["incident"]} |
Success | 188 ms | Allowed by policy | |
merge_pull_request |
Sam Okafor | {"owner":"northwind","repo":"api","pullNumber":1482,"merge_method":"squash"} |
Not run | None | Denied by person | |
delete_file |
Nightly triage agent | {"owner":"northwind","repo":"infra","path":"terraform/prod.tfvars","message":"[redacted]"} |
Not run | None | Blocked by policy | |
search_code |
Nightly triage agent | {"query":"AKIA org:northwind","perPage":50} |
Success | 920 ms | Approved by person | |
add_issue_comment |
Amara Okafor | {"owner":"northwind","repo":"web","issue_number":311,"body":"Reproduced on staging."} |
Success | 264 ms | Allowed by policy | |
create_pull_request |
Lars Nyberg | {"owner":"northwind","repo":"infra","title":"Raise worker memory to 2 GB","head":"lars/worker-mem","base":"main"} |
Not run | None | Denied by person | |
get_file_contents |
Lars Nyberg | {"owner":"northwind","repo":"infra","path":".env.production"} |
Error: 404 Not Found | 87 ms | Allowed by policy | |
get_me |
Amara Okafor | {} |
Success | 95 ms | Allowed by policy |
No calls match
Try another search, or clear the decision filter.
Values of fields the server marks secret, and anything that looks like a token or a
password, are stored as [redacted]. Calls are kept for 90 days.
Headers from server.json
Declared by the publisher in the registry entry. Secret values are never shown in full.
Authorization Secret Required
Filled in by the OAuth sign-in. Change it on the Authentication tab.
Optional. Fewer toolsets means fewer tools in every prompt.
Optional. true makes the server hide every write tool itself.
Limits
Who can use it
Roles that see GitHub's tools in their chats. Owners always can.
-
Admin
Workspace administrators.
-
Member
Everyone on the engineering team.
-
Billing
Finance staff. They rarely need source code.
-
Viewer
Read-only seats. Write tools stay hidden whatever the policy says.
Remove this connector
For everyone in the organisation
Its tools disappear from every chat, the sign-in and the service key are revoked, and the policies you set here are deleted. The activity log stays for 90 days. Nothing in GitHub is changed.