GitHub Pulls (BYOK) — connector documentation
- MCP endpoint:
https://byok-github-pulls.connectorbay.com/mcp - REST API:
POST https://byok-github-pulls.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec athttps://byok-github-pulls.connectorbay.com/openapi.json - Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
- Authentication: your own GitHub Pulls GitHub personal access token (repo scope for private repositories), sent in the
X-Upstream-Keyheader of every request (never stored, logged or cached) - Health:
https://byok-github-pulls.connectorbay.com/health· Tool schemas:https://byok-github-pulls.connectorbay.com/tools.json - Publisher: Unify Dynamics LLC · connectorbay.com/byok-github-pulls · agent@connectorbay.com
What GitHub Pulls (BYOK) is for
GitHub Pulls (BYOK) lets an AI assistant read your own GitHub Pulls data through the GitHub Pulls API with a key you supply (GitHub personal access token (repo scope for private repositories)). Read-only: 8 tools (get_pull_request, list_pull_request_files, list_pull_request_commits, list_requested_reviewers, list_pull_request_review_comments, list_repository_review_comments, list_pull_requests_for_commit, list_review_comments_for_review). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.github.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by GitHub Pulls. GitHub Pulls and its logos are trademarks of their owners and are used only to say which service the connector works with.
Ask your assistant things like:
- "How big is pull request 1347 of octocat/Hello-World and can it be merged?"
- "Which files does pull request 1347 of octocat/Hello-World change?"
- "What commits are in pull request 1347 of octocat/Hello-World?"
- "Who still needs to review pull request 1347 of octocat/Hello-World?"
- "Which lines of pull request 1347 of octocat/Hello-World have review comments?"
- "What review comments were added recently across octocat/Hello-World?"
What it does
get_pull_request: Get one pull request: state, draft and merge flags, mergeable state, branches, size (additions, deletions, files, commits) and comment counts.list_pull_request_files: List the files a pull request changes with status (added, modified, removed), additions, deletions and previous name; the diff text itself is left out.list_pull_request_commits: List the commits of a pull request (oldest first, at most 250) with SHA, message, author name and date.list_requested_reviewers: List the users and teams whose review has been requested on a pull request and not yet given.list_pull_request_review_comments: List the inline code comments on a pull request with file, line, author and time; the comment text is left out.list_repository_review_comments: List inline review comments across all pull requests of a repository with pull request, file, line, author and time; the comment text is left out.list_pull_requests_for_commit: List the pull requests that contain a given commit SHA, with state, branches and merge time.list_review_comments_for_review: List the inline comments that belong to one pull request review, with file, line and time; the comment text is left out.
BYOK key
You bring your own GitHub Pulls GitHub personal access token (repo scope for private repositories) (https://github.com/settings/tokens). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to api.github.com over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.
Data sources
- https://docs.github.com/en/rest/pulls (the API this connector calls, with a BYOK key)
Live from the GitHub Pulls API (api.github.com) with a BYOK key; documentation: https://docs.github.com/en/rest/pulls. Endpoints checked against that documentation on 2026-10-16.
What it is not
Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by GitHub Pulls. GitHub Pulls and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your GitHub Pulls account.
Built for: Worldwide. Languages: English.