GitHub · Capability

GitHub v3 REST API — Apps

GitHub v3 REST API — Apps. 29 operations. Lead operation: GitHub Get the Authenticated App. Self-contained Naftiko capability covering one Github business surface.

Run with Naftiko GithubApps

What You Can Do

GET
Appsgetauthenticated — GitHub Get the Authenticated App
/v1/app
POST
Appscreatefrommanifest — GitHub Create a GitHub App from a Manifest
/v1/app-manifests/{code}/conversions
GET
Appsgetwebhookconfigforapp — GitHub Get a Webhook Configuration for an App
/v1/app/hook/config
PATCH
Appsupdatewebhookconfigforapp — GitHub Update a Webhook Configuration for an App
/v1/app/hook/config
GET
Appslistwebhookdeliveries — GitHub List Deliveries for an App Webhook
/v1/app/hook/deliveries
GET
Appsgetwebhookdelivery — GitHub Get a Delivery for an App Webhook
/v1/app/hook/deliveries/{delivery-id}
POST
Appsredeliverwebhookdelivery — GitHub Redeliver a Delivery for an App Webhook
/v1/app/hook/deliveries/{delivery-id}/attempts
GET
Appslistinstallationrequestsforauthenticatedapp — GitHub List Installation Requests for the Authenticated App
/v1/app/installation-requests
GET
Appslistinstallations — GitHub List Installations for the Authenticated App
/v1/app/installations
GET
Appsgetinstallation — GitHub Get an Installation for the Authenticated App
/v1/app/installations/{installation-id}
DELETE
Appsdeleteinstallation — GitHub Delete an Installation for the Authenticated App
/v1/app/installations/{installation-id}
POST
Appscreateinstallationaccesstoken — GitHub Create an Installation Access Token for an App
/v1/app/installations/{installation-id}/access-tokens
PUT
Appssuspendinstallation — GitHub Suspend an App Installation
/v1/app/installations/{installation-id}/suspended
DELETE
Appsunsuspendinstallation — GitHub Unsuspend an App Installation
/v1/app/installations/{installation-id}/suspended
DELETE
Appsdeleteauthorization — GitHub Delete an App Authorization
/v1/applications/{client-id}/grant
POST
Appschecktoken — GitHub Check a Token
/v1/applications/{client-id}/token
PATCH
Appsresettoken — GitHub Reset a Token
/v1/applications/{client-id}/token
DELETE
Appsdeletetoken — GitHub Delete an App Token
/v1/applications/{client-id}/token
POST
Appsscopetoken — GitHub Create a Scoped Access Token
/v1/applications/{client-id}/token/scoped
GET
Appsgetbyslug — GitHub Get an App
/v1/apps/{app-slug}
GET
Appslistreposaccessibletoinstallation — GitHub List Repositories Accessible to the App Installation
/v1/installation/repositories
DELETE
Appsrevokeinstallationaccesstoken — GitHub Revoke an Installation Access Token
/v1/installation/token
GET
Appsgetorginstallation — GitHub Get an Organization Installation for the Authenticated App
/v1/orgs/{org}/installation
GET
Appsgetrepoinstallation — GitHub Get a Repository Installation for the Authenticated App
/v1/repos/{owner}/{repo}/installation
GET
Appslistinstallationsforauthenticateduser — GitHub List App Installations Accessible to the User Access Token
/v1/user/installations
GET
Appslistinstallationreposforauthenticateduser — GitHub List Repositories Accessible to the User Access Token
/v1/user/installations/{installation-id}/repositories
PUT
Appsaddrepotoinstallationforauthenticateduser — GitHub Add a Repository to an App Installation
/v1/user/installations/{installation-id}/repositories/{repository-id}
DELETE
Appsremoverepofrominstallationforauthenticateduser — GitHub Remove a Repository from an App Installation
/v1/user/installations/{installation-id}/repositories/{repository-id}
GET
Appsgetuserinstallation — GitHub Get a User Installation for the Authenticated App
/v1/users/{username}/installation

MCP Tools

github-get-authenticated-app

GitHub Get the Authenticated App

read-only idempotent
github-create-github-app-manifest

