{"openapi":"3.1.0","info":{"title":"Kong Konnect Service Catalog (BYOK) API","version":"0.1.0","description":"Kong Konnect Service Catalog (BYOK) lets an AI assistant read your own Kong Konnect Service Catalog data through the Kong Konnect Service Catalog API with a key you supply (Konnect personal or system account access token). Read-only: 11 tools (list_catalog_services, get_catalog_service, list_catalog_service_resources, list_catalog_service_scorecards, list_resource_mappings,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-kong-konnect-service-catalog.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-kong-konnect-service-catalog/docs"},"termsOfService":"https://connectorbay.com/byok-kong-konnect-service-catalog/terms"},"servers":[{"url":"https://byok-kong-konnect-service-catalog.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-kong-konnect-service-catalog/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/list_catalog_services":{"post":{"operationId":"list_catalog_services","summary":"List the services in the Konnect Service Catalog with display name, description and labels. Use for \"Which services are ","description":"List the services in the Konnect Service Catalog with display name, description and labels. Use for \"Which services are in our Kong service catalog\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"},"sort":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as 'name' or 'created_at desc'.","title":"Sort"}},"required":["region"],"title":"list_catalog_servicesArguments","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_catalog_service":{"post":{"operationId":"get_catalog_service","summary":"Get one catalog service with description, labels and timestamps. Use for \"Who owns the orders service in the Kong catalo","description":"Get one catalog service with description, labels and timestamps. Use for \"Who owns the orders service in the Kong catalog\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"service_id":{"description":"Catalog service id (UUID) from list_catalog_services.","maxLength":64,"title":"Service Id","type":"string"}},"required":["region","service_id"],"title":"get_catalog_serviceArguments","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_catalog_service_resources":{"post":{"operationId":"list_catalog_service_resources","summary":"List the resources (repositories, pipelines and similar) linked to one catalog service. Use for \"Which repositories are ","description":"List the resources (repositories, pipelines and similar) linked to one catalog service. Use for \"Which repositories are linked to the orders service\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"service_id":{"description":"Catalog service id (UUID) from list_catalog_services.","maxLength":64,"title":"Service Id","type":"string"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"}},"required":["region","service_id"],"title":"list_catalog_service_resourcesArguments","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_catalog_service_scorecards":{"post":{"operationId":"list_catalog_service_scorecards","summary":"List the scorecards that apply to one catalog service with the service's score on each. Use for \"How does the orders ser","description":"List the scorecards that apply to one catalog service with the service's score on each. Use for \"How does the orders service score on our scorecards\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"service_id":{"description":"Catalog service id (UUID) from list_catalog_services.","maxLength":64,"title":"Service Id","type":"string"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"},"sort":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as 'name' or 'created_at desc'.","title":"Sort"}},"required":["region","service_id"],"title":"list_catalog_service_scorecardsArguments","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_resource_mappings":{"post":{"operationId":"list_resource_mappings","summary":"List mappings between integration resources and catalog services. Use for \"Which resources are mapped to which catalog s","description":"List mappings between integration resources and catalog services. Use for \"Which resources are mapped to which catalog services\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"},"sort":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as 'name' or 'created_at desc'.","title":"Sort"}},"required":["region"],"title":"list_resource_mappingsArguments","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_integration_instances":{"post":{"operationId":"list_integration_instances","summary":"List configured integration instances (for example a GitHub or PagerDuty connection) with authorization state; configura","description":"List configured integration instances (for example a GitHub or PagerDuty connection) with authorization state; configuration values are not returned. Use for \"Which integrations are connected to our Kong service catalog\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"},"sort":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as 'name' or 'created_at desc'.","title":"Sort"}},"required":["region"],"title":"list_integration_instancesArguments","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_scorecards":{"post":{"operationId":"list_scorecards","summary":"List scorecards with the overall score, the template they use and timestamps. Use for \"Which scorecards are defined in o","description":"List scorecards with the overall score, the template they use and timestamps. Use for \"Which scorecards are defined in our Kong service catalog\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"},"sort":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as 'name' or 'created_at desc'.","title":"Sort"}},"required":["region"],"title":"list_scorecardsArguments","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_scorecard":{"post":{"operationId":"get_scorecard","summary":"Get one scorecard with its score and the criteria it evaluates. Use for \"What criteria does the Production readiness sco","description":"Get one scorecard with its score and the criteria it evaluates. Use for \"What criteria does the Production readiness scorecard check\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"scorecard_id":{"description":"Scorecard id (UUID) from list_scorecards.","maxLength":64,"title":"Scorecard Id","type":"string"}},"required":["region","scorecard_id"],"title":"get_scorecardArguments","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_scorecard_criteria":{"post":{"operationId":"list_scorecard_criteria","summary":"List the criteria of a scorecard with enabled flag, section and the evaluation result. Use for \"Which criteria of the Pr","description":"List the criteria of a scorecard with enabled flag, section and the evaluation result. Use for \"Which criteria of the Production readiness scorecard are failing\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"scorecard_id":{"description":"Scorecard id (UUID) from list_scorecards.","maxLength":64,"title":"Scorecard Id","type":"string"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"},"sort":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as 'name' or 'created_at desc'.","title":"Sort"}},"required":["region","scorecard_id"],"title":"list_scorecard_criteriaArguments","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_scorecard_services":{"post":{"operationId":"list_scorecard_services","summary":"List the catalog services a scorecard applies to with each service's score. Use for \"Which services score lowest on the ","description":"List the catalog services a scorecard applies to with each service's score. Use for \"Which services score lowest on the Production readiness scorecard\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"scorecard_id":{"description":"Scorecard id (UUID) from list_scorecards.","maxLength":64,"title":"Scorecard Id","type":"string"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"},"sort":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as 'name' or 'created_at desc'.","title":"Sort"}},"required":["region","scorecard_id"],"title":"list_scorecard_servicesArguments","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_scorecard_templates":{"post":{"operationId":"list_scorecard_templates","summary":"List the built-in scorecard templates with their criteria. Use for \"Which scorecard templates can I start from in Kong s","description":"List the built-in scorecard templates with their criteria. Use for \"Which scorecard templates can I start from in Kong service catalog\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"},"sort":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as 'name' or 'created_at desc'.","title":"Sort"}},"required":["region"],"title":"list_scorecard_templatesArguments","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}}}}