0.6.3npm · improved-github-mcp · current release
Observed 2026-08-18T00:50:20.747Z using mcpSecurity-inventory. Status: succeeded. Negotiated protocol: 2024-11-05.
{
"tools": {}
}| Tool | Category | Annotations | Risk |
|---|---|---|---|
add_issue_commentAdd a comment to an existing issueInput schema{
"type": "object",
"properties": {
"owner": {
"type": "string"
},
"repo": {
"type": "string"
},
"issue_number": {
"type": "number"
},
"body": {
"type": "string"
}
},
"required": [
"owner",
"repo",
"issue_number",
"body"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
create_branchCreate a new branch in a GitHub repositoryInput schema{
"type": "object",
"properties": {
"owner": {
"type": "string",
"description": "Repository owner (username or organization)"
},
"repo": {
"type": "string",
"description": "Repository name"
},
"branch": {
"type": "string",
"description": "Name for the new branch"
},
"from_branch": {
"type": "string",
"description": "Optional: source branch to create from (defaults to the repository's default branch)"
}
},
"required": [
"owner",
"repo",
"branch"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
create_issueCreate a new issue in a GitHub repositoryInput schema{
"type": "object",
"properties": {
"owner": {
"type": "string"
},
"repo": {
"type": "string"
},
"title": {
"type": "string"
},
"body": {
"type": "string"
},
"assignees": {
"type": "array",
"items": {
"type": "string"
}
},
"milestone": {
"type": "number"
},
"labels": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"owner",
"repo",
"title"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
create_or_update_fileCreate or update a single file in a GitHub repositoryInput schema{
"type": "object",
"properties": {
"owner": {
"type": "string",
"description": "Repository owner (username or organization)"
},
"repo": {
"type": "string",
"description": "Repository name"
},
"path": {
"type": "string",
"description": "Path where to create/update the file"
},
"content": {
"type": "string",
"description": "Content of the file"
},
"message": {
"type": "string",
"description": "Commit message"
},
"branch": {
"type": "string",
"description": "Branch to create/update the file in"
},
"sha": {
"type": "string",
"description": "SHA of the file being replaced (required when updating existing files)"
}
},
"required": [
"owner",
"repo",
"path",
"content",
"message",
"branch"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
create_pull_requestCreate a new pull request in a GitHub repositoryInput schema{
"type": "object",
"properties": {
"owner": {
"type": "string",
"description": "Repository owner (username or organization)"
},
"repo": {
"type": "string",
"description": "Repository name"
},
"title": {
"type": "string",
"description": "Pull request title"
},
"body": {
"type": "string",
"description": "Pull request body/description"
},
"head": {
"type": "string",
"description": "The name of the branch where your changes are implemented"
},
"base": {
"type": "string",
"description": "The name of the branch you want the changes pulled into"
},
"draft": {
"type": "boolean",
"description": "Whether to create the pull request as a draft"
},
"maintainer_can_modify": {
"type": "boolean",
"description": "Whether maintainers can modify the pull request"
}
},
"required": [
"owner",
"repo",
"title",
"head",
"base"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
create_repositoryCreate a new GitHub repository in your accountInput schema{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Repository name"
},
"description": {
"type": "string",
"description": "Repository description"
},
"private": {
"type": "boolean",
"description": "Whether the repository should be private"
},
"autoInit": {
"type": "boolean",
"description": "Initialize with README.md"
}
},
"required": [
"name"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
fork_repositoryFork a GitHub repository to your account or specified organizationInput schema{
"type": "object",
"properties": {
"owner": {
"type": "string",
"description": "Repository owner (username or organization)"
},
"repo": {
"type": "string",
"description": "Repository name"
},
"organization": {
"type": "string",
"description": "Optional: organization to fork to (defaults to your personal account)"
}
},
"required": [
"owner",
"repo"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
get_file_contentsGet the contents of a file or directory from a GitHub repositoryInput schema{
"type": "object",
"properties": {
"owner": {
"type": "string",
"description": "Repository owner (username or organization)"
},
"repo": {
"type": "string",
"description": "Repository name"
},
"path": {
"type": "string",
"description": "Path to the file or directory"
},
"branch": {
"type": "string",
"description": "Branch to get contents from"
}
},
"required": [
"owner",
"repo",
"path"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
get_issueGet details of a specific issue in a GitHub repository.Input schema{
"type": "object",
"properties": {
"owner": {
"type": "string"
},
"repo": {
"type": "string"
},
"issue_number": {
"type": "number"
}
},
"required": [
"owner",
"repo",
"issue_number"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
list_commitsGet list of commits of a branch in a GitHub repositoryInput schema{
"type": "object",
"properties": {
"owner": {
"type": "string"
},
"repo": {
"type": "string"
},
"sha": {
"type": "string"
},
"page": {
"type": "number"
},
"perPage": {
"type": "number"
}
},
"required": [
"owner",
"repo"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
list_issuesList issues in a GitHub repository with filtering optionsInput schema{
"type": "object",
"properties": {
"owner": {
"type": "string"
},
"repo": {
"type": "string"
},
"direction": {
"type": "string",
"enum": [
"asc",
"desc"
]
},
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"since": {
"type": "string"
},
"sort": {
"type": "string",
"enum": [
"created",
"updated",
"comments"
]
},
"state": {
"type": "string",
"enum": [
"open",
"closed",
"all"
]
}
},
"required": [
"owner",
"repo"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
push_files_contentPush multiple files with direct content to a GitHub repository in a single commitInput schema{
"type": "object",
"properties": {
"owner": {
"type": "string",
"description": "Repository owner (username or organization)"
},
"repo": {
"type": "string",
"description": "Repository name"
},
"branch": {
"type": "string",
"description": "Branch to push to (e.g., 'main' or 'master')"
},
"files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"content": {
"type": "string"
}
},
"required": [
"path",
"content"
],
"additionalProperties": false
},
"description": "Array of files to push with their content"
},
"message": {
"type": "string",
"description": "Commit message"
}
},
"required": [
"owner",
"repo",
"branch",
"files",
"message"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
push_files_from_pathPush multiple files from filesystem paths to a GitHub repository in a single commitInput schema{
"type": "object",
"properties": {
"owner": {
"type": "string",
"description": "Repository owner (username or organization)"
},
"repo": {
"type": "string",
"description": "Repository name"
},
"branch": {
"type": "string",
"description": "Branch to push to (e.g., 'main' or 'master')"
},
"files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"filepath": {
"type": "string"
}
},
"required": [
"path",
"filepath"
],
"additionalProperties": false
},
"description": "Array of files to push from filesystem paths"
},
"message": {
"type": "string",
"description": "Commit message"
}
},
"required": [
"owner",
"repo",
"branch",
"files",
"message"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
search_codeSearch for code across GitHub repositoriesInput schema{
"type": "object",
"properties": {
"q": {
"type": "string"
},
"order": {
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"type": "number",
"minimum": 1
},
"per_page": {
"type": "number",
"minimum": 1,
"maximum": 100
}
},
"required": [
"q"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
search_issuesSearch for issues and pull requests across GitHub repositoriesInput schema{
"type": "object",
"properties": {
"q": {
"type": "string"
},
"order": {
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"type": "number",
"minimum": 1
},
"per_page": {
"type": "number",
"minimum": 1,
"maximum": 100
},
"sort": {
"type": "string",
"enum": [
"comments",
"reactions",
"reactions-+1",
"reactions--1",
"reactions-smile",
"reactions-thinking_face",
"reactions-heart",
"reactions-tada",
"interactions",
"created",
"updated"
]
}
},
"required": [
"q"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
search_repositoriesSearch for GitHub repositoriesInput schema{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search query (see GitHub search syntax)"
},
"page": {
"type": "number",
"description": "Page number for pagination (default: 1)"
},
"perPage": {
"type": "number",
"description": "Number of results per page (default: 30, max: 100)"
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
search_usersSearch for users on GitHubInput schema{
"type": "object",
"properties": {
"q": {
"type": "string"
},
"order": {
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"type": "number",
"minimum": 1
},
"per_page": {
"type": "number",
"minimum": 1,
"maximum": 100
},
"sort": {
"type": "string",
"enum": [
"followers",
"repositories",
"joined"
]
}
},
"required": [
"q"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
update_issueUpdate an existing issue in a GitHub repositoryInput schema{
"type": "object",
"properties": {
"owner": {
"type": "string"
},
"repo": {
"type": "string"
},
"issue_number": {
"type": "number"
},
"title": {
"type": "string"
},
"body": {
"type": "string"
},
"assignees": {
"type": "array",
"items": {
"type": "string"
}
},
"milestone": {
"type": "number"
},
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"state": {
"type": "string",
"enum": [
"open",
"closed"
]
}
},
"required": [
"owner",
"repo",
"issue_number"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |