{"openapi":"3.1.0","info":{"title":"Confluent Cloud (BYOK) API","version":"0.1.0","description":"Confluent Cloud (BYOK) lets an AI assistant read your own Confluent Cloud data through the Confluent Cloud API with a key you supply (Cloud API key ID). Read-only: 10 tools (list_environments, get_environment, list_kafka_clusters, get_kafka_cluster, list_flink_compute_pools, list_schema_registry_clusters, list_ksqldb_clusters, list_service_accounts, list_users, list_organizations). The BYOK key...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-confluent-cloud.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-confluent-cloud/docs"},"termsOfService":"https://connectorbay.com/byok-confluent-cloud/terms"},"servers":[{"url":"https://byok-confluent-cloud.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-confluent-cloud/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_environments":{"post":{"operationId":"list_environments","summary":"List the environments of the organization with their id, display name and Stream Governance package. Environments contai","description":"List the environments of the organization with their id, display name and Stream Governance package. Environments contain the Kafka clusters. Use for \"Which Confluent Cloud environments do we have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"title":"list_environmentsArguments","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_environment":{"post":{"operationId":"get_environment","summary":"Get one environment by id: display name and Stream Governance package. Use for \"Show details of environment env-abc123\".","description":"Get one environment by id: display name and Stream Governance package. Use for \"Show details of environment env-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Environment id, for example 'env-abc123'.","maxLength":200,"title":"Id","type":"string"}},"required":["id"],"title":"get_environmentArguments","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_kafka_clusters":{"post":{"operationId":"list_kafka_clusters","summary":"List the Kafka clusters of one environment with cloud, region, availability, bootstrap endpoint and phase. Use for \"Whic","description":"List the Kafka clusters of one environment with cloud, region, availability, bootstrap endpoint and phase. Use for \"Which Kafka clusters are in environment env-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"environment":{"description":"Environment id (starts with env-), for example 'env-abc123'. List environments first to find it.","maxLength":200,"title":"Environment","type":"string"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"required":["environment"],"title":"list_kafka_clustersArguments","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_kafka_cluster":{"post":{"operationId":"get_kafka_cluster","summary":"Get one Kafka cluster by id: cloud, region, endpoints, deletion protection and phase. Use for \"Show details of Kafka clu","description":"Get one Kafka cluster by id: cloud, region, endpoints, deletion protection and phase. Use for \"Show details of Kafka cluster lkc-abc12\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Kafka cluster id, for example 'lkc-abc12'.","maxLength":200,"title":"Id","type":"string"},"environment":{"description":"Environment id (starts with env-), for example 'env-abc123'. List environments first to find it.","maxLength":200,"title":"Environment","type":"string"}},"required":["id","environment"],"title":"get_kafka_clusterArguments","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_flink_compute_pools":{"post":{"operationId":"list_flink_compute_pools","summary":"List the Flink compute pools of one environment with cloud, region, maximum CFU and current CFU. Use for \"What Flink com","description":"List the Flink compute pools of one environment with cloud, region, maximum CFU and current CFU. Use for \"What Flink compute pools exist in environment env-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"environment":{"description":"Environment id (starts with env-), for example 'env-abc123'. List environments first to find it.","maxLength":200,"title":"Environment","type":"string"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"required":["environment"],"title":"list_flink_compute_poolsArguments","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_schema_registry_clusters":{"post":{"operationId":"list_schema_registry_clusters","summary":"List the Schema Registry clusters of one environment with package, cloud, region and endpoint. Use for \"Which Schema Reg","description":"List the Schema Registry clusters of one environment with package, cloud, region and endpoint. Use for \"Which Schema Registry clusters exist in environment env-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"environment":{"description":"Environment id (starts with env-), for example 'env-abc123'. List environments first to find it.","maxLength":200,"title":"Environment","type":"string"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"required":["environment"],"title":"list_schema_registry_clustersArguments","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_ksqldb_clusters":{"post":{"operationId":"list_ksqldb_clusters","summary":"List the ksqlDB clusters of one environment with size (CSU), HTTP endpoint and paused state. Use for \"Which ksqlDB clust","description":"List the ksqlDB clusters of one environment with size (CSU), HTTP endpoint and paused state. Use for \"Which ksqlDB clusters run in environment env-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"environment":{"description":"Environment id (starts with env-), for example 'env-abc123'. List environments first to find it.","maxLength":200,"title":"Environment","type":"string"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"required":["environment"],"title":"list_ksqldb_clustersArguments","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_service_accounts":{"post":{"operationId":"list_service_accounts","summary":"List service accounts of the organization with id, name and description. Use for \"Which service accounts exist in Conflu","description":"List service accounts of the organization with id, name and description. Use for \"Which service accounts exist in Confluent Cloud\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"display_name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only service accounts whose name matches this text exactly.","title":"Display Name"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"title":"list_service_accountsArguments","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_users":{"post":{"operationId":"list_users","summary":"List the organization's users with id, email, full name and authentication type. Use for \"Who are the users of our Confl","description":"List the organization's users with id, email, full name and authentication type. Use for \"Who are the users of our Confluent Cloud organization\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"title":"list_usersArguments","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_organizations":{"post":{"operationId":"list_organizations","summary":"List the organizations the key can see with id, name and whether just-in-time provisioning and SCIM are enabled. Use for","description":"List the organizations the key can see with id, name and whether just-in-time provisioning and SCIM are enabled. Use for \"What is my Confluent Cloud organization called\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"title":"list_organizationsArguments","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}}}}