{"openapi":"3.1.0","info":{"title":"GitHub Meta (BYOK) API","version":"0.1.0","description":"GitHub Meta (BYOK) lets an AI assistant read your own GitHub Meta data through the GitHub Meta API with a key you supply (GitHub personal access token (no scopes needed)). Read-only: 6 tools (get_rate_limit_status, get_github_meta, list_licenses, get_license, get_repository_license, list_codes_of_conduct). The BYOK key travels with each request, is used for that one call only and is never stored,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-github-meta.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-github-meta/docs"},"termsOfService":"https://connectorbay.com/byok-github-meta/terms"},"servers":[{"url":"https://byok-github-meta.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-github-meta/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_rate_limit_status":{"post":{"operationId":"get_rate_limit_status","summary":"Show the remaining API calls and reset time of the key for every GitHub rate limit bucket (core, search, code search, Gr","description":"Show the remaining API calls and reset time of the key for every GitHub rate limit bucket (core, search, code search, GraphQL and others). Reading this does not use up calls. Use for \"How many search and core GitHub API calls do I have left right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_rate_limit_statusArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_github_meta":{"post":{"operationId":"get_github_meta","summary":"Get GitHub's published SSH key fingerprints and the IP address ranges (CIDR blocks) used by webhooks, the web, the API, ","description":"Get GitHub's published SSH key fingerprints and the IP address ranges (CIDR blocks) used by webhooks, the web, the API, git, pages, importer and package services. Use for \"What IP ranges does GitHub send webhooks from\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_github_metaArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_licenses":{"post":{"operationId":"list_licenses","summary":"List the commonly used open source licenses GitHub knows with key, name and SPDX ID; optionally only the featured ones. ","description":"List the commonly used open source licenses GitHub knows with key, name and SPDX ID; optionally only the featured ones. Use for \"Which open source licenses does GitHub offer when creating a repository\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"featured":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to list only the featured licenses.","title":"Featured"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":30,"description":"How many results to return (1 to 100, default 30).","title":"Per Page"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"list_licensesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_license":{"post":{"operationId":"get_license","summary":"Get one license by its key (for example mit or apache-2.0): description, what it permits, requires and limits, and wheth","description":"Get one license by its key (for example mit or apache-2.0): description, what it permits, requires and limits, and whether it is featured; the full license text is left out. Use for \"What does the Apache 2.0 license permit and require\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"license":{"description":"License key in lowercase, for example 'mit', 'apache-2.0' or 'gpl-3.0'.","maxLength":200,"title":"License","type":"string"}},"required":["license"],"title":"get_licenseArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_repository_license":{"post":{"operationId":"get_repository_license","summary":"Get the license detected for a repository: license key, name, SPDX ID and the license file's path and size. Use for \"Whi","description":"Get the license detected for a repository: license key, name, SPDX ID and the license file's path and size. Use for \"Which license does octocat/Hello-World use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"owner":{"description":"Account that owns the repository (user or organization login), for example 'octocat'.","maxLength":200,"title":"Owner","type":"string"},"repo":{"description":"Repository name without the owner, for example 'Hello-World'.","maxLength":200,"title":"Repo","type":"string"}},"required":["owner","repo"],"title":"get_repository_licenseArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_codes_of_conduct":{"post":{"operationId":"list_codes_of_conduct","summary":"List the codes of conduct GitHub offers as templates with key, name and URL; the full text is left out. Use for \"Which c","description":"List the codes of conduct GitHub offers as templates with key, name and URL; the full text is left out. Use for \"Which codes of conduct can I add to a GitHub repository\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_codes_of_conductArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}