GitHub Create a GitHub App from a Manifest

github-get-webhook-configuration-app

GitHub Get a Webhook Configuration for an App

read-only idempotent
github-update-webhook-configuration-app

GitHub Update a Webhook Configuration for an App

idempotent
github-list-deliveries-app-webhook

GitHub List Deliveries for an App Webhook

read-only idempotent
github-get-delivery-app-webhook

GitHub Get a Delivery for an App Webhook

read-only idempotent
github-redeliver-delivery-app-webhook

GitHub Redeliver a Delivery for an App Webhook

github-list-installation-requests-authenticated

GitHub List Installation Requests for the Authenticated App

read-only idempotent
github-list-installations-authenticated-app

GitHub List Installations for the Authenticated App

read-only idempotent
github-get-installation-authenticated-app

GitHub Get an Installation for the Authenticated App

read-only idempotent
github-delete-installation-authenticated-app

GitHub Delete an Installation for the Authenticated App

idempotent
github-create-installation-access-token

GitHub Create an Installation Access Token for an App

github-suspend-app-installation

GitHub Suspend an App Installation

idempotent
github-unsuspend-app-installation

GitHub Unsuspend an App Installation

idempotent
github-delete-app-authorization

GitHub Delete an App Authorization

idempotent
github-check-token

GitHub Check a Token

read-only
github-reset-token

GitHub Reset a Token

idempotent
github-delete-app-token

GitHub Delete an App Token

idempotent
github-create-scoped-access-token

GitHub Create a Scoped Access Token

github-get-app

GitHub Get an App

read-only idempotent
github-list-repositories-accessible-app

GitHub List Repositories Accessible to the App Installation

read-only idempotent
github-revoke-installation-access-token

GitHub Revoke an Installation Access Token

idempotent
github-get-organization-installation-authenticated

GitHub Get an Organization Installation for the Authenticated App

read-only idempotent
github-get-repository-installation-authenticated

GitHub Get a Repository Installation for the Authenticated App

read-only idempotent
github-list-app-installations-accessible

GitHub List App Installations Accessible to the User Access Token

read-only idempotent
github-list-repositories-accessible-user

GitHub List Repositories Accessible to the User Access Token

read-only idempotent
github-add-repository-app-installation

GitHub Add a Repository to an App Installation

idempotent
github-remove-repository-app-installation

GitHub Remove a Repository from an App Installation

idempotent
github-get-user-installation-authenticated

GitHub Get a User Installation for the Authenticated App

read-only idempotent

Capability Spec

github-apps.yaml Raw ↑
naftiko: 1.0.0-alpha2
info:
  label: GitHub v3 REST API — Apps
  description: 'GitHub v3 REST API — Apps. 29 operations. Lead operation: GitHub Get the Authenticated App. Self-contained
    Naftiko capability covering one Github business surface.'
  tags:
  - Github
  - Apps
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    GITHUB_API_KEY: GITHUB_API_KEY
capability:
  consumes:
  - type: http
    namespace: github-apps
    baseUri: ''
    description: GitHub v3 REST API — Apps business capability. Self-contained, no shared references.
    resources:
    - name: app
      path: /app
      operations:
      - name: appsgetauthenticated
        method: GET
        description: GitHub Get the Authenticated App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: app-manifests-code-conversions
      path: /app-manifests/{code}/conversions
      operations:
      - name: appscreatefrommanifest
        method: POST
        description: GitHub Create a GitHub App from a Manifest
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: code
          in: path
          type: string
          required: true
    - name: app-hook-config
      path: /app/hook/config
      operations:
      - name: appsgetwebhookconfigforapp
        method: GET
        description: GitHub Get a Webhook Configuration for an App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: appsupdatewebhookconfigforapp
        method: PATCH
        description: GitHub Update a Webhook Configuration for an App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: app-hook-deliveries
      path: /app/hook/deliveries
      operations:
      - name: appslistwebhookdeliveries
        method: GET
        description: GitHub List Deliveries for an App Webhook
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: redelivery
          in: query
          type: boolean
    - name: app-hook-deliveries-delivery_id
      path: /app/hook/deliveries/{delivery_id}
      operations:
      - name: appsgetwebhookdelivery
        method: GET
        description: GitHub Get a Delivery for an App Webhook
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: app-hook-deliveries-delivery_id-attempts
      path: /app/hook/deliveries/{delivery_id}/attempts
      operations:
      - name: appsredeliverwebhookdelivery
        method: POST
        description: GitHub Redeliver a Delivery for an App Webhook
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: app-installation-requests
      path: /app/installation-requests
      operations:
      - name: appslistinstallationrequestsforauthenticatedapp
        method: GET
        description: GitHub List Installation Requests for the Authenticated App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: app-installations
      path: /app/installations
      operations:
      - name: appslistinstallations
        method: GET
        description: GitHub List Installations for the Authenticated App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: outdated
          in: query
          type: string
    - name: app-installations-installation_id
      path: /app/installations/{installation_id}
      operations:
      - name: appsgetinstallation
        method: GET
        description: GitHub Get an Installation for the Authenticated App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: appsdeleteinstallation
        method: DELETE
        description: GitHub Delete an Installation for the Authenticated App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: app-installations-installation_id-access_tokens
      path: /app/installations/{installation_id}/access_tokens
      operations:
      - name: appscreateinstallationaccesstoken
        method: POST
        description: GitHub Create an Installation Access Token for an App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: app-installations-installation_id-suspended
      path: /app/installations/{installation_id}/suspended
      operations:
      - name: appssuspendinstallation
        method: PUT
        description: GitHub Suspend an App Installation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: appsunsuspendinstallation
        method: DELETE
        description: GitHub Unsuspend an App Installation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: applications-client_id-grant
      path: /applications/{client_id}/grant
      operations:
      - name: appsdeleteauthorization
        method: DELETE
        description: GitHub Delete an App Authorization
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: applications-client_id-token
      path: /applications/{client_id}/token
      operations:
      - name: appschecktoken
        method: POST
        description: GitHub Check a Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: appsresettoken
        method: PATCH
        description: GitHub Reset a Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: appsdeletetoken
        method: DELETE
        description: GitHub Delete an App Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: applications-client_id-token-scoped
      path: /applications/{client_id}/token/scoped
      operations:
      - name: appsscopetoken
        method: POST
        description: GitHub Create a Scoped Access Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: apps-app_slug
      path: /apps/{app_slug}
      operations:
      - name: appsgetbyslug
        method: GET
        description: GitHub Get an App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: installation-repositories
      path: /installation/repositories
      operations:
      - name: appslistreposaccessibletoinstallation
        method: GET
        description: GitHub List Repositories Accessible to the App Installation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: installation-token
      path: /installation/token
      operations:
      - name: appsrevokeinstallationaccesstoken
        method: DELETE
        description: GitHub Revoke an Installation Access Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-org-installation
      path: /orgs/{org}/installation
      operations:
      - name: appsgetorginstallation
        method: GET
        description: GitHub Get an Organization Installation for the Authenticated App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: repos-owner-repo-installation
      path: /repos/{owner}/{repo}/installation
      operations:
      - name: appsgetrepoinstallation
        method: GET
        description: GitHub Get a Repository Installation for the Authenticated App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: user-installations
      path: /user/installations
      operations:
      - name: appslistinstallationsforauthenticateduser
        method: GET
        description: GitHub List App Installations Accessible to the User Access Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: user-installations-installation_id-repositories
      path: /user/installations/{installation_id}/repositories
      operations:
      - name: appslistinstallationreposforauthenticateduser
        method: GET
        description: GitHub List Repositories Accessible to the User Access Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: user-installations-installation_id-repositories-repository_id
      path: /user/installations/{installation_id}/repositories/{repository_id}
      operations:
      - name: appsaddrepotoinstallationforauthenticateduser
        method: PUT
        description: GitHub Add a Repository to an App Installation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: appsremoverepofrominstallationforauthenticateduser
        method: DELETE
        description: GitHub Remove a Repository from an App Installation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: users-username-installation
      path: /users/{username}/installation
      operations:
      - name: appsgetuserinstallation
        method: GET
        description: GitHub Get a User Installation for the Authenticated App
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    namespace: github-apps-rest
    port: 8080
    description: REST adapter for GitHub v3 REST API — Apps. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/app
      name: app
      description: REST surface for app.
      operations:
      - method: GET
        name: appsgetauthenticated
        description: GitHub Get the Authenticated App
        call: github-apps.appsgetauthenticated
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/app-manifests/{code}/conversions
      name: app-manifests-code-conversions
      description: REST surface for app-manifests-code-conversions.
      operations:
      - method: POST
        name: appscreatefrommanifest
        description: GitHub Create a GitHub App from a Manifest
        call: github-apps.appscreatefrommanifest
        with:
          code: rest.code
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/app/hook/config
      name: app-hook-config
      description: REST surface for app-hook-config.
      operations:
      - method: GET
        name: appsgetwebhookconfigforapp
        description: GitHub Get a Webhook Configuration for an App
        call: github-apps.appsgetwebhookconfigforapp
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: appsupdatewebhookconfigforapp
        description: GitHub Update a Webhook Configuration for an App
        call: github-apps.appsupdatewebhookconfigforapp
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/app/hook/deliveries
      name: app-hook-deliveries
      description: REST surface for app-hook-deliveries.
      operations:
      - method: GET
        name: appslistwebhookdeliveries
        description: GitHub List Deliveries for an App Webhook
        call: github-apps.appslistwebhookdeliveries
        with:
          redelivery: rest.redelivery
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/app/hook/deliveries/{delivery-id}
      name: app-hook-deliveries-delivery-id
      description: REST surface for app-hook-deliveries-delivery_id.
      operations:
      - method: GET
        name: appsgetwebhookdelivery
        description: GitHub Get a Delivery for an App Webhook
        call: github-apps.appsgetwebhookdelivery
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/app/hook/deliveries/{delivery-id}/attempts
      name: app-hook-deliveries-delivery-id-attempts
      description: REST surface for app-hook-deliveries-delivery_id-attempts.
      operations:
      - method: POST
        name: appsredeliverwebhookdelivery
        description: GitHub Redeliver a Delivery for an App Webhook
        call: github-apps.appsredeliverwebhookdelivery
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/app/installation-requests
      name: app-installation-requests
      description: REST surface for app-installation-requests.
      operations:
      - method: GET
        name: appslistinstallationrequestsforauthenticatedapp
        description: GitHub List Installation Requests for the Authenticated App
        call: github-apps.appslistinstallationrequestsforauthenticatedapp
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/app/installations
      name: app-installations
      description: REST surface for app-installations.
      operations:
      - method: GET
        name: appslistinstallations
        description: GitHub List Installations for the Authenticated App
        call: github-apps.appslistinstallations
        with:
          outdated: rest.outdated
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/app/installations/{installation-id}
      name: app-installations-installation-id
      description: REST surface for app-installations-installation_id.
      operations:
      - method: GET
        name: appsgetinstallation
        description: GitHub Get an Installation for the Authenticated App
        call: github-apps.appsgetinstallation
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: appsdeleteinstallation
        description: GitHub Delete an Installation for the Authenticated App
        call: github-apps.appsdeleteinstallation
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/app/installations/{installation-id}/access-tokens
      name: app-installations-installation-id-access-tokens
      description: REST surface for app-installations-installation_id-access_tokens.
      operations:
      - method: POST
        name: appscreateinstallationaccesstoken
        description: GitHub Create an Installation Access Token for an App
        call: github-apps.appscreateinstallationaccesstoken
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/app/installations/{installation-id}/suspended
      name: app-installations-installation-id-suspended
      description: REST surface for app-installations-installation_id-suspended.
      operations:
      - method: PUT
        name: appssuspendinstallation
        description: GitHub Suspend an App Installation
        call: github-apps.appssuspendinstallation
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: appsunsuspendinstallation
        description: GitHub Unsuspend an App Installation
        call: github-apps.appsunsuspendinstallation
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/applications/{client-id}/grant
      name: applications-client-id-grant
      description: REST surface for applications-client_id-grant.
      operations:
      - method: DELETE
        name: appsdeleteauthorization
        description: GitHub Delete an App Authorization
        call: github-apps.appsdeleteauthorization
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/applications/{client-id}/token
      name: applications-client-id-token
      description: REST surface for applications-client_id-token.
      operations:
      - method: POST
        name: appschecktoken
        description: GitHub Check a Token
        call: github-apps.appschecktoken
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: appsresettoken
        description: GitHub Reset a Token
        call: github-apps.appsresettoken
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: appsdeletetoken
        description: GitHub Delete an App Token
        call: github-apps.appsdeletetoken
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/applications/{client-id}/token/scoped
      name: applications-client-id-token-scoped
      description: REST surface for applications-client_id-token-scoped.
      operations:
      - method: POST
        name: appsscopetoken
        description: GitHub Create a Scoped Access Token
        call: github-apps.appsscopetoken
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/apps/{app-slug}
      name: apps-app-slug
      description: REST surface for apps-app_slug.
      operations:
      - method: GET
        name: appsgetbyslug
        description: GitHub Get an App
        call: github-apps.appsgetbyslug
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/installation/repositories
      name: installation-repositories
      description: REST surface for installation-repositories.
      operations:
      - method: GET
        name: appslistreposaccessibletoinstallation
        description: GitHub List Repositories Accessible to the App Installation
        call: github-apps.appslistreposaccessibletoinstallation
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/installation/token
      name: installation-token
      description: REST surface for installation-token.
      operations:
      - method: DELETE
        name: appsrevokeinstallationaccesstoken
        description: GitHub Revoke an Installation Access Token
        call: github-apps.appsrevokeinstallationaccesstoken
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/orgs/{org}/installation
      name: orgs-org-installation
      description: REST surface for orgs-org-installation.
      operations:
      - method: GET
        name: appsgetorginstallation
        description: GitHub Get an Organization Installation for the Authenticated App
        call: github-apps.appsgetorginstallation
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/installation
      name: repos-owner-repo-installation
      description: REST surface for repos-owner-repo-installation.
      operations:
      - method: GET
        name: appsgetrepoinstallation
        description: GitHub Get a Repository Installation for the Authenticated App
        call: github-apps.appsgetrepoinstallation
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/installations
      name: user-installations
      description: REST surface for user-installations.
      operations:
      - method: GET
        name: appslistinstallationsforauthenticateduser
        description: GitHub List App Installations Accessible to the User Access Token
        call: github-apps.appslistinstallationsforauthenticateduser
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/installations/{installation-id}/repositories
      name: user-installations-installation-id-repositories
      description: REST surface for user-installations-installation_id-repositories.
      operations:
      - method: GET
        name: appslistinstallationreposforauthenticateduser
        description: GitHub List Repositories Accessible to the User Access Token
        call: github-apps.appslistinstallationreposforauthenticateduser
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/installations/{installation-id}/repositories/{repository-id}
      name: user-installations-installation-id-repositories-repository-id
      description: REST surface for user-installations-installation_id-repositories-repository_id.
      operations:
      - method: PUT
        name: appsaddrepotoinstallationforauthenticateduser
        description: GitHub Add a Repository to an App Installation
        call: github-apps.appsaddrepotoinstallationforauthenticateduser
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: appsremoverepofrominstallationforauthenticateduser
        description: GitHub Remove a Repository from an App Installation
        call: github-apps.appsremoverepofrominstallationforauthenticateduser
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/users/{username}/installation
      name: users-username-installation
      description: REST surface for users-username-installation.
      operations:
      - method: GET
        name: appsgetuserinstallation
        description: GitHub Get a User Installation for the Authenticated App
        call: github-apps.appsgetuserinstallation
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: github-apps-mcp
    port: 9090
    transport: http
    description: MCP adapter for GitHub v3 REST API — Apps. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: github-get-authenticated-app
      description: GitHub Get the Authenticated App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-apps.appsgetauthenticated
      outputParameters:
      - type: object
        mapping: $.
    - name: github-create-github-app-manifest
      description: GitHub Create a GitHub App from a Manifest
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: github-apps.appscreatefrommanifest
      with:
        code: tools.code
      outputParameters:
      - type: object
        mapping: $.
    - name: github-get-webhook-configuration-app
      description: GitHub Get a Webhook Configuration for an App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-apps.appsgetwebhookconfigforapp
      outputParameters:
      - type: object
        mapping: $.
    - name: github-update-webhook-configuration-app
      description: GitHub Update a Webhook Configuration for an App
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: github-apps.appsupdatewebhookconfigforapp
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-deliveries-app-webhook
      description: GitHub List Deliveries for an App Webhook
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-apps.appslistwebhookdeliveries
      with:
        redelivery: tools.redelivery
      outputParameters:
      - type: object
        mapping: $.
    - name: github-get-delivery-app-webhook
      description: GitHub Get a Delivery for an App Webhook
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-apps.appsgetwebhookdelivery
      outputParameters:
      - type: object
        mapping: $.
    - name: github-redeliver-delivery-app-webhook
      description: GitHub Redeliver a Delivery for an App Webhook
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: github-apps.appsredeliverwebhookdelivery
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-installation-requests-authenticated
      description: GitHub List Installation Requests for the Authenticated App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-apps.appslistinstallationrequestsforauthenticatedapp
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-installations-authenticated-app
      description: GitHub List Installations for the Authenticated App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-apps.appslistinstallations
      with:
        outdated: tools.outdated
      outputParameters:
      - type: object
        mapping: $.
    - name: github-get-installation-authenticated-app
      description: GitHub Get an Installation for the Authenticated App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-apps.appsgetinstallation
      outputParameters:
      - type: object
        mapping: $.
    - name: github-delete-installation-authenticated-app
      description: GitHub Delete an Installation for the Authenticated App
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: github-apps.appsdeleteinstallation
      outputParameters:
      - type: object
        mapping: $.
    - name: github-create-installation-access-token
      description: GitHub Create an Installation Access Token for an App
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: github-apps.appscreateinstallationaccesstoken
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: github-suspend-app-installation
      description: GitHub Suspend an App Installation
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: github-apps.appssuspendinstallation
      outputParameters:
      - type: object
        mapping: $.
    - name: github-unsuspend-app-installation
      description: GitHub Unsuspend an App Installation
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: github-apps.appsunsuspendinstallation
      outputParameters:
      - type: object
        mapping: $.
    - name: github-delete-app-authorization
      description: GitHub Delete an App Authorization
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: github-apps.appsdeleteauthorization
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: github-check-token
      description: GitHub Check a Token
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: github-apps.appschecktoken
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: github-reset-token
      description: GitHub Reset a Token
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: github-apps.appsresettoken
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: github-delete-app-token
      description: GitHub Delete an App Token
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: github-apps.appsdeletetoken
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: github-create-scoped-access-token
      description: GitHub Create a Scoped Access Token
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: github-apps.appsscopetoken
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: github-get-app
      description: GitHub Get an App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-apps.appsgetbyslug
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-repositories-accessible-app
      description: GitHub List Repositories Accessible to the App Installation
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-apps.appslistreposaccessibletoinstallation
      outputParameters:
      - type: object
        mapping: $.
    - name: github-revoke-installation-access-token
      description: GitHub Revoke an Installation Access Token
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: github-apps.appsrevokeinstallationaccesstoken
      outputParameters:
      - type: object
        mapping: $.
    - name: github-get-organization-installation-authenticated
      description: GitHub Get an Organization Installation for the Authenticated App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-apps.appsgetorginstallation
      outputParameters:
      - type: object
        mapping: $.
    - name: github-get-repository-installation-authenticated
      description: GitHub Get a Repository Installation for the Authenticated App
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-apps.appsgetrepoinstallation
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-app-installations-accessible
      description: GitHub List App Installations Accessible to the User Access Token
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-apps.appslistinstallationsforauthenticateduser
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-repositories-accessible-user
      description: GitHub List Repositories Accessible to the User Access Token
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-apps.appslistinstallationreposforauthenticateduser
      outputParameters:
      - type: object
        mapping: $.
    - name: github-add-repository-app-installation
      description: GitHub Add a Repository to an App Installation
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: github-apps.appsaddrepotoinstallationforauthenticateduser
      out

# --- truncated at 32 KB (32 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/capabilities/github-apps.yaml