source-control.yaml

naftiko: 1.0.0-alpha2
info:
  label: GitHub Source Control
  description: Unified workflow for source code management combining repositories, branches, pull requests, and commits. Used
    by developers for day-to-day code collaboration, branch management, code review, and merging.
  tags:
  - GitHub
  - Source Control
  - Repositories
  - Pull Requests
  - Code Review
  - Branches
  personas:
  - developers
  - software engineers
  - tech leads
  created: '2026-04-17'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    GITHUB_TOKEN: GITHUB_TOKEN
capability:
  consumes:
  - type: http
    namespace: github-repos
    baseUri: https://api.github.com
    description: GitHub REST API for repositories, branches, commits, tags, and releases management. Sourced from github-repos-api
      (153 operations), github-repo-branches-api (35 operations), and github-repo-tags-api (158 operations including overlapping
      repo operations).
    authentication:
      type: bearer
      token: '{{GITHUB_TOKEN}}'
    resources:
    - name: repositories
      path: /repos/{owner}/{repo}
      description: Core repository management operations.
      operations:
      - name: getRepository
        method: GET
        description: Get a repository.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateRepository
        method: PATCH
        description: Update a repository.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteRepository
        method: DELETE
        description: Delete a repository.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listPublicRepositories
        method: GET
        path: /repositories
        description: List all public repositories.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createRepositoryUsingTemplate
        method: POST
        path: /repos/{template_owner}/{template_repo}/generate
        description: Create a repository using a template.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: transferRepository
        method: POST
        description: Transfer a repository.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listForks
        method: GET
        path: /repos/{owner}/{repo}/forks
        description: List forks.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createFork
        method: POST
        path: /repos/{owner}/{repo}/forks
        description: Create a fork.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listRepositoryContributors
        method: GET
        path: /repos/{owner}/{repo}/contributors
        description: List repository contributors.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listRepositoryLanguages
        method: GET
        path: /repos/{owner}/{repo}/languages
        description: List repository languages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listRepositoryTeams
        method: GET
        path: /repos/{owner}/{repo}/teams
        description: List repository teams.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getAllRepositoryTopics
        method: GET
        path: /repos/{owner}/{repo}/topics
        description: Get all repository topics.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: replaceAllRepositoryTopics
        method: PUT
        path: /repos/{owner}/{repo}/topics
        description: Replace all repository topics.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: searchRepositories
        method: GET
        path: /search/repositories
        description: Search repositories.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: branches
      path: /repos/{owner}/{repo}/branches
      description: Branch management and protection rules.
      operations:
      - name: getBranch
        method: GET
        path: /repos/{owner}/{repo}/branches/{branch}
        description: Get a branch.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: renameBranch
        method: POST
        path: /repos/{owner}/{repo}/branches/{branch}/rename
        description: Rename a branch.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getBranchProtection
        method: GET
        path: /repos/{owner}/{repo}/branches/{branch}/protection
        description: Get branch protection.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateBranchProtection
        method: PUT
        path: /repos/{owner}/{repo}/branches/{branch}/protection
        description: Update branch protection.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteBranchProtection
        method: DELETE
        path: /repos/{owner}/{repo}/branches/{branch}/protection
        description: Delete branch protection.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: setAdminBranchProtection
        method: POST
        path: /repos/{owner}/{repo}/branches/{branch}/protection/enforce_admins
        description: Set admin branch protection.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteAdminBranchProtection
        method: DELETE
        path: /repos/{owner}/{repo}/branches/{branch}/protection/enforce_admins
        description: Delete admin branch protection.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getStatusChecksProtection
        method: GET
        path: /repos/{owner}/{repo}/branches/{branch}/protection/required_status_checks
        description: Get status checks protection.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateStatusCheckProtection
        method: PATCH
        path: /repos/{owner}/{repo}/branches/{branch}/protection/required_status_checks
        description: Update status check protection.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: syncForkBranchWithTheUpstreamRepository
        method: POST
        path: /repos/{owner}/{repo}/merge-upstream
        description: Sync a fork branch with the upstream repository.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: mergeBranch
        method: POST
        path: /repos/{owner}/{repo}/merges
        description: Merge a branch.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: commits
      path: /repos/{owner}/{repo}/commits
      description: Commit listing, comparison, and status operations.
      operations:
      - name: listCommits
        method: GET
        description: List commits.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getCommit
        method: GET
        path: /repos/{owner}/{repo}/commits/{ref}
        description: Get a commit.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: compareTwoCommits
        method: GET
        path: /repos/{owner}/{repo}/compare/{basehead}
        description: Compare two commits.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listBranchesForHeadCommit
        method: GET
        path: /repos/{owner}/{repo}/commits/{commit_sha}/branches-where-head
        description: List branches for HEAD commit.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listCommitComments
        method: GET
        path: /repos/{owner}/{repo}/commits/{commit_sha}/comments
        description: List commit comments.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createCommitComment
        method: POST
        path: /repos/{owner}/{repo}/commits/{commit_sha}/comments
        description: Create a commit comment.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listCommitCommentsForRepository
        method: GET
        path: /repos/{owner}/{repo}/comments
        description: List commit comments for a repository.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getCommitComment
        method: GET
        path: /repos/{owner}/{repo}/comments/{comment_id}
        description: Get a commit comment.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateCommitComment
        method: PATCH
        path: /repos/{owner}/{repo}/comments/{comment_id}
        description: Update a commit comment.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteCommitComment
        method: DELETE
        path: /repos/{owner}/{repo}/comments/{comment_id}
        description: Delete a commit comment.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createCommitStatus
        method: POST
        path: /repos/{owner}/{repo}/statuses/{sha}
        description: Create a commit status.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getTheCombinedStatusForSpecificReference
        method: GET
        path: /repos/{owner}/{repo}/commits/{ref}/status
        description: Get the combined status for a specific reference.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listCommitStatusesForReference
        method: GET
        path: /repos/{owner}/{repo}/commits/{ref}/statuses
        description: List commit statuses for a reference.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: tags
      path: /repos/{owner}/{repo}/tags
      description: Tag listing and protection.
      operations:
      - name: listRepositoryTags
        method: GET
        description: List repository tags.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listTagProtectionStatesForRepository
        method: GET
        path: /repos/{owner}/{repo}/tags/protection
        description: List tag protection states for a repository.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createTagProtectionStateForRepository
        method: POST
        path: /repos/{owner}/{repo}/tags/protection
        description: Create a tag protection state for a repository.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteTagProtectionStateForRepository
        method: DELETE
        path: /repos/{owner}/{repo}/tags/protection/{tag_protection_id}
        description: Delete a tag protection state for a repository.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: releases
      path: /repos/{owner}/{repo}/releases
      description: Release creation, management, and assets.
      operations:
      - name: listReleases
        method: GET
        description: List releases.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createRelease
        method: POST
        description: Create a release.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getRelease
        method: GET
        path: /repos/{owner}/{repo}/releases/{release_id}
        description: Get a release.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateRelease
        method: PATCH
        path: /repos/{owner}/{repo}/releases/{release_id}
        description: Update a release.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteRelease
        method: DELETE
        path: /repos/{owner}/{repo}/releases/{release_id}
        description: Delete a release.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getTheLatestRelease
        method: GET
        path: /repos/{owner}/{repo}/releases/latest
        description: Get the latest release.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getReleaseByTagName
        method: GET
        path: /repos/{owner}/{repo}/releases/tags/{tag}
        description: Get a release by tag name.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: generateReleaseNotesContentForRelease
        method: POST
        path: /repos/{owner}/{repo}/releases/generate-notes
        description: Generate release notes content for a release.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listReleaseAssets
        method: GET
        path: /repos/{owner}/{repo}/releases/{release_id}/assets
        description: List release assets.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: uploadReleaseAsset
        method: POST
        path: /repos/{owner}/{repo}/releases/{release_id}/assets
        description: Upload a release asset.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getReleaseAsset
        method: GET
        path: /repos/{owner}/{repo}/releases/assets/{asset_id}
        description: Get a release asset.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateReleaseAsset
        method: PATCH
        path: /repos/{owner}/{repo}/releases/assets/{asset_id}
        description: Update a release asset.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteReleaseAsset
        method: DELETE
        path: /repos/{owner}/{repo}/releases/assets/{asset_id}
        description: Delete a release asset.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: content
      path: /repos/{owner}/{repo}/contents
      description: Repository content and file management.
      operations:
      - name: getRepositoryContent
        method: GET
        path: /repos/{owner}/{repo}/contents/{path}
        description: Get repository content.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createOrUpdateFileContents
        method: PUT
        path: /repos/{owner}/{repo}/contents/{path}
        description: Create or update file contents.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteFile
        method: DELETE
        path: /repos/{owner}/{repo}/contents/{path}
        description: Delete a file.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getRepositoryReadme
        method: GET
        path: /repos/{owner}/{repo}/readme
        description: Get a repository README.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-data
      path: /repos/{owner}/{repo}/git
      description: Low-level Git data operations for blobs, trees, commits, refs, and tags.
      operations:
      - name: createBlob
        method: POST
        path: /repos/{owner}/{repo}/git/blobs
        description: Create a blob.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getBlob
        method: GET
        path: /repos/{owner}/{repo}/git/blobs/{file_sha}
        description: Get a blob.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createCommit
        method: POST
        path: /repos/{owner}/{repo}/git/commits
        description: Create a commit.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getCommitObject
        method: GET
        path: /repos/{owner}/{repo}/git/commits/{commit_sha}
        description: Get a commit object.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listMatchingReferences
        method: GET
        path: /repos/{owner}/{repo}/git/matching-refs/{ref}
        description: List matching references.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getReference
        method: GET
        path: /repos/{owner}/{repo}/git/ref/{ref}
        description: Get a reference.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createReference
        method: POST
        path: /repos/{owner}/{repo}/git/refs
        description: Create a reference.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateReference
        method: PATCH
        path: /repos/{owner}/{repo}/git/refs/{ref}
        description: Update a reference.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteReference
        method: DELETE
        path: /repos/{owner}/{repo}/git/refs/{ref}
        description: Delete a reference.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createTagObject
        method: POST
        path: /repos/{owner}/{repo}/git/tags
        description: Create a tag object.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getTag
        method: GET
        path: /repos/{owner}/{repo}/git/tags/{tag_sha}
        description: Get a tag.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createTree
        method: POST
        path: /repos/{owner}/{repo}/git/trees
        description: Create a tree.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getTree
        method: GET
        path: /repos/{owner}/{repo}/git/trees/{tree_sha}
        description: Get a tree.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  - type: http
    namespace: github-pull-requests
    baseUri: https://api.github.com
    description: GitHub REST API for pull requests, reviews, and review comments.
    authentication:
      type: bearer
      token: '{{GITHUB_TOKEN}}'
    resources:
    - name: pull-requests
      path: /repos/{owner}/{repo}/pulls
      description: Pull request CRUD and listing.
      operations:
      - name: listPullRequests
        method: GET
        description: List pull requests.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createPullRequest
        method: POST
        description: Create a pull request.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getPullRequest
        method: GET
        path: /repos/{owner}/{repo}/pulls/{pull_number}
        description: Get a pull request.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatePullRequest
        method: PATCH
        path: /repos/{owner}/{repo}/pulls/{pull_number}
        description: Update a pull request.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listCommitsOnPullRequest
        method: GET
        path: /repos/{owner}/{repo}/pulls/{pull_number}/commits
        description: List commits on a pull request.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listPullRequestsFiles
        method: GET
        path: /repos/{owner}/{repo}/pulls/{pull_number}/files
        description: List pull request files.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: checkIfPullRequestHasBeenMerged
        method: GET
        path: /repos/{owner}/{repo}/pulls/{pull_number}/merge
        description: Check if a pull request has been merged.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: mergePullRequest
        method: PUT
        path: /repos/{owner}/{repo}/pulls/{pull_number}/merge
        description: Merge a pull request.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatePullRequestBranch
        method: PUT
        path: /repos/{owner}/{repo}/pulls/{pull_number}/update-branch
        description: Update a pull request branch.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: review-comments
      path: /repos/{owner}/{repo}/pulls
      description: Pull request review comment management.
      operations:
      - name: listReviewCommentsInRepository
        method: GET
        path: /repos/{owner}/{repo}/pulls/comments
        description: List review comments in a repository.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getReviewCommentForPullRequest
        method: GET
        path: /repos/{owner}/{repo}/pulls/comments/{comment_id}
        description: Get a review comment for a pull request.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateReviewCommentForPullRequest
        method: PATCH
        path: /repos/{owner}/{repo}/pulls/comments/{comment_id}
        description: Update a review comment.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteReviewCommentForPullRequest
        method: DELETE
        path: /repos/{owner}/{repo}/pulls/comments/{comment_id}
        description: Delete a review comment.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listReviewCommentsOnPullRequest
        method: GET
        path: /repos/{owner}/{repo}/pulls/{pull_number}/comments
        description: List review comments on a pull request.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createReviewCommentForPullRequest
        method: POST
        path: /repos/{owner}/{repo}/pulls/{pull_number}/comments
        description: Create a review comment for a pull request.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createReplyForReviewComment
        method: POST
        path: /repos/{owner}/{repo}/pulls/{pull_number}/comments/{comment_id}/replies
        description: Create a reply for a review comment.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: reviews
      path: /repos/{owner}/{repo}/pulls/{pull_number}/reviews
      description: Pull request review management.
      operations:
      - name: listReviewsForPullRequest
        method: GET
        description: List reviews for a pull request.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createReviewForPullRequest
        method: POST
        description: Create a review for a pull request.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getReviewForPullRequest
        method: GET
        path: /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}
        description: Get a review for a pull request.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateReviewForPullRequest
        method: PUT
        path: /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}
        description: Update a review for a pull request.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletePendingReviewForPullRequest
        method: DELETE
        path: /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}
        description: Delete a pending review for a pull request.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: dismissReviewForPullRequest
        method: PUT
        path: /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}/dismissals
        description: Dismiss a review for a pull request.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: submitReviewForPullRequest
        method: POST
        path: /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}/events
        description: Submit a review for a pull request.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listCommentsForPullRequestReview
        method: GET
        path: /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}/comments
        description: List comments for a pull request review.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: reviewers
      path: /repos/{owner}/{repo}/pulls/{pull_number}
      description: Pull request reviewer management.
      operations:
      - name: getAllRequestedReviewersForPullRequest
        method: GET
        path: /repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers
        description: Get all requested reviewers for a pull request.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: requestReviewersForPullRequest
        method: POST
        path: /repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers
        description: Request reviewers for a pull request.
        body:
          type: json
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: removeRequestedReviewersFromPullRequest
        method: DELETE
        path: /repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers
        description: Remove requested reviewers from a pull request.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: github-source-control-api
    description: Unified REST API for source control workflows combining repos, branches, commits, and pull requests.
    resources:
    - path: /v1/repositories
      name: repositories
      description: Repository listing and search
      operations:
      - method: GET
        name: listPublicRepositories
        description: List public repositories
        call: github-repos.listPublicRepositories
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: searchRepositories
        description: Search repositories
        call: github-repos.searchRepositories
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repositories/{owner}/{repo}
      name: repository
      description: Repository management
      operations:
      - method: GET
        name: getRepository
        description: Get a repository
        call: github-repos.getRepository
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updateRepository
        description: Update a repository
        call: github-repos.updateRepository
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repositories/{owner}/{repo}/branches/{branch}
      name: branch
      description: Branch operations
      operations:
      - method: GET
        name: getBranch
        description: Get a branch
        call: github-repos.getBranch
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repositories/{owner}/{repo}/commits
      name: commits
      description: Commit operations
      operations:
      - method: GET
        name: listCommits
        description: List commits
        call: github-repos.listCommits
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repositories/{owner}/{repo}/compare/{basehead}
      name: compare
      description: Compare commits
      operations:
      - method: GET
        name: compareTwoCommits
        description: Compare two commits
        call: github-repos.compareTwoCommits
        with:
          basehead: rest.basehead
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repositories/{owner}/{repo}/pulls
      name: pull-requests
      description: Pull request management
      operations:
      - method: GET
        name: listPullRequests
        description: List pull requests
        call: github-pull-requests.listPullRequests
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createPullRequest
        description: Create a pull request
        call: github-pull-requests.createPullRequest
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repositories/{owner}/{repo}/pulls/{pull_number}
      name: pull-request
      description: Individual pull request operations
      operations:
      - method: GET
        name: getPullRequest
        description: Get a pull request
        call: github-pull-requests.getPullRequest
        with:
          pull_number: rest.pull_number
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updatePullRequest
        description: Update a pull request
        call: github-pull-requests.updatePullRequest
        with:
          pull_number: rest.pull_number
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repositories/{owner}/{repo}/pulls/{pull_number}/merge
      name: merge
      description: Pull request merge
      operations:
      - method: PUT
        name: mergePullRequest
        description: Merge a pull request
        call: github-pull-requests.mergePullRequest
        with:
          pull_number: rest.pull_number
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repositories/{owner}/{repo}/pulls/{pull_number}/reviews
      name: reviews
      description: Code review management
      operations:
      - method: GET
        name: listReviewsForPullRequest
        description: List reviews
        call: github-pull-requests.listReviewsForPullRequest
        with:
          pull_number: rest.pull_number
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createReviewForPullRequest
        description: Create a review
        call: github-pull-requests.createReviewForPullRequest
        with:
          pull_number: rest.pull_number
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repositories/{owner}/{repo}/releases
      name: releases
      description: Release management
      operations:
      - method: GET
        name: listReleases
        description: List releases
        call: github-repos.listReleases
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createRelease
        description: Create a release
        call: github-repos.createRelease
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repositories/{owner}/{repo}/contents/{path}
      name: contents
      description: Repository content management
      operations:
      - method: GET
        name: getRepositoryContent
        description: Get repository content
        call: github-repos.getRepositoryContent
        with:
          path: rest.path
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: createOrUpdateFileContents
        description: Create or update file contents
        call: github-repos.createOrUpdateFileContents
        with:
          path: rest.path
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9080
    namespace: github-source-control-mcp
    transport: http
    description: MCP server for AI-assisted source control workflows.
    tools:
    - name: get-repository
      description: Get a repository
      call: github-repos.getRepository
      hints:
        readOnly: true
    - name: search-repositories
      description: Search repositories
      call: github-repos.searchRepositories
      hints:
        readOnly: true
    - name: get-branch
      description: Get a branch
      call: github-repos.getBranch
      hints:
        readOnly: true
    - name: list-commits
      description: List commits
      call: github-repos.listCommits
      hints:
        readOnly: true
    - name: get-commit
      description: Get a commit
      call: github-repos.getCommit
      hints:
        readOnly: true
    - name: compare-commits
      description: Compare two commits
      call: github-repos.compareTwoCommits
      hints:
        readOnly: true
    - name: get-content
      description: Get repository content
      call: github-repos.getRepositoryContent
      hints:
        readOnly: true
    - name: create-or-update-file
      description: Create or update file contents
      call: github-repos.createOrUpdateFileContents
      hints:
        idempotent: true
    - name: merge-branch
      description: Merge a branch
      call: github-repos.mergeBranch
    - name: list-pull-requests
      description: List pull requests
      call: github-pull-requests.listPullRequests
      hints:
        readOnly: true
    - name: create-pull-request
      description: Create a pull request
      call: github-pull-requests.createPullRequest
    - name: get-pull-request
      description: Get a pull request
      call: github-pull-requests.getPullRequest
      hints:
        readOnly: true
    - name: update-pull-request
      description: Update a pull request
      call: github-pull-requests.updatePullRequest
      hints:
        idempotent: true
    - name: merge-pull-request
      description: Merge a pull request
      call: github-pull-requests.mergePullRequest
    - name: list-reviews
      description: List reviews for a pull request
      call: github-pull-requests.listReviewsForPullRequest
      hints:
        readOnly: true
    - name: create-review
      description: Create a review for a pull request
      call: github-pull-requests.createReviewForPullRequest
    - name: submit-review
      description: Submit a review for a pull request
      call: github-pull-requests.submitReviewForPullRequest
    - name: request-reviewers
      description: Request reviewers for a pull request
      call: github-pull-requests.requestReviewersForPullRequest
    - name: list-pr-files
      description: List pull request files
      call: github-pull-requests.listPullRequestsFiles
      hints:
        readOnly: true
    - name: list-releases
      description: List releases
      call: github-repos.listReleases
      hints:
        readOnly: true
    - name: create-release
      description: Create a release
      call: github-repos.createRelease
    - name: list-tags
      description: List repository tags
      call: github-repos.listRepositoryTags
      hints:
        readOnly: true
    - name: update-branch-protection
      description: Update branch protection
      call: github-repos.updateBranchProtection
      hints:
        idempotent: true