/github | Type: Application | PCID required: Yes
Repos, issues, and pull requests
Tools
| Tool | Description |
|---|---|
github_create_issue | Create a new issue in a GitHub repository |
github_create_pull_request | Create a new pull request in a GitHub repository |
github_get_repository | Get information about a GitHub repository |
github_list_issues | List issues in a GitHub repository |
github_get_issue | Get a specific issue by number |
github_update_issue | Update an existing GitHub issue |
github_create_issue_comment | Add a comment to a GitHub issue |
github_list_pull_requests | List pull requests in a GitHub repository |
github_get_pull_request | Get a specific pull request by number |
github_create_repository | Create a new GitHub repository |
github_list_repositories | List repositories for the authenticated user |
github_get_file_content | Get the content of a file from a GitHub repository |
github_create_or_update_file | Create or update a file in a GitHub repository |
github_list_commits | List commits in a GitHub repository |
github_get_current_user | Get information about the authenticated user |
github_search_repositories | Search for repositories on GitHub |
github_create_branch | Create a new branch in a GitHub repository |
github_list_trigger_capabilities | List available trigger types that can be created for GitHub webhooks |
github_create_trigger | Create a GitHub webhook that will send events |
github_update_trigger | Update an existing GitHub webhook (only supports updating events list) |
github_delete_trigger | Delete a GitHub webhook |
github_create_issue
Create a new issue in a GitHub repository Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Repository owner (username or organization). Tip: Use github_list_repositories to see repositories you have access to. |
repo | string | Yes | — | Repository name. Tip: Use github_list_repositories or github_search_repositories to discover available repositories. |
title | string | Yes | — | Issue title |
body | string | No | — | Issue description/body |
assignees | string[] | No | — | Array of usernames to assign. Tip: Use github_get_current_user to get your username. |
labels | string[] | No | — | Array of label names to apply (label names, not IDs) |
milestone | number | No | — | Milestone number to associate with issue |
github_create_pull_request
Create a new pull request in a GitHub repository Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Repository owner |
repo | string | Yes | — | Repository name |
title | string | Yes | — | Pull request title |
head | string | Yes | — | Branch with changes (e.g., “feature-branch”) |
base | string | Yes | — | Base branch to merge into (e.g., “main”) |
body | string | No | — | Pull request description |
draft | boolean | No | false | Create as draft PR |
maintainerCanModify | boolean | No | true | Allow maintainers to modify PR |
github_get_repository
Get information about a GitHub repository Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Repository owner |
repo | string | Yes | — | Repository name |
github_list_issues
List issues in a GitHub repository Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Repository owner |
repo | string | Yes | — | Repository name |
state | string | No | "open" | Issue state filter |
assignee | string | No | — | Filter by assignee username |
labels | string | No | — | Comma-separated list of label names |
sort | string | No | "created" | Sort field |
direction | string | No | "desc" | Sort direction |
perPage | number | No | 30 | Number of results per page |
github_get_issue
Get a specific issue by number Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Repository owner |
repo | string | Yes | — | Repository name |
issueNumber | number | Yes | — | Issue number |
github_update_issue
Update an existing GitHub issue Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Repository owner |
repo | string | Yes | — | Repository name |
issueNumber | number | Yes | — | Issue number to update |
title | string | No | — | Updated issue title |
body | string | No | — | Updated issue body |
state | string | No | — | Updated issue state |
assignees | string[] | No | — | Updated assignees |
labels | string[] | No | — | Updated labels |
github_create_issue_comment
Add a comment to a GitHub issue Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Repository owner |
repo | string | Yes | — | Repository name |
issueNumber | number | Yes | — | Issue number to comment on |
body | string | Yes | — | Comment text |
github_list_pull_requests
List pull requests in a GitHub repository Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Repository owner |
repo | string | Yes | — | Repository name |
state | string | No | "open" | PR state filter |
head | string | No | — | Filter by head branch |
base | string | No | — | Filter by base branch |
sort | string | No | "created" | Sort field |
direction | string | No | "desc" | Sort direction |
perPage | number | No | 30 | Number of results per page |
github_get_pull_request
Get a specific pull request by number Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Repository owner |
repo | string | Yes | — | Repository name |
pullNumber | number | Yes | — | Pull request number |
github_create_repository
Create a new GitHub repository Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | — | Repository name |
description | string | No | — | Repository description |
private | boolean | No | false | Whether repository is private |
autoInit | boolean | No | false | Initialize with README |
gitignoreTemplate | string | No | — | Gitignore template to use |
licenseTemplate | string | No | — | License template to use |
github_list_repositories
List repositories for the authenticated user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
visibility | string | No | "all" | Repository visibility filter |
sort | string | No | "created" | Sort field |
direction | string | No | "desc" | Sort direction |
perPage | number | No | 30 | Number of results per page |
github_get_file_content
Get the content of a file from a GitHub repository Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Repository owner |
repo | string | Yes | — | Repository name |
path | string | Yes | — | File path in repository |
ref | string | No | — | Branch, tag, or commit SHA (defaults to default branch) |
github_create_or_update_file
Create or update a file in a GitHub repository Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Repository owner |
repo | string | Yes | — | Repository name |
path | string | Yes | — | File path in repository |
message | string | Yes | — | Commit message |
content | string | Yes | — | File content (will be base64 encoded) |
branch | string | No | — | Branch to commit to (defaults to default branch) |
sha | string | No | — | SHA of existing file (required for updates) |
github_list_commits
List commits in a GitHub repository Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Repository owner |
repo | string | Yes | — | Repository name |
sha | string | No | — | SHA or branch to start listing from |
path | string | No | — | Filter commits by file path |
author | string | No | — | Filter commits by author |
since | string | No | — | Only commits after this date (ISO 8601) |
until | string | No | — | Only commits before this date (ISO 8601) |
perPage | number | No | 30 | Number of results per page |
github_get_current_user
Get information about the authenticated usergithub_search_repositories
Search for repositories on GitHub Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | Search query (e.g., “language:javascript”, “user:octocat”) |
sort | string | No | — | Sort field |
order | string | No | "desc" | Sort order |
perPage | number | No | 30 | Number of results per page |
github_create_branch
Create a new branch in a GitHub repository Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string | Yes | — | Repository owner |
repo | string | Yes | — | Repository name |
branchName | string | Yes | — | Name for the new branch |
fromBranch | string | No | "main" | Source branch to create from |
github_list_trigger_capabilities
List available trigger types that can be created for GitHub webhooksgithub_create_trigger
Create a GitHub webhook that will send events Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
triggerType | string | Yes | — | Type of trigger to create |
webhookUrl | string | Yes | — | The webhook URL where GitHub should send events |
repository | string | Yes | — | Repository in owner/name format (e.g., “octocat/hello-world”). Tip: Use github_list_repositories to see repositories you have access to. |
events | any | Yes | — | Event types to subscribe to. Common: push, pull_request, issues, issue_comment, release. Can be passed as JSON string array or array. |
secret | string | No | — | Optional webhook secret for signature verification (auto-generated if not provided) |
github_update_trigger
Update an existing GitHub webhook (only supports updating events list) Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
webhookId | string | Yes | — | The GitHub webhook ID to update |
owner | string | Yes | — | Repository owner (username or organization). Tip: Use github_list_repositories to see repositories you have access to. |
repo | string | Yes | — | Repository name. Tip: Use github_list_repositories to find the repository. |
events | any | Yes | — | Array of event types to subscribe to. Can be passed as JSON string array or array. |
active | boolean | No | true | Whether the webhook is active |
github_delete_trigger
Delete a GitHub webhook Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
triggerId | string | Yes | — | The ID of the webhook to delete |
owner | string | No | — | Repository owner (required if not in metadata from trigger creation) |
repo | string | No | — | Repository name (required if not in metadata from trigger creation) |
webhookId | string | No | — | Optional webhook ID (if not provided, will use triggerId) |

