Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 60 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -404,6 +404,7 @@ The following sets of tools are available:
| `labels` | GitHub Labels related tools |
| `notifications` | GitHub Notifications related tools |
| `orgs` | GitHub Organization related tools |
| `packages` | GitHub Packages related tools for managing and viewing package metadata, versions, and deletion operations |
| `projects` | GitHub Projects related tools |
| `pull_requests` | GitHub Pull Request related tools |
| `repos` | GitHub Repository related tools |
Expand Down Expand Up @@ -793,6 +794,65 @@ Options are:

<details>

<summary>Packages</summary>

- **delete_org_package** - Delete organization package
- `org`: Organization name (string, required)
- `package_name`: Package name (string, required)
- `package_type`: Package type (string, required)

- **delete_org_package_version** - Delete organization package version
- `org`: Organization name (string, required)
- `package_name`: Package name (string, required)
- `package_type`: Package type (string, required)
- `package_version_id`: Package version ID (number, required)

- **delete_user_package** - Delete user package
- `package_name`: Package name (string, required)
- `package_type`: Package type (string, required)

- **delete_user_package_version** - Delete user package version
- `package_name`: Package name (string, required)
- `package_type`: Package type (string, required)
- `package_version_id`: Package version ID (number, required)

- **get_org_package** - Get organization package details
- `org`: Organization name (string, required)
- `package_name`: Package name (string, required)
- `package_type`: Package type (string, required)

- **get_package_version** - Get package version details
- `org`: Organization name (string, required)
- `package_name`: Package name (string, required)
- `package_type`: Package type (string, required)
- `package_version_id`: Package version ID (number, required)

- **list_org_packages** - List organization packages
- `org`: Organization name (string, required)
- `package_type`: Filter by package type (string, optional)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `visibility`: Filter by package visibility (string, optional)

- **list_package_versions** - List package versions
- `org`: Organization name (string, required)
- `package_name`: Package name (string, required)
- `package_type`: Package type (string, required)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `state`: Filter by version state (string, optional)

- **list_user_packages** - List user packages
- `package_type`: Filter by package type (string, optional)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `username`: GitHub username (string, required)
- `visibility`: Filter by package visibility (string, optional)

</details>

<details>

<summary>Projects</summary>

- **add_project_item** - Add project item
Expand Down
1 change: 1 addition & 0 deletions docs/remote-server.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ Below is a table of available toolsets for the remote GitHub MCP Server. Each to
| Labels | GitHub Labels related tools | https://api.githubcopilot.com/mcp/x/labels | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-labels&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Flabels%22%7D) | [read-only](https://api.githubcopilot.com/mcp/x/labels/readonly) | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-labels&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Flabels%2Freadonly%22%7D) |
| Notifications | GitHub Notifications related tools | https://api.githubcopilot.com/mcp/x/notifications | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-notifications&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fnotifications%22%7D) | [read-only](https://api.githubcopilot.com/mcp/x/notifications/readonly) | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-notifications&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fnotifications%2Freadonly%22%7D) |
| Organizations | GitHub Organization related tools | https://api.githubcopilot.com/mcp/x/orgs | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-orgs&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Forgs%22%7D) | [read-only](https://api.githubcopilot.com/mcp/x/orgs/readonly) | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-orgs&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Forgs%2Freadonly%22%7D) |
| Packages | GitHub Packages related tools for managing and viewing package metadata, versions, and deletion operations | https://api.githubcopilot.com/mcp/x/packages | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-packages&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fpackages%22%7D) | [read-only](https://api.githubcopilot.com/mcp/x/packages/readonly) | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-packages&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fpackages%2Freadonly%22%7D) |
| Projects | GitHub Projects related tools | https://api.githubcopilot.com/mcp/x/projects | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-projects&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fprojects%22%7D) | [read-only](https://api.githubcopilot.com/mcp/x/projects/readonly) | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-projects&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fprojects%2Freadonly%22%7D) |
| Pull Requests | GitHub Pull Request related tools | https://api.githubcopilot.com/mcp/x/pull_requests | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-pull_requests&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fpull_requests%22%7D) | [read-only](https://api.githubcopilot.com/mcp/x/pull_requests/readonly) | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-pull_requests&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fpull_requests%2Freadonly%22%7D) |
| Repositories | GitHub Repository related tools | https://api.githubcopilot.com/mcp/x/repos | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-repos&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Frepos%22%7D) | [read-only](https://api.githubcopilot.com/mcp/x/repos/readonly) | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-repos&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Frepos%2Freadonly%22%7D) |
Expand Down
38 changes: 38 additions & 0 deletions pkg/github/__toolsnaps__/delete_org_package.snap

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pkg/github/toolsnaps/delete_org_package.snap

Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
{
"annotations": {
"title": "Delete organization package",
"readOnlyHint": false
},
"description": "Delete an entire package from a GitHub organization. This will delete all versions of the package. Requires delete:packages scope.",
"inputSchema": {
"properties": {
"org": {
"description": "Organization name",
"type": "string"
},
"package_name": {
"description": "Package name",
"type": "string"
},
"package_type": {
"description": "Package type",
"enum": [
"npm",
"maven",
"rubygems",
"docker",
"nuget",
"container"
],
"type": "string"
}
},
"required": [
"org",
"package_type",
"package_name"
],
"type": "object"
},
"name": "delete_org_package"
}
43 changes: 43 additions & 0 deletions pkg/github/__toolsnaps__/delete_org_package_version.snap
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
{
"annotations": {
"title": "Delete organization package version",
"readOnlyHint": false
},
"description": "Delete a specific version of a package from a GitHub organization. Requires delete:packages scope.",
"inputSchema": {
"properties": {
"org": {
"description": "Organization name",
"type": "string"
},
"package_name": {
"description": "Package name",
"type": "string"
},
"package_type": {
"description": "Package type",
"enum": [
"npm",
"maven",
"rubygems",
"docker",
"nuget",
"container"
],
"type": "string"
},
"package_version_id": {
"description": "Package version ID",
"type": "number"
}
},
"required": [
"org",
"package_type",
"package_name",
"package_version_id"
],
"type": "object"
},
"name": "delete_org_package_version"
}
33 changes: 33 additions & 0 deletions pkg/github/__toolsnaps__/delete_user_package.snap
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
{
"annotations": {
"title": "Delete user package",
"readOnlyHint": false
},
"description": "Delete an entire package from the authenticated user's account. This will delete all versions of the package. Requires delete:packages scope.",
"inputSchema": {
"properties": {
"package_name": {
"description": "Package name",
"type": "string"
},
"package_type": {
"description": "Package type",
"enum": [
"npm",
"maven",
"rubygems",
"docker",
"nuget",
"container"
],
"type": "string"
}
},
"required": [
"package_type",
"package_name"
],
"type": "object"
},
"name": "delete_user_package"
}
38 changes: 38 additions & 0 deletions pkg/github/__toolsnaps__/delete_user_package_version.snap
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
{
"annotations": {
"title": "Delete user package version",
"readOnlyHint": false
},
"description": "Delete a specific version of a package from the authenticated user's account. Requires delete:packages scope.",
"inputSchema": {
"properties": {
"package_name": {
"description": "Package name",
"type": "string"
},
"package_type": {
"description": "Package type",
"enum": [
"npm",
"maven",
"rubygems",
"docker",
"nuget",
"container"
],
"type": "string"
},
"package_version_id": {
"description": "Package version ID",
"type": "number"
}
},
"required": [
"package_type",
"package_name",
"package_version_id"
],
"type": "object"
},
"name": "delete_user_package_version"
}
38 changes: 38 additions & 0 deletions pkg/github/__toolsnaps__/get_org_package.snap
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
{
"annotations": {
"title": "Get organization package details",
"readOnlyHint": true
},
"description": "Get details of a specific package for an organization.",
"inputSchema": {
"properties": {
"org": {
"description": "Organization name",
"type": "string"
},
"package_name": {
"description": "Package name",
"type": "string"
},
"package_type": {
"description": "Package type",
"enum": [
"npm",
"maven",
"rubygems",
"docker",
"nuget",
"container"
],
"type": "string"
}
},
"required": [
"org",
"package_type",
"package_name"
],
"type": "object"
},
"name": "get_org_package"
}
43 changes: 43 additions & 0 deletions pkg/github/__toolsnaps__/get_package_version.snap
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
{
"annotations": {
"title": "Get package version details",
"readOnlyHint": true
},
"description": "Get details of a specific package version, including metadata.",
"inputSchema": {
"properties": {
"org": {
"description": "Organization name",
"type": "string"
},
"package_name": {
"description": "Package name",
"type": "string"
},
"package_type": {
"description": "Package type",
"enum": [
"npm",
"maven",
"rubygems",
"docker",
"nuget",
"container"
],
"type": "string"
},
"package_version_id": {
"description": "Package version ID",
"type": "number"
}
},
"required": [
"org",
"package_type",
"package_name",
"package_version_id"
],
"type": "object"
},
"name": "get_package_version"
}
52 changes: 52 additions & 0 deletions pkg/github/__toolsnaps__/list_org_packages.snap
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
{
"annotations": {
"title": "List organization packages",
"readOnlyHint": true
},
"description": "List packages for a GitHub organization. Returns package metadata including name, type, visibility, and version count.",
"inputSchema": {
"properties": {
"org": {
"description": "Organization name",
"type": "string"
},
"package_type": {
"description": "Filter by package type",
"enum": [
"npm",
"maven",
"rubygems",
"docker",
"nuget",
"container"
],
"type": "string"
},
"page": {
"description": "Page number for pagination (min 1)",
"minimum": 1,
"type": "number"
},
"perPage": {
"description": "Results per page for pagination (min 1, max 100)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"visibility": {
"description": "Filter by package visibility",
"enum": [
"public",
"private",
"internal"
],
"type": "string"
}
},
"required": [
"org"
],
"type": "object"
},
"name": "list_org_packages"
}
Loading