GitHub MCP server for AI agents

Repositories, issues, pull requests, files, releases and Actions on GitHub.

Auth
OAuth 2.0 (sign in with the app) · Access token
Tools
31
Triggers
7
Category
Developer tools
Connect GitHub github.com

Tools and triggers

  • Get the authenticated user

    GITHUB_GET_AUTHENTICATED_USER

    Returns the profile of the GitHub account this connection belongs to.read-only

  • List repositories

    GITHUB_LIST_REPOSITORIES

    Lists repositories the connected account can access, newest activity first by default.read-only

  • Get a repository

    GITHUB_GET_REPOSITORY

    Returns a repository's details: description, default branch, visibility, stars, open issue count.read-only

  • Create a repository

    GITHUB_CREATE_REPOSITORY

    Creates a repository for the connected account, or in an organisation when `org` is given.

  • List issues

    GITHUB_LIST_ISSUES

    Lists issues in a repository (pull requests included, as GitHub does). Filter by state, labels or assignee.read-only

  • Get an issue

    GITHUB_GET_ISSUE

    Returns one issue or pull request by number, with its body, labels and state.read-only

  • Create an issue

    GITHUB_CREATE_ISSUE

    Opens a new issue in a repository.

  • Update an issue

    GITHUB_UPDATE_ISSUE

    Changes an issue's title, text, state, labels or assignees. Use state `closed` to close it.

  • Comment on an issue or pull request

    GITHUB_CREATE_ISSUE_COMMENT

    Adds a comment to an issue or a pull request's conversation.

  • List issue comments

    GITHUB_LIST_ISSUE_COMMENTS

    Lists the comments on an issue or pull request, oldest first.read-only

  • Add labels to an issue

    GITHUB_ADD_LABELS

    Adds labels to an issue or pull request, keeping the ones it has.

  • List pull requests

    GITHUB_LIST_PULL_REQUESTS

    Lists pull requests in a repository.read-only

  • Get a pull request

    GITHUB_GET_PULL_REQUEST

    Returns a pull request with its branches, mergeable state and review counts.read-only

  • List files in a pull request

    GITHUB_LIST_PULL_REQUEST_FILES

    Lists the files a pull request changes, with additions, deletions and the patch.read-only

  • Create a pull request

    GITHUB_CREATE_PULL_REQUEST

    Opens a pull request from `head` into `base`.

  • Review a pull request

    GITHUB_CREATE_PULL_REQUEST_REVIEW

    Submits a review: approve, request changes, or comment.

  • Merge a pull request

    GITHUB_MERGE_PULL_REQUEST

    Merges a pull request.destructive

  • List commits

    GITHUB_LIST_COMMITS

    Lists commits on a branch, optionally only those touching a path or by an author.read-only

  • List branches

    GITHUB_LIST_BRANCHES

    Lists the branches of a repository.read-only

  • Create a branch

    GITHUB_CREATE_BRANCH

    Creates a branch starting at the tip of another branch (the default branch when `from_branch` is left out).

  • Get file contents

    GITHUB_GET_FILE_CONTENTS

    Reads a file and returns its text (decoded), its SHA and size. For a directory, returns the listing.read-only

  • Create or update a file

    GITHUB_CREATE_OR_UPDATE_FILE

    Commits a file. Give the current `sha` to update an existing file (read it with Get file contents).

  • Search repositories

    GITHUB_SEARCH_REPOSITORIES

    Searches all of GitHub for repositories, using GitHub search syntax (`language:go stars:>100`).read-only

  • Search issues and pull requests

    GITHUB_SEARCH_ISSUES

    Searches issues and pull requests (`repo:owner/name is:open label:bug`).read-only

  • Search code

    GITHUB_SEARCH_CODE

    Searches code across repositories the account can see (`addClass repo:jquery/jquery`).read-only

  • List releases

    GITHUB_LIST_RELEASES

    Lists a repository's releases, newest first.read-only

  • Create a release

    GITHUB_CREATE_RELEASE

    Creates a release for a tag, creating the tag when it doesn't exist.

  • List workflow runs

    GITHUB_LIST_WORKFLOW_RUNS

    Lists GitHub Actions runs in a repository, newest first.read-only

  • Run a workflow

    GITHUB_DISPATCH_WORKFLOW

    Starts a GitHub Actions workflow that has a `workflow_dispatch` trigger.

  • Star a repository

    GITHUB_STAR_REPOSITORY

    Stars a repository for the connected account.

  • List notifications

    GITHUB_LIST_NOTIFICATIONS

    Lists the account's unread notifications.read-only

Connect via MCP

Create an MCP server for GitHub in the dashboard, then add its URL to your client. This is the Claude Code command; the client guide has the others.

terminal
claude mcp add --transport http github \
  "https://www.prompt-tm.com/mcp/<server id>?user_id=<your user>" \
  --header "x-api-key: ptm_…"

Connect via REST

Run a tool with one request. The response is { data, error, successful, log_id } for every tool.

terminal
curl -X POST https://www.prompt-tm.com/api/v3/tools/execute/GITHUB_GET_AUTHENTICATED_USER \
  -H "x-api-key: $PROMPT_TM_KEY" -H "content-type: application/json" \
  -d '{ "user_id": "alice", "arguments": {} }'

GitHub questions

Other toolkits