naftiko: 1.0.0-alpha2 info: label: GitHub Repos API — Releases description: 'GitHub Repos API — Releases. 16 operations. Lead operation: List Releases. Self-contained Naftiko capability covering one Github business surface.' tags: - Github - Releases created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: GITHUB_API_KEY: GITHUB_API_KEY capability: consumes: - type: http namespace: temp-releases baseUri: '' description: GitHub Repos API — Releases business capability. Self-contained, no shared references. resources: - name: repos-owner-repo-releases path: /repos/{owner}/{repo}/releases operations: - name: listreleases method: GET description: List Releases outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: createrelease method: POST description: Create Release outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: body in: body type: object description: Request body (JSON). required: true - name: repos-owner-repo-releases-assets-asset_id path: /repos/{owner}/{repo}/releases/assets/{asset_id} operations: - name: getreleaseasset method: GET description: Get Release Asset outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: updatereleaseasset method: PATCH description: Update Release Asset outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: body in: body type: object description: Request body (JSON). required: false - name: deletereleaseasset method: DELETE description: Delete Release Asset outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-releases-generate-notes path: /repos/{owner}/{repo}/releases/generate-notes operations: - name: generatereleasenotescontentforrelease method: POST description: Generate Release Notes Content For Release outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: body in: body type: object description: Request body (JSON). required: true - name: repos-owner-repo-releases-latest path: /repos/{owner}/{repo}/releases/latest operations: - name: getthelatestrelease method: GET description: Get The Latest Release outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-releases-tags-tag path: /repos/{owner}/{repo}/releases/tags/{tag} operations: - name: getreleasebytagname method: GET description: Get Release By Tag Name outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: tag in: path type: string description: tag parameter required: true - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-releases-release_id path: /repos/{owner}/{repo}/releases/{release_id} operations: - name: getrelease method: GET description: Get Release outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: updaterelease method: PATCH description: Update Release outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: body in: body type: object description: Request body (JSON). required: false - name: deleterelease method: DELETE description: Delete Release outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-releases-release_id-assets path: /repos/{owner}/{repo}/releases/{release_id}/assets operations: - name: listreleaseassets method: GET description: List Release Assets outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: uploadreleaseasset method: POST description: Upload Release Asset outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: query type: string required: true - name: label in: query type: string - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: body in: body type: object description: Request body (JSON). required: false - name: repos-owner-repo-releases-release_id-reactions path: /repos/{owner}/{repo}/releases/{release_id}/reactions operations: - name: listreactionsforrelease method: GET description: List Reactions For Release outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: content in: query type: string description: Returns a single [reaction type](https://docs.github.com/enterprise-server@3.9/rest/reactions/reactions#about-reactions). Omit this parameter to list all reacti - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: createreactionforrelease method: POST description: Create Reaction For Release outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: body in: body type: object description: Request body (JSON). required: true - name: repos-owner-repo-releases-release_id-reactions-reaction_id path: /repos/{owner}/{repo}/releases/{release_id}/reactions/{reaction_id} operations: - name: deletereleasereaction method: DELETE description: Delete Release Reaction outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string authentication: type: bearer token: '{{env.GITHUB_API_KEY}}' exposes: - type: rest namespace: temp-releases-rest port: 8080 description: REST adapter for GitHub Repos API — Releases. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/repos/{owner}/{repo}/releases name: repos-owner-repo-releases description: REST surface for repos-owner-repo-releases. operations: - method: GET name: listreleases description: List Releases call: temp-releases.listreleases with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - method: POST name: createrelease description: Create Release call: temp-releases.createrelease with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept body: rest.body outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/releases/assets/{asset-id} name: repos-owner-repo-releases-assets-asset-id description: REST surface for repos-owner-repo-releases-assets-asset_id. operations: - method: GET name: getreleaseasset description: Get Release Asset call: temp-releases.getreleaseasset with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - method: PATCH name: updatereleaseasset description: Update Release Asset call: temp-releases.updatereleaseasset with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deletereleaseasset description: Delete Release Asset call: temp-releases.deletereleaseasset with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/releases/generate-notes name: repos-owner-repo-releases-generate-notes description: REST surface for repos-owner-repo-releases-generate-notes. operations: - method: POST name: generatereleasenotescontentforrelease description: Generate Release Notes Content For Release call: temp-releases.generatereleasenotescontentforrelease with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept body: rest.body outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/releases/latest name: repos-owner-repo-releases-latest description: REST surface for repos-owner-repo-releases-latest. operations: - method: GET name: getthelatestrelease description: Get The Latest Release call: temp-releases.getthelatestrelease with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/releases/tags/{tag} name: repos-owner-repo-releases-tags-tag description: REST surface for repos-owner-repo-releases-tags-tag. operations: - method: GET name: getreleasebytagname description: Get Release By Tag Name call: temp-releases.getreleasebytagname with: tag: rest.tag Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/releases/{release-id} name: repos-owner-repo-releases-release-id description: REST surface for repos-owner-repo-releases-release_id. operations: - method: GET name: getrelease description: Get Release call: temp-releases.getrelease with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - method: PATCH name: updaterelease description: Update Release call: temp-releases.updaterelease with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deleterelease description: Delete Release call: temp-releases.deleterelease with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/releases/{release-id}/assets name: repos-owner-repo-releases-release-id-assets description: REST surface for repos-owner-repo-releases-release_id-assets. operations: - method: GET name: listreleaseassets description: List Release Assets call: temp-releases.listreleaseassets with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - method: POST name: uploadreleaseasset description: Upload Release Asset call: temp-releases.uploadreleaseasset with: name: rest.name label: rest.label Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept body: rest.body outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/releases/{release-id}/reactions name: repos-owner-repo-releases-release-id-reactions description: REST surface for repos-owner-repo-releases-release_id-reactions. operations: - method: GET name: listreactionsforrelease description: List Reactions For Release call: temp-releases.listreactionsforrelease with: content: rest.content Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - method: POST name: createreactionforrelease description: Create Reaction For Release call: temp-releases.createreactionforrelease with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept body: rest.body outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/releases/{release-id}/reactions/{reaction-id} name: repos-owner-repo-releases-release-id-reactions-reaction-id description: REST surface for repos-owner-repo-releases-release_id-reactions-reaction_id. operations: - method: DELETE name: deletereleasereaction description: Delete Release Reaction call: temp-releases.deletereleasereaction with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - type: mcp namespace: temp-releases-mcp port: 9090 transport: http description: MCP adapter for GitHub Repos API — Releases. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: list-releases description: List Releases hints: readOnly: true destructive: false idempotent: true call: temp-releases.listreleases with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: create-release description: Create Release hints: readOnly: false destructive: false idempotent: false call: temp-releases.createrelease with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept body: tools.body outputParameters: - type: object mapping: $. - name: get-release-asset description: Get Release Asset hints: readOnly: true destructive: false idempotent: true call: temp-releases.getreleaseasset with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: update-release-asset description: Update Release Asset hints: readOnly: false destructive: false idempotent: true call: temp-releases.updatereleaseasset with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept body: tools.body outputParameters: - type: object mapping: $. - name: delete-release-asset description: Delete Release Asset hints: readOnly: false destructive: true idempotent: true call: temp-releases.deletereleaseasset with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: generate-release-notes-content-release description: Generate Release Notes Content For Release hints: readOnly: false destructive: false idempotent: false call: temp-releases.generatereleasenotescontentforrelease with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept body: tools.body outputParameters: - type: object mapping: $. - name: get-latest-release description: Get The Latest Release hints: readOnly: true destructive: false idempotent: true call: temp-releases.getthelatestrelease with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: get-release-tag-name description: Get Release By Tag Name hints: readOnly: true destructive: false idempotent: true call: temp-releases.getreleasebytagname with: tag: tools.tag Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: get-release description: Get Release hints: readOnly: true destructive: false idempotent: true call: temp-releases.getrelease with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: update-release description: Update Release hints: readOnly: false destructive: false idempotent: true call: temp-releases.updaterelease with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept body: tools.body outputParameters: - type: object mapping: $. - name: delete-release description: Delete Release hints: readOnly: false destructive: true idempotent: true call: temp-releases.deleterelease with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: list-release-assets description: List Release Assets hints: readOnly: true destructive: false idempotent: true call: temp-releases.listreleaseassets with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: upload-release-asset description: Upload Release Asset hints: readOnly: false destructive: false idempotent: false call: temp-releases.uploadreleaseasset with: name: tools.name label: tools.label Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept body: tools.body outputParameters: - type: object mapping: $. - name: list-reactions-release description: List Reactions For Release hints: readOnly: true destructive: false idempotent: true call: temp-releases.listreactionsforrelease with: content: tools.content Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: create-reaction-release description: Create Reaction For Release hints: readOnly: false destructive: false idempotent: false call: temp-releases.createreactionforrelease with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept body: tools.body outputParameters: - type: object mapping: $. - name: delete-release-reaction description: Delete Release Reaction hints: readOnly: false destructive: true idempotent: true call: temp-releases.deletereleasereaction with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $.