mcp-aiven 0.1.5

package/generator/schemas/api-schemas.json

@@ -0,0 +1,2106 @@
+{
+  "aiven_project_list": {
+    "schema": {
+      "type": "object",
+      "properties": {}
+    },
+    "strict": true,
+    "title": "Project List",
+    "description": "List all Aiven projects. ALWAYS call this first to get valid `project` names — never guess project names."
+  },
+  "aiven_project_get": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project"
+      ]
+    },
+    "strict": true,
+    "title": "Project Get",
+    "description": "Get project details"
+  },
+  "aiven_list_project_clouds": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project"
+      ]
+    },
+    "strict": true,
+    "title": "List Project Clouds",
+    "description": "List cloud platforms for a project\n\nReturns a list of cloud platforms available for a project."
+  },
+  "aiven_service_list": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project"
+      ]
+    },
+    "strict": true,
+    "title": "Service List",
+    "description": "List services in a project. `project` must be a valid Aiven project name from `aiven_project_list`."
+  },
+  "aiven_service_type_plans": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_type": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_type"
+      ]
+    },
+    "strict": true,
+    "title": "Service Type Plans",
+    "description": "List available plans for a service type. Requires `project` — use `aiven_project_list` first if unknown.\n\nEach plan may include **`regions`** (and sometimes **`clouds`**) describing where that plan can run. Use those fields to show the user **which cloud names** (e.g. `do-fra`, `aws-eu-central-1`) are valid for their chosen plan before calling `aiven_service_create`.\n\n**Pricing is not included in this response.** Prices vary by cloud region. Use `aiven_service_plan_pricing` to get pricing for a specific plan and cloud."
+  },
+  "aiven_service_plan_pricing": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_type": {
+          "type": "string"
+        },
+        "service_plan": {
+          "type": "string"
+        },
+        "cloud": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_type",
+        "service_plan",
+        "cloud"
+      ]
+    },
+    "strict": true,
+    "title": "Service Plan Pricing",
+    "description": "Get pricing for a specific service plan in a specific cloud region. Returns hourly USD price.\n\nUse `aiven_service_type_plans` to list available plans, and `aiven_list_project_clouds` to list available clouds."
+  },
+  "aiven_service_create": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "cloud": {
+          "type": "string",
+          "description": "Target cloud",
+          "maxLength": 256
+        },
+        "copy_tags": {
+          "type": "boolean",
+          "description": "If this is a forked service, copy tags from the source service. If request contains additional tags, the tags copied from source are updated with them.",
+          "default": false
+        },
+        "disk_space_mb": {
+          "type": "integer",
+          "description": "Megabytes of disk space for data storage",
+          "minimum": 0
+        },
+        "group_name": {
+          "type": "string",
+          "description": "Service group name (DEPRECATED: do not use)",
+          "maxLength": 256
+        },
+        "maintenance": {
+          "type": "object",
+          "properties": {
+            "dow": {
+              "enum": [
+                "monday",
+                "tuesday",
+                "wednesday",
+                "thursday",
+                "friday",
+                "saturday",
+                "sunday"
+              ],
+              "description": "Day of week for installing updates"
+            },
+            "time": {
+              "type": "string",
+              "description": "Time for installing updates, UTC",
+              "minLength": 8,
+              "maxLength": 8
+            }
+          },
+          "description": "Automatic maintenance settings"
+        },
+        "plan": {
+          "type": "string",
+          "description": "Subscription plan",
+          "maxLength": 128
+        },
+        "project_vpc_id": {
+          "type": "string",
+          "description": "Project VPC ID",
+          "minLength": 36,
+          "maxLength": 36
+        },
+        "service_integrations": {
+          "type": "array",
+          "description": "Service integrations to enable for the service. Some integration types affect how a service is created and they must be provided as part of the creation call instead of being defined later.",
+          "items": {
+            "type": "object",
+            "properties": {
+              "dest_endpoint_id": {
+                "type": "string",
+                "description": "Integration destination endpoint ID",
+                "maxLength": 36
+              },
+              "dest_project": {
+                "type": "string",
+                "description": "Defaults to project in the request path",
+                "maxLength": 63
+              },
+              "dest_service": {
+                "type": "string",
+                "description": "Destination service name",
+                "maxLength": 64
+              },
+              "integration_type": {
+                "enum": [
+                  "alertmanager",
+                  "application_service_credential",
+                  "autoscaler",
+                  "autoscaler_service",
+                  "caching",
+                  "clickhouse_credentials",
+                  "clickhouse_kafka",
+                  "clickhouse_postgresql",
+                  "dashboard",
+                  "datadog",
+                  "datasource",
+                  "disaster_recovery",
+                  "external_aws_cloudwatch_logs",
+                  "external_aws_cloudwatch_metrics",
+                  "external_elasticsearch_logs",
+                  "external_google_cloud_logging",
+                  "external_opensearch_logs",
+                  "flink",
+                  "flink_external_bigquery",
+                  "flink_external_kafka",
+                  "flink_external_postgresql",
+                  "internal_connectivity",
+                  "jolokia",
+                  "kafka_connect",
+                  "kafka_connect_postgresql",
+                  "kafka_inkless_postgresql",
+                  "kafka_logs",
+                  "kafka_mirrormaker",
+                  "logs",
+                  "metrics",
+                  "opensearch_cross_cluster_replication",
+                  "opensearch_cross_cluster_search",
+                  "prometheus",
+                  "read_replica",
+                  "rsyslog",
+                  "schema_registry_proxy",
+                  "service_composition",
+                  "stresstester",
+                  "thanos_distributed_query",
+                  "thanos_migrate",
+                  "thanos_object_storage",
+                  "thanoscompactor",
+                  "thanosquery",
+                  "thanosruler",
+                  "thanosstore",
+                  "vector",
+                  "vmalert"
+                ],
+                "description": "Service integration type"
+              },
+              "source_endpoint_id": {
+                "type": "string",
+                "description": "Integration source endpoint ID",
+                "maxLength": 36
+              },
+              "source_project": {
+                "type": "string",
+                "description": "Defaults to project in the request path",
+                "maxLength": 63
+              },
+              "source_service": {
+                "type": "string",
+                "description": "Source service name",
+                "maxLength": 64
+              },
+              "user_config": {
+                "type": "object",
+                "additionalProperties": true
+              }
+            },
+            "required": [
+              "integration_type"
+            ]
+          }
+        },
+        "service_name": {
+          "type": "string",
+          "description": "Service name",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "service_type": {
+          "type": "string",
+          "description": "Service type code",
+          "maxLength": 64
+        },
+        "static_ips": {
+          "type": "array",
+          "description": "Static IP addresses to associate with the service",
+          "items": {
+            "type": "string"
+          }
+        },
+        "tags": {
+          "type": "object",
+          "additionalProperties": true
+        },
+        "tech_emails": {
+          "type": "array",
+          "description": "List of service technical email addresses",
+          "items": {
+            "type": "object",
+            "properties": {
+              "email": {
+                "type": "string",
+                "description": "User email address",
+                "maxLength": 254
+              }
+            },
+            "required": [
+              "email"
+            ]
+          }
+        },
+        "termination_protection": {
+          "type": "boolean",
+          "description": "Service is protected against termination and powering off"
+        },
+        "user_config": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      },
+      "required": [
+        "project",
+        "plan",
+        "service_name",
+        "service_type"
+      ]
+    },
+    "strict": false,
+    "title": "Service Create",
+    "description": "Create a new Aiven service. Always call `aiven_service_type_plans` first, present plans to the user, and let them choose before creating. Do not pick a plan yourself.\n\n**Cloud (`cloud`) — never guess or silently default.** After the user picks a plan, show valid cloud names from that plan’s **`regions` / `clouds`** in the `aiven_service_type_plans` response and **ask which cloud they want**. Do not invent a region (e.g. do not assume `do-fra`). If per-plan clouds are unclear, call `aiven_list_project_clouds` and still require an **explicit user choice** unless they told you to use a specific cloud or the project’s default.\n\nFor PostgreSQL, set `user_config: {\"pg_version\": \"17\"}`. After creation, tell the user the service is provisioning (takes a few minutes) and ask them to tell you when to check the status. Do NOT poll `aiven_service_get` in a loop.\n\n**Read replica:** set `service_to_fork_from` to the primary and `user_config.pg_read_replica: true`."
+  },
+  "aiven_service_get": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name"
+      ]
+    },
+    "strict": true,
+    "title": "Service Get",
+    "description": "Get service information. `project` must be a valid Aiven project name from `aiven_project_list`.\nIf the service `state` is not `RUNNING`, return the status to the user and stop. Do NOT call this tool again in a loop — let the user decide when to re-check."
+  },
+  "aiven_service_update": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "allow_unclean_poweroff": {
+          "type": "boolean",
+          "default": true
+        },
+        "cloud": {
+          "type": "string",
+          "description": "Target cloud",
+          "maxLength": 256
+        },
+        "disk_space_mb": {
+          "type": "integer",
+          "description": "Megabytes of disk space for data storage",
+          "minimum": 0
+        },
+        "group_name": {
+          "type": "string",
+          "description": "Service group name (DEPRECATED: do not use)",
+          "maxLength": 256
+        },
+        "karapace": {
+          "type": "boolean",
+          "description": "Switch the service to use Karapace for schema registry and REST proxy"
+        },
+        "maintenance": {
+          "type": "object",
+          "properties": {
+            "dow": {
+              "enum": [
+                "monday",
+                "tuesday",
+                "wednesday",
+                "thursday",
+                "friday",
+                "saturday",
+                "sunday"
+              ],
+              "description": "Day of week for installing updates"
+            },
+            "time": {
+              "type": "string",
+              "description": "Time for installing updates, UTC",
+              "minLength": 8,
+              "maxLength": 8
+            }
+          },
+          "description": "Automatic maintenance settings"
+        },
+        "plan": {
+          "type": "string",
+          "description": "Subscription plan",
+          "maxLength": 128
+        },
+        "powered": {
+          "type": "boolean",
+          "description": "Power-on the service (true) or power-off (false)"
+        },
+        "project_vpc_id": {
+          "type": "string",
+          "description": "Project VPC ID",
+          "minLength": 36,
+          "maxLength": 36
+        },
+        "schema_registry_authz": {
+          "type": "boolean",
+          "description": "Enable or disable Schema Registry authorization"
+        },
+        "tech_emails": {
+          "type": "array",
+          "description": "List of service technical email addresses",
+          "items": {
+            "type": "object",
+            "properties": {
+              "email": {
+                "type": "string",
+                "description": "User email address",
+                "maxLength": 254
+              }
+            },
+            "required": [
+              "email"
+            ]
+          }
+        },
+        "termination_protection": {
+          "type": "boolean",
+          "description": "Service is protected against termination and powering off"
+        },
+        "user_config": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      },
+      "required": [
+        "project",
+        "service_name"
+      ]
+    },
+    "strict": false,
+    "title": "Service Update",
+    "description": "Update an existing Aiven service.\n\nCan change: plan, cloud region, user configuration, power state.\n\n**Warning:** Plan changes may cause brief service downtime during migration. Confirm with the user before changing plans.\n\n**Common user_config changes:**\n\nEnable Kafka Connect on a Kafka service:\n```\naiven_service_update(project=\"my-project\", service_name=\"my-kafka\",\n  user_config={\"kafka_connect\": true})\n```\n\nEnable Schema Registry (Karapace) on a Kafka service:\n```\naiven_service_update(project=\"my-project\", service_name=\"my-kafka\",\n  user_config={\"schema_registry\": true})\n```\n\nEnable tiered storage on a Kafka service:\n```\naiven_service_update(project=\"my-project\", service_name=\"my-kafka\",\n  user_config={\"tiered_storage\": {\"enabled\": true}})\n```\n\nSet PostgreSQL version:\n```\naiven_service_update(project=\"my-project\", service_name=\"my-pg\",\n  user_config={\"pg_version\": \"17\"})\n```"
+  },
+  "aiven_project_get_service_logs": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "limit": {
+          "type": "integer",
+          "description": "How many log entries to receive at most",
+          "minimum": 1,
+          "maximum": 500,
+          "default": 100
+        },
+        "offset": {
+          "type": "string",
+          "description": "Opaque offset identifier",
+          "maxLength": 128
+        },
+        "sort_order": {
+          "enum": [
+            "desc",
+            "asc"
+          ],
+          "description": "Sort order for log messages"
+        }
+      },
+      "required": [
+        "project",
+        "service_name"
+      ]
+    },
+    "strict": false,
+    "title": "Project Get Service Logs",
+    "description": "Get service log entries"
+  },
+  "aiven_service_query_activity": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "limit": {
+          "type": "integer",
+          "description": "Limit for number of results",
+          "minimum": 1,
+          "maximum": 5000,
+          "default": 100
+        },
+        "offset": {
+          "type": "integer",
+          "description": "Offset for retrieved results based on sort order",
+          "minimum": 0,
+          "default": 0
+        },
+        "order_by": {
+          "type": "string",
+          "description": "Sort order can be either asc or desc and multiple comma separated columns with their own order can be specified: :asc,:desc.",
+          "maxLength": 256,
+          "default": "client_id:desc"
+        }
+      },
+      "required": [
+        "project",
+        "service_name"
+      ]
+    },
+    "strict": false,
+    "title": "Service Query Activity",
+    "description": "Fetch current queries for the service"
+  },
+  "aiven_service_metrics_fetch": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "kafka_topic_name": {
+          "type": "string",
+          "description": "Metrics at Kafka service topic level",
+          "maxLength": 249
+        },
+        "period": {
+          "enum": [
+            "hour",
+            "day",
+            "week",
+            "month",
+            "year"
+          ],
+          "description": "Metrics time period"
+        }
+      },
+      "required": [
+        "project",
+        "service_name"
+      ]
+    },
+    "strict": false,
+    "title": "Service Metrics Fetch",
+    "description": "Fetch metrics for **managed data services** (PostgreSQL, Kafka, OpenSearch, etc.) — i.e. not `service_type: application`.\n\n**Do not use** for **application** services (custom apps deployed as an Aiven “application” service). For those, use **`aiven_service_application_metrics_get`** instead (GET `…/application/metrics`). If unsure, call `aiven_service_get` first and check `service_type`.\n\nUse `period` to control the time window: `hour`, `day`, `week`, `month`, or `year`.\nFor Kafka services, optionally pass `kafka_topic_name` to get topic-level metrics.\n\n**Display format:** Render ALL metrics as a single ASCII dashboard using box-drawing characters (┌─┐│└┘) and progress bars (█░). One section per metric group. Show every metric returned — do not summarize or omit. Do NOT use markdown tables or bullet points. Do NOT generate scripts. Render directly as text. Add a blank line between each metric row for readability."
+  },
+  "aiven_service_application_metrics_get": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name"
+      ]
+    },
+    "strict": true,
+    "title": "Service Application Metrics Get",
+    "description": "**Preferred tool** when the user asks for **application** metrics, or the target is an **application** service (`service_type: application`).\n\nCalls **`GET …/application/metrics`**. Do **not** use `aiven_service_metrics_fetch` for these — that tool targets **`POST …/metrics`** for managed data services only.\n\nIf the service type is unknown, call **`aiven_service_get`** first, then choose this tool if `service_type` is `application`."
+  },
+  "aiven_project_vpc_list": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project"
+      ]
+    },
+    "strict": true,
+    "title": "Project Vpc List",
+    "description": "List VPCs for a project. Returns each VPC's ID, cloud, state, and network CIDR.\n\nUse this when deploying an application service fails with \"please specify project_vpc_id\" (i.e. the project has multiple active VPCs). List them, show the user the options, and let them pick which VPC to deploy into.\n\nVPCs with state `ACTIVE` are ready to use. Pass the chosen `project_vpc_id` to `aiven_application_deploy`."
+  },
+  "aiven_project_get_event_logs": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project"
+      ]
+    },
+    "strict": true,
+    "title": "Project Get Event Logs",
+    "description": "Get project event log entries"
+  },
+  "aiven_service_integration_list": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name"
+      ]
+    },
+    "strict": true,
+    "title": "Service Integration List",
+    "description": "List all integrations for a specific service. Returns both integrations where this service is the source and where it is the destination.\n\nUse this to see what metrics, logs, data pipeline, or replication integrations are active on a service."
+  },
+  "aiven_service_integration_create": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "dest_endpoint_id": {
+          "type": "string",
+          "description": "Integration destination endpoint ID",
+          "maxLength": 36
+        },
+        "dest_project": {
+          "type": "string",
+          "description": "Defaults to project in the request path",
+          "maxLength": 63
+        },
+        "dest_service": {
+          "type": "string",
+          "description": "Destination service name",
+          "maxLength": 64
+        },
+        "integration_type": {
+          "enum": [
+            "alertmanager",
+            "application_service_credential",
+            "autoscaler",
+            "autoscaler_service",
+            "caching",
+            "clickhouse_credentials",
+            "clickhouse_kafka",
+            "clickhouse_postgresql",
+            "dashboard",
+            "datadog",
+            "datasource",
+            "disaster_recovery",
+            "external_aws_cloudwatch_logs",
+            "external_aws_cloudwatch_metrics",
+            "external_elasticsearch_logs",
+            "external_google_cloud_logging",
+            "external_opensearch_logs",
+            "flink",
+            "flink_external_bigquery",
+            "flink_external_kafka",
+            "flink_external_postgresql",
+            "internal_connectivity",
+            "jolokia",
+            "kafka_connect",
+            "kafka_connect_postgresql",
+            "kafka_inkless_postgresql",
+            "kafka_logs",
+            "kafka_mirrormaker",
+            "logs",
+            "metrics",
+            "opensearch_cross_cluster_replication",
+            "opensearch_cross_cluster_search",
+            "prometheus",
+            "read_replica",
+            "rsyslog",
+            "schema_registry_proxy",
+            "service_composition",
+            "stresstester",
+            "thanos_distributed_query",
+            "thanos_migrate",
+            "thanos_object_storage",
+            "thanoscompactor",
+            "thanosquery",
+            "thanosruler",
+            "thanosstore",
+            "vector",
+            "vmalert"
+          ],
+          "description": "Service integration type"
+        },
+        "source_endpoint_id": {
+          "type": "string",
+          "description": "Integration source endpoint ID",
+          "maxLength": 36
+        },
+        "source_project": {
+          "type": "string",
+          "description": "Defaults to project in the request path",
+          "maxLength": 63
+        },
+        "source_service": {
+          "type": "string",
+          "description": "Source service name",
+          "maxLength": 64
+        },
+        "user_config": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      },
+      "required": [
+        "project",
+        "integration_type"
+      ]
+    },
+    "strict": false,
+    "title": "Service Integration Create",
+    "description": "Create a service integration between two Aiven services, or between an Aiven service and an external integration endpoint.\n\n**Before calling:** use `aiven_integration_types_list` to discover valid `integration_type` values and which source/destination service types each supports.\n\nProvide `source_service`/`dest_service` for Aiven-to-Aiven integrations, or use `source_endpoint_id`/`dest_endpoint_id` for external endpoints."
+  },
+  "aiven_service_integration_get": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "integration_id": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "integration_id"
+      ]
+    },
+    "strict": true,
+    "title": "Service Integration Get",
+    "description": "Get details for a specific service integration by ID. Returns the integration type, source and destination services, status, and configuration."
+  },
+  "aiven_service_integration_update": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "integration_id": {
+          "type": "string"
+        },
+        "user_config": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      },
+      "required": [
+        "project",
+        "integration_id",
+        "user_config"
+      ]
+    },
+    "strict": false,
+    "title": "Service Integration Update",
+    "description": "Update the configuration of an existing service integration.\n\nOnly `user_config` can be updated — you cannot change the integration type, source, or destination after creation. To change those, delete and recreate the integration."
+  },
+  "aiven_service_integration_delete": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "integration_id": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "integration_id"
+      ]
+    },
+    "strict": true,
+    "title": "Service Integration Delete",
+    "description": "Delete a service integration. This removes the connection between the source and destination services.\n\n**Warning:** Deleting an integration may disrupt data flows (metrics, logs, replication). Confirm with the user before proceeding."
+  },
+  "aiven_integration_types_list": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project"
+      ]
+    },
+    "strict": true,
+    "title": "Integration Types List",
+    "description": "List all available service integration types for a project. Returns the integration type name along with the valid source and destination service types for each.\n\n**Call this first** before creating an integration to understand which service types can be connected and in which direction."
+  },
+  "aiven_integration_endpoint_types_list": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project"
+      ]
+    },
+    "strict": true,
+    "title": "Integration Endpoint Types List",
+    "description": "List all available integration endpoint types for a project. Integration endpoints represent external services (e.g. Datadog, external Elasticsearch, Prometheus remote write, rsyslog, AWS CloudWatch, Google Cloud Logging).\n\nUse this to discover what external endpoint types can be created, then use `aiven_service_integration_create` with the endpoint ID to wire an Aiven service to the external system."
+  },
+  "aiven_kafka_topic_list": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name"
+      ]
+    },
+    "strict": true,
+    "title": "Topic List",
+    "description": "Get Kafka topic list"
+  },
+  "aiven_kafka_topic_create": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "cleanup_policy": {
+          "enum": [
+            "delete",
+            "compact",
+            "compact,delete"
+          ],
+          "description": "The retention policy to use on old segments. Possible values include 'delete', 'compact', or a comma-separated list of them. The default policy ('delete') will discard old segments when their retention time or size limit has been reached. The 'compact' setting will enable log compaction on the topic."
+        },
+        "config": {
+          "type": "object",
+          "properties": {
+            "cleanup_policy": {
+              "enum": [
+                "delete",
+                "compact",
+                "compact,delete"
+              ],
+              "description": "The retention policy to use on old segments. Possible values include 'delete', 'compact', or a comma-separated list of them. The default policy ('delete') will discard old segments when their retention time or size limit has been reached. The 'compact' setting will enable log compaction on the topic."
+            },
+            "compression_type": {
+              "enum": [
+                "snappy",
+                "gzip",
+                "lz4",
+                "producer",
+                "uncompressed",
+                "zstd"
+              ],
+              "description": "Specify the final compression type for a given topic. This configuration accepts the standard compression codecs ('gzip', 'snappy', 'lz4', 'zstd'). It additionally accepts 'uncompressed' which is equivalent to no compression; and 'producer' which means retain the original compression codec set by the producer."
+            },
+            "delete_retention_ms": {
+              "type": "integer",
+              "description": "The amount of time to retain delete tombstone markers for log compacted topics. This setting also gives a bound on the time in which a consumer must complete a read if they begin from offset 0 to ensure that they get a valid snapshot of the final stage (otherwise delete tombstones may be collected before they complete their scan).",
+              "minimum": 0
+            },
+            "diskless_enable": {
+              "type": "boolean",
+              "description": "Indicates whether diskless should be enabled. This is only available for BYOC services with Diskless feature enabled."
+            },
+            "file_delete_delay_ms": {
+              "type": "integer",
+              "description": "The time to wait before deleting a file from the filesystem.",
+              "minimum": 0
+            },
+            "flush_messages": {
+              "type": "integer",
+              "description": "This setting allows specifying an interval at which we will force an fsync of data written to the log. For example if this was set to 1 we would fsync after every message; if it were 5 we would fsync after every five messages. In general we recommend you not set this and use replication for durability and allow the operating system's background flush capabilities as it is more efficient.",
+              "minimum": 0
+            },
+            "flush_ms": {
+              "type": "integer",
+              "description": "This setting allows specifying a time interval at which we will force an fsync of data written to the log. For example if this was set to 1000 we would fsync after 1000 ms had passed. In general we recommend you not set this and use replication for durability and allow the operating system's background flush capabilities as it is more efficient.",
+              "minimum": 0
+            },
+            "index_interval_bytes": {
+              "type": "integer",
+              "description": "This setting controls how frequently Kafka adds an index entry to its offset index. The default setting ensures that we index a message roughly every 4096 bytes. More indexing allows reads to jump closer to the exact position in the log but makes the index larger. You probably don't need to change this.",
+              "minimum": 0
+            },
+            "local_retention_bytes": {
+              "type": "integer",
+              "description": "This configuration controls the maximum bytes tiered storage will retain segment files locally before it will discard old log segments to free up space. If set to -2, the limit is equal to overall retention time. If set to -1, no limit is applied but it's possible only if overall retention is also -1."
+            },
+            "local_retention_ms": {
+              "type": "integer",
+              "description": "This configuration controls the maximum time tiered storage will retain segment files locally before it will discard old log segments to free up space. If set to -2, the time limit is equal to overall retention time. If set to -1, no time limit is applied but it's possible only if overall retention is also -1."
+            },
+            "max_compaction_lag_ms": {
+              "type": "integer",
+              "description": "The maximum time a message will remain ineligible for compaction in the log. Only applicable for logs that are being compacted.",
+              "minimum": 0
+            },
+            "max_message_bytes": {
+              "type": "integer",
+              "description": "The largest record batch size allowed by Kafka (after compression if compression is enabled). If this is increased and there are consumers older than 0.10.2, the consumers' fetch size must also be increased so that the they can fetch record batches this large. In the latest message format version, records are always grouped into batches for efficiency. In previous message format versions, uncompressed records are not grouped into batches and this limit only applies to a single record in that case.",
+              "minimum": 0
+            },
+            "message_downconversion_enable": {
+              "type": "boolean",
+              "description": "This configuration controls whether down-conversion of message formats is enabled to satisfy consume requests. When set to false, broker will not perform down-conversion for consumers expecting an older message format. The broker responds with UNSUPPORTED_VERSION error for consume requests from such older clients. This configuration does not apply to any message format conversion that might be required for replication to followers."
+            },
+            "message_format_version": {
+              "enum": [
+                "0.8.0",
+                "0.8.1",
+                "0.8.2",
+                "0.9.0",
+                "0.10.0",
+                "0.10.0-IV0",
+                "0.10.0-IV1",
+                "0.10.1",
+                "0.10.1-IV0",
+                "0.10.1-IV1",
+                "0.10.1-IV2",
+                "0.10.2",
+                "0.10.2-IV0",
+                "0.11.0",
+                "0.11.0-IV0",
+                "0.11.0-IV1",
+                "0.11.0-IV2",
+                "1.0",
+                "1.0-IV0",
+                "1.1",
+                "1.1-IV0",
+                "2.0",
+                "2.0-IV0",
+                "2.0-IV1",
+                "2.1",
+                "2.1-IV0",
+                "2.1-IV1",
+                "2.1-IV2",
+                "2.2",
+                "2.2-IV0",
+                "2.2-IV1",
+                "2.3",
+                "2.3-IV0",
+                "2.3-IV1",
+                "2.4",
+                "2.4-IV0",
+                "2.4-IV1",
+                "2.5",
+                "2.5-IV0",
+                "2.6",
+                "2.6-IV0",
+                "2.7",
+                "2.7-IV0",
+                "2.7-IV1",
+                "2.7-IV2",
+                "2.8",
+                "2.8-IV0",
+                "2.8-IV1",
+                "3.0",
+                "3.0-IV0",
+                "3.0-IV1",
+                "3.1",
+                "3.1-IV0",
+                "3.2",
+                "3.2-IV0",
+                "3.3",
+                "3.3-IV0",
+                "3.3-IV1",
+                "3.3-IV2",
+                "3.3-IV3",
+                "3.4",
+                "3.4-IV0",
+                "3.5",
+                "3.5-IV0",
+                "3.5-IV1",
+                "3.5-IV2",
+                "3.6",
+                "3.6-IV0",
+                "3.6-IV1",
+                "3.6-IV2",
+                "3.7",
+                "3.7-IV0",
+                "3.7-IV1",
+                "3.7-IV2",
+                "3.7-IV3",
+                "3.7-IV4",
+                "3.8",
+                "3.8-IV0",
+                "3.9",
+                "3.9-IV0",
+                "3.9-IV1",
+                "4.0",
+                "4.0-IV0",
+                "4.1",
+                "4.1-IV0"
+              ],
+              "description": "Specify the message format version the broker will use to append messages to the logs. The value should be a valid ApiVersion. Some examples are: 0.8.2, 0.9.0.0, 0.10.0, check ApiVersion for more details. By setting a particular message format version, the user is certifying that all the existing messages on disk are smaller or equal than the specified version. Setting this value incorrectly will cause consumers with older versions to break as they will receive messages with a format that they don't understand. Deprecated in Kafka 4.0+: this configuration is removed and any supplied value will be ignored; for services upgraded to 4.0+, the returned value may be 'None'."
+            },
+            "message_timestamp_after_max_ms": {
+              "type": "integer",
+              "description": "The maximum difference allowed between the timestamp when a broker receives a message and the timestamp specified in the message. If message.timestamp.type=CreateTime, a message will be rejected if the difference in timestamp exceeds this threshold. Applies only for messages with timestamps later than the broker's timestamp.",
+              "minimum": 0
+            },
+            "message_timestamp_before_max_ms": {
+              "type": "integer",
+              "description": "The maximum difference allowed between the timestamp when a broker receives a message and the timestamp specified in the message. If message.timestamp.type=CreateTime, a message will be rejected if the difference in timestamp exceeds this threshold. Applies only for messages with timestamps earlier than the broker's timestamp.",
+              "minimum": 0
+            },
+            "message_timestamp_difference_max_ms": {
+              "type": "integer",
+              "description": "The maximum difference allowed between the timestamp when a broker receives a message and the timestamp specified in the message. If message.timestamp.type=CreateTime, a message will be rejected if the difference in timestamp exceeds this threshold. This configuration is ignored if message.timestamp.type=LogAppendTime.",
+              "minimum": 0
+            },
+            "message_timestamp_type": {
+              "enum": [
+                "CreateTime",
+                "LogAppendTime"
+              ],
+              "description": "Define whether the timestamp in the message is message create time or log append time."
+            },
+            "min_cleanable_dirty_ratio": {
+              "type": "number",
+              "description": "This configuration controls how frequently the log compactor will attempt to clean the log (assuming log compaction is enabled). By default we will avoid cleaning a log where more than 50% of the log has been compacted. This ratio bounds the maximum space wasted in the log by duplicates (at 50% at most 50% of the log could be duplicates). A higher ratio will mean fewer, more efficient cleanings but will mean more wasted space in the log. If the max.compaction.lag.ms or the min.compaction.lag.ms configurations are also specified, then the log compactor considers the log to be eligible for compaction as soon as either: (i) the dirty ratio threshold has been met and the log has had dirty (uncompacted) records for at least the min.compaction.lag.ms duration, or (ii) if the log has had dirty (uncompacted) records for at most the max.compaction.lag.ms period.",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "min_compaction_lag_ms": {
+              "type": "integer",
+              "description": "The minimum time a message will remain uncompacted in the log. Only applicable for logs that are being compacted.",
+              "minimum": 0
+            },
+            "min_insync_replicas": {
+              "type": "integer",
+              "description": "When a producer sets acks to 'all' (or '-1'), this configuration specifies the minimum number of replicas that must acknowledge a write for the write to be considered successful. If this minimum cannot be met, then the producer will raise an exception (either NotEnoughReplicas or NotEnoughReplicasAfterAppend). When used together, min.insync.replicas and acks allow you to enforce greater durability guarantees. A typical scenario would be to create a topic with a replication factor of 3, set min.insync.replicas to 2, and produce with acks of 'all'. This will ensure that the producer raises an exception if a majority of replicas do not receive a write.",
+              "minimum": 1
+            },
+            "preallocate": {
+              "type": "boolean",
+              "description": "True if we should preallocate the file on disk when creating a new log segment."
+            },
+            "remote_storage_enable": {
+              "type": "boolean",
+              "description": "Indicates whether tiered storage should be enabled. This is only available for services with Tiered Storage feature enabled."
+            },
+            "retention_bytes": {
+              "type": "integer",
+              "description": "This configuration controls the maximum size a partition (which consists of log segments) can grow to before we will discard old log segments to free up space if we are using the 'delete' retention policy. By default there is no size limit only a time limit. Since this limit is enforced at the partition level, multiply it by the number of partitions to compute the topic retention in bytes."
+            },
+            "retention_ms": {
+              "type": "integer",
+              "description": "This configuration controls the maximum time we will retain a log before we will discard old log segments to free up space if we are using the 'delete' retention policy. This represents an SLA on how soon consumers must read their data. If set to -1, no time limit is applied."
+            },
+            "segment_bytes": {
+              "type": "integer",
+              "description": "This configuration controls the segment file size for the log. Retention and cleaning is always done a file at a time so a larger segment size means fewer files but less granular control over retention. Setting this to a very low value has consequences, and the Aiven management plane ignores values less than 10 megabytes.",
+              "minimum": 14
+            },
+            "segment_index_bytes": {
+              "type": "integer",
+              "description": "This configuration controls the size of the index that maps offsets to file positions. We preallocate this index file and shrink it only after log rolls. You generally should not need to change this setting.",
+              "minimum": 0
+            },
+            "segment_jitter_ms": {
+              "type": "integer",
+              "description": "The maximum random jitter subtracted from the scheduled segment roll time to avoid thundering herds of segment rolling",
+              "minimum": 0
+            },
+            "segment_ms": {
+              "type": "integer",
+              "description": "This configuration controls the period of time after which Kafka will force the log to roll even if the segment file isn't full to ensure that retention can delete or compact old data. Setting this to a very low value has consequences, and the Aiven management plane ignores values less than 10 seconds.",
+              "minimum": 1
+            },
+            "unclean_leader_election_enable": {
+              "type": "boolean",
+              "description": "Indicates whether to enable replicas not in the ISR set to be elected as leader as a last resort, even though doing so may result in data loss."
+            }
+          },
+          "description": "Kafka topic configuration"
+        },
+        "min_insync_replicas": {
+          "type": "integer",
+          "description": "When a producer sets acks to 'all' (or '-1'), this configuration specifies the minimum number of replicas that must acknowledge a write for the write to be considered successful. If this minimum cannot be met, then the producer will raise an exception (either NotEnoughReplicas or NotEnoughReplicasAfterAppend). When used together, min.insync.replicas and acks allow you to enforce greater durability guarantees. A typical scenario would be to create a topic with a replication factor of 3, set min.insync.replicas to 2, and produce with acks of 'all'. This will ensure that the producer raises an exception if a majority of replicas do not receive a write.",
+          "minimum": 1
+        },
+        "owner_user_group_id": {
+          "type": "string",
+          "description": "The user group that owns this topic",
+          "minLength": 1,
+          "maxLength": 36
+        },
+        "partitions": {
+          "type": "integer",
+          "description": "Number of partitions",
+          "minimum": 1,
+          "maximum": 1000000
+        },
+        "replication": {
+          "type": "integer",
+          "description": "Number of replicas",
+          "minimum": 1
+        },
+        "retention_bytes": {
+          "type": "integer",
+          "description": "This configuration controls the maximum size a partition (which consists of log segments) can grow to before we will discard old log segments to free up space if we are using the 'delete' retention policy. By default there is no size limit only a time limit. Since this limit is enforced at the partition level, multiply it by the number of partitions to compute the topic retention in bytes."
+        },
+        "retention_hours": {
+          "type": "integer",
+          "description": "DEPRECATED: use config.retention_ms",
+          "maximum": 2562047788015
+        },
+        "tags": {
+          "type": "array",
+          "description": "Topic tags",
+          "items": {
+            "type": "object",
+            "properties": {
+              "key": {
+                "type": "string",
+                "description": "Tag key",
+                "minLength": 1,
+                "maxLength": 64
+              },
+              "value": {
+                "type": "string",
+                "description": "Tag value",
+                "minLength": 0,
+                "maxLength": 256
+              }
+            },
+            "required": [
+              "key",
+              "value"
+            ]
+          }
+        },
+        "topic_description": {
+          "type": "string",
+          "description": "Topic description",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "topic_name": {
+          "type": "string",
+          "description": "Topic name",
+          "minLength": 1,
+          "maxLength": 249
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "topic_name"
+      ]
+    },
+    "strict": false,
+    "title": "Topic Create",
+    "description": "Create a Kafka topic.\n\n**IMPORTANT:** Always include `partitions` and `replication` in the request. The API may accept them as optional but topics created without these fields may not work correctly.\n\nRecommended defaults:\n- `partitions`: 1 (or more depending on throughput needs)\n- `replication`: 3 (must not exceed the number of brokers in the cluster)\n\nAfter creation, do NOT immediately call `aiven_kafka_topic_get` or other tools on this topic. Tell the user the topic was created and will be available shortly."
+  },
+  "aiven_kafka_topic_get": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "topic_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "topic_name"
+      ]
+    },
+    "strict": true,
+    "title": "Topic Get",
+    "description": "Get Kafka topic info"
+  },
+  "aiven_kafka_topic_update": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "topic_name": {
+          "type": "string"
+        },
+        "config": {
+          "type": "object",
+          "properties": {
+            "cleanup_policy": {
+              "enum": [
+                "delete",
+                "compact",
+                "compact,delete"
+              ],
+              "description": "The retention policy to use on old segments. Possible values include 'delete', 'compact', or a comma-separated list of them. The default policy ('delete') will discard old segments when their retention time or size limit has been reached. The 'compact' setting will enable log compaction on the topic."
+            },
+            "compression_type": {
+              "enum": [
+                "snappy",
+                "gzip",
+                "lz4",
+                "producer",
+                "uncompressed",
+                "zstd"
+              ],
+              "description": "Specify the final compression type for a given topic. This configuration accepts the standard compression codecs ('gzip', 'snappy', 'lz4', 'zstd'). It additionally accepts 'uncompressed' which is equivalent to no compression; and 'producer' which means retain the original compression codec set by the producer."
+            },
+            "delete_retention_ms": {
+              "type": "integer",
+              "description": "The amount of time to retain delete tombstone markers for log compacted topics. This setting also gives a bound on the time in which a consumer must complete a read if they begin from offset 0 to ensure that they get a valid snapshot of the final stage (otherwise delete tombstones may be collected before they complete their scan).",
+              "minimum": 0
+            },
+            "diskless_enable": {
+              "type": "boolean",
+              "description": "Indicates whether diskless should be enabled. This is only available for BYOC services with Diskless feature enabled."
+            },
+            "file_delete_delay_ms": {
+              "type": "integer",
+              "description": "The time to wait before deleting a file from the filesystem.",
+              "minimum": 0
+            },
+            "flush_messages": {
+              "type": "integer",
+              "description": "This setting allows specifying an interval at which we will force an fsync of data written to the log. For example if this was set to 1 we would fsync after every message; if it were 5 we would fsync after every five messages. In general we recommend you not set this and use replication for durability and allow the operating system's background flush capabilities as it is more efficient.",
+              "minimum": 0
+            },
+            "flush_ms": {
+              "type": "integer",
+              "description": "This setting allows specifying a time interval at which we will force an fsync of data written to the log. For example if this was set to 1000 we would fsync after 1000 ms had passed. In general we recommend you not set this and use replication for durability and allow the operating system's background flush capabilities as it is more efficient.",
+              "minimum": 0
+            },
+            "index_interval_bytes": {
+              "type": "integer",
+              "description": "This setting controls how frequently Kafka adds an index entry to its offset index. The default setting ensures that we index a message roughly every 4096 bytes. More indexing allows reads to jump closer to the exact position in the log but makes the index larger. You probably don't need to change this.",
+              "minimum": 0
+            },
+            "local_retention_bytes": {
+              "type": "integer",
+              "description": "This configuration controls the maximum bytes tiered storage will retain segment files locally before it will discard old log segments to free up space. If set to -2, the limit is equal to overall retention time. If set to -1, no limit is applied but it's possible only if overall retention is also -1."
+            },
+            "local_retention_ms": {
+              "type": "integer",
+              "description": "This configuration controls the maximum time tiered storage will retain segment files locally before it will discard old log segments to free up space. If set to -2, the time limit is equal to overall retention time. If set to -1, no time limit is applied but it's possible only if overall retention is also -1."
+            },
+            "max_compaction_lag_ms": {
+              "type": "integer",
+              "description": "The maximum time a message will remain ineligible for compaction in the log. Only applicable for logs that are being compacted.",
+              "minimum": 0
+            },
+            "max_message_bytes": {
+              "type": "integer",
+              "description": "The largest record batch size allowed by Kafka (after compression if compression is enabled). If this is increased and there are consumers older than 0.10.2, the consumers' fetch size must also be increased so that the they can fetch record batches this large. In the latest message format version, records are always grouped into batches for efficiency. In previous message format versions, uncompressed records are not grouped into batches and this limit only applies to a single record in that case.",
+              "minimum": 0
+            },
+            "message_downconversion_enable": {
+              "type": "boolean",
+              "description": "This configuration controls whether down-conversion of message formats is enabled to satisfy consume requests. When set to false, broker will not perform down-conversion for consumers expecting an older message format. The broker responds with UNSUPPORTED_VERSION error for consume requests from such older clients. This configuration does not apply to any message format conversion that might be required for replication to followers."
+            },
+            "message_format_version": {
+              "enum": [
+                "0.8.0",
+                "0.8.1",
+                "0.8.2",
+                "0.9.0",
+                "0.10.0",
+                "0.10.0-IV0",
+                "0.10.0-IV1",
+                "0.10.1",
+                "0.10.1-IV0",
+                "0.10.1-IV1",
+                "0.10.1-IV2",
+                "0.10.2",
+                "0.10.2-IV0",
+                "0.11.0",
+                "0.11.0-IV0",
+                "0.11.0-IV1",
+                "0.11.0-IV2",
+                "1.0",
+                "1.0-IV0",
+                "1.1",
+                "1.1-IV0",
+                "2.0",
+                "2.0-IV0",
+                "2.0-IV1",
+                "2.1",
+                "2.1-IV0",
+                "2.1-IV1",
+                "2.1-IV2",
+                "2.2",
+                "2.2-IV0",
+                "2.2-IV1",
+                "2.3",
+                "2.3-IV0",
+                "2.3-IV1",
+                "2.4",
+                "2.4-IV0",
+                "2.4-IV1",
+                "2.5",
+                "2.5-IV0",
+                "2.6",
+                "2.6-IV0",
+                "2.7",
+                "2.7-IV0",
+                "2.7-IV1",
+                "2.7-IV2",
+                "2.8",
+                "2.8-IV0",
+                "2.8-IV1",
+                "3.0",
+                "3.0-IV0",
+                "3.0-IV1",
+                "3.1",
+                "3.1-IV0",
+                "3.2",
+                "3.2-IV0",
+                "3.3",
+                "3.3-IV0",
+                "3.3-IV1",
+                "3.3-IV2",
+                "3.3-IV3",
+                "3.4",
+                "3.4-IV0",
+                "3.5",
+                "3.5-IV0",
+                "3.5-IV1",
+                "3.5-IV2",
+                "3.6",
+                "3.6-IV0",
+                "3.6-IV1",
+                "3.6-IV2",
+                "3.7",
+                "3.7-IV0",
+                "3.7-IV1",
+                "3.7-IV2",
+                "3.7-IV3",
+                "3.7-IV4",
+                "3.8",
+                "3.8-IV0",
+                "3.9",
+                "3.9-IV0",
+                "3.9-IV1",
+                "4.0",
+                "4.0-IV0",
+                "4.1",
+                "4.1-IV0"
+              ],
+              "description": "Specify the message format version the broker will use to append messages to the logs. The value should be a valid ApiVersion. Some examples are: 0.8.2, 0.9.0.0, 0.10.0, check ApiVersion for more details. By setting a particular message format version, the user is certifying that all the existing messages on disk are smaller or equal than the specified version. Setting this value incorrectly will cause consumers with older versions to break as they will receive messages with a format that they don't understand. Deprecated in Kafka 4.0+: this configuration is removed and any supplied value will be ignored; for services upgraded to 4.0+, the returned value may be 'None'."
+            },
+            "message_timestamp_after_max_ms": {
+              "type": "integer",
+              "description": "The maximum difference allowed between the timestamp when a broker receives a message and the timestamp specified in the message. If message.timestamp.type=CreateTime, a message will be rejected if the difference in timestamp exceeds this threshold. Applies only for messages with timestamps later than the broker's timestamp.",
+              "minimum": 0
+            },
+            "message_timestamp_before_max_ms": {
+              "type": "integer",
+              "description": "The maximum difference allowed between the timestamp when a broker receives a message and the timestamp specified in the message. If message.timestamp.type=CreateTime, a message will be rejected if the difference in timestamp exceeds this threshold. Applies only for messages with timestamps earlier than the broker's timestamp.",
+              "minimum": 0
+            },
+            "message_timestamp_difference_max_ms": {
+              "type": "integer",
+              "description": "The maximum difference allowed between the timestamp when a broker receives a message and the timestamp specified in the message. If message.timestamp.type=CreateTime, a message will be rejected if the difference in timestamp exceeds this threshold. This configuration is ignored if message.timestamp.type=LogAppendTime.",
+              "minimum": 0
+            },
+            "message_timestamp_type": {
+              "enum": [
+                "CreateTime",
+                "LogAppendTime"
+              ],
+              "description": "Define whether the timestamp in the message is message create time or log append time."
+            },
+            "min_cleanable_dirty_ratio": {
+              "type": "number",
+              "description": "This configuration controls how frequently the log compactor will attempt to clean the log (assuming log compaction is enabled). By default we will avoid cleaning a log where more than 50% of the log has been compacted. This ratio bounds the maximum space wasted in the log by duplicates (at 50% at most 50% of the log could be duplicates). A higher ratio will mean fewer, more efficient cleanings but will mean more wasted space in the log. If the max.compaction.lag.ms or the min.compaction.lag.ms configurations are also specified, then the log compactor considers the log to be eligible for compaction as soon as either: (i) the dirty ratio threshold has been met and the log has had dirty (uncompacted) records for at least the min.compaction.lag.ms duration, or (ii) if the log has had dirty (uncompacted) records for at most the max.compaction.lag.ms period.",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "min_compaction_lag_ms": {
+              "type": "integer",
+              "description": "The minimum time a message will remain uncompacted in the log. Only applicable for logs that are being compacted.",
+              "minimum": 0
+            },
+            "min_insync_replicas": {
+              "type": "integer",
+              "description": "When a producer sets acks to 'all' (or '-1'), this configuration specifies the minimum number of replicas that must acknowledge a write for the write to be considered successful. If this minimum cannot be met, then the producer will raise an exception (either NotEnoughReplicas or NotEnoughReplicasAfterAppend). When used together, min.insync.replicas and acks allow you to enforce greater durability guarantees. A typical scenario would be to create a topic with a replication factor of 3, set min.insync.replicas to 2, and produce with acks of 'all'. This will ensure that the producer raises an exception if a majority of replicas do not receive a write.",
+              "minimum": 1
+            },
+            "preallocate": {
+              "type": "boolean",
+              "description": "True if we should preallocate the file on disk when creating a new log segment."
+            },
+            "remote_storage_enable": {
+              "type": "boolean",
+              "description": "Indicates whether tiered storage should be enabled. This is only available for services with Tiered Storage feature enabled."
+            },
+            "retention_bytes": {
+              "type": "integer",
+              "description": "This configuration controls the maximum size a partition (which consists of log segments) can grow to before we will discard old log segments to free up space if we are using the 'delete' retention policy. By default there is no size limit only a time limit. Since this limit is enforced at the partition level, multiply it by the number of partitions to compute the topic retention in bytes."
+            },
+            "retention_ms": {
+              "type": "integer",
+              "description": "This configuration controls the maximum time we will retain a log before we will discard old log segments to free up space if we are using the 'delete' retention policy. This represents an SLA on how soon consumers must read their data. If set to -1, no time limit is applied."
+            },
+            "segment_bytes": {
+              "type": "integer",
+              "description": "This configuration controls the segment file size for the log. Retention and cleaning is always done a file at a time so a larger segment size means fewer files but less granular control over retention. Setting this to a very low value has consequences, and the Aiven management plane ignores values less than 10 megabytes.",
+              "minimum": 14
+            },
+            "segment_index_bytes": {
+              "type": "integer",
+              "description": "This configuration controls the size of the index that maps offsets to file positions. We preallocate this index file and shrink it only after log rolls. You generally should not need to change this setting.",
+              "minimum": 0
+            },
+            "segment_jitter_ms": {
+              "type": "integer",
+              "description": "The maximum random jitter subtracted from the scheduled segment roll time to avoid thundering herds of segment rolling",
+              "minimum": 0
+            },
+            "segment_ms": {
+              "type": "integer",
+              "description": "This configuration controls the period of time after which Kafka will force the log to roll even if the segment file isn't full to ensure that retention can delete or compact old data. Setting this to a very low value has consequences, and the Aiven management plane ignores values less than 10 seconds.",
+              "minimum": 1
+            },
+            "unclean_leader_election_enable": {
+              "type": "boolean",
+              "description": "Indicates whether to enable replicas not in the ISR set to be elected as leader as a last resort, even though doing so may result in data loss."
+            }
+          },
+          "description": "Kafka topic configuration"
+        },
+        "min_insync_replicas": {
+          "type": "integer",
+          "description": "When a producer sets acks to 'all' (or '-1'), this configuration specifies the minimum number of replicas that must acknowledge a write for the write to be considered successful. If this minimum cannot be met, then the producer will raise an exception (either NotEnoughReplicas or NotEnoughReplicasAfterAppend). When used together, min.insync.replicas and acks allow you to enforce greater durability guarantees. A typical scenario would be to create a topic with a replication factor of 3, set min.insync.replicas to 2, and produce with acks of 'all'. This will ensure that the producer raises an exception if a majority of replicas do not receive a write.",
+          "minimum": 1
+        },
+        "owner_user_group_id": {
+          "type": "string",
+          "description": "The user group that owns this topic",
+          "minLength": 1,
+          "maxLength": 36
+        },
+        "partitions": {
+          "type": "integer",
+          "description": "Number of partitions",
+          "minimum": 1,
+          "maximum": 1000000
+        },
+        "replication": {
+          "type": "integer",
+          "description": "Number of replicas",
+          "minimum": 1
+        },
+        "retention_bytes": {
+          "type": "integer",
+          "description": "This configuration controls the maximum size a partition (which consists of log segments) can grow to before we will discard old log segments to free up space if we are using the 'delete' retention policy. By default there is no size limit only a time limit. Since this limit is enforced at the partition level, multiply it by the number of partitions to compute the topic retention in bytes."
+        },
+        "retention_hours": {
+          "type": "integer",
+          "description": "DEPRECATED: use config.retention_ms",
+          "maximum": 2562047788015
+        },
+        "tags": {
+          "type": "array",
+          "description": "Topic tags",
+          "items": {
+            "type": "object",
+            "properties": {
+              "key": {
+                "type": "string",
+                "description": "Tag key",
+                "minLength": 1,
+                "maxLength": 64
+              },
+              "value": {
+                "type": "string",
+                "description": "Tag value",
+                "minLength": 0,
+                "maxLength": 256
+              }
+            },
+            "required": [
+              "key",
+              "value"
+            ]
+          }
+        },
+        "topic_description": {
+          "type": "string",
+          "description": "Topic description",
+          "minLength": 1,
+          "maxLength": 256
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "topic_name"
+      ]
+    },
+    "strict": false,
+    "title": "Topic Update",
+    "description": "Update a Kafka topic"
+  },
+  "aiven_kafka_topic_delete": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "topic_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "topic_name"
+      ]
+    },
+    "strict": true,
+    "title": "Topic Delete",
+    "description": "Delete a Kafka topic"
+  },
+  "aiven_kafka_topic_message_list": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "topic_name": {
+          "type": "string"
+        },
+        "format": {
+          "enum": [
+            "binary",
+            "json",
+            "avro",
+            "protobuf",
+            "jsonschema"
+          ],
+          "description": "The format of consumed messages, which is used to convert messages into a JSON-compatible form. If unspecified, defaults to binary"
+        },
+        "max_bytes": {
+          "type": "integer",
+          "description": "The maximum number of bytes of unencoded keys and values that should be included in the response. This provides approximate control over the size of responses and the amount of memory required to store the decoded response. The actual limit will be the minimum of this setting and the server-side configuration consumer.request.max.bytes. Default is unlimited",
+          "minimum": 1024,
+          "maximum": 1000000000
+        },
+        "partitions": {
+          "type": "object",
+          "additionalProperties": true
+        },
+        "timeout": {
+          "type": "integer",
+          "description": "The maximum total time to wait for messages for a request if the maximum request size has not yet been reached",
+          "minimum": 3000,
+          "maximum": 40000
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "topic_name",
+        "partitions"
+      ]
+    },
+    "strict": false,
+    "title": "Topic Message List",
+    "description": "Consume messages from a Kafka topic.\n\n**REQUIRED BEFORE CALLING THIS TOOL — follow these steps in order:**\n1. Kafka REST API must be enabled. Call `aiven_service_update` with `user_config: {\"kafka_rest\": true}` if not already enabled.\n2. Call `aiven_service_get` once to check if `components` contains `kafka_rest` with `state: \"running\"`. If not ready, tell the user to wait and ask them when to re-check. Do NOT poll in a loop.\n\n**Format:** The `format` must match how messages were produced. Use `\"binary\"` for Debezium CDC or any schema-encoded messages (values are returned as base64). Use `\"json\"` only for plain JSON messages produced without a schema.\n\nThe `partitions` parameter is an object keyed by partition number (as a string), each with an `offset` value.\n\n**Example:**\n```\naiven_kafka_topic_message_list(\n  project=\"my-project\",\n  service_name=\"my-kafka\",\n  topic_name=\"my-topic\",\n  partitions={\"0\": {\"offset\": 0}},\n  format=\"binary\"\n)\n```"
+  },
+  "aiven_kafka_topic_message_produce": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "topic_name": {
+          "type": "string"
+        },
+        "format": {
+          "enum": [
+            "binary",
+            "json",
+            "avro",
+            "protobuf",
+            "jsonschema"
+          ],
+          "description": "The format of the content."
+        },
+        "key_schema": {
+          "type": "string",
+          "description": "Full schema encoded as a string (e.g. JSON serialized for Avro data)",
+          "minLength": 18,
+          "maxLength": 2048
+        },
+        "key_schema_id": {
+          "type": "integer",
+          "description": "ID returned by a previous request using the same schema. This ID corresponds to the ID of the schema in the registry.",
+          "minimum": 1,
+          "maximum": 50000
+        },
+        "records": {
+          "type": "array",
+          "description": "List of records to produce to the topic",
+          "items": {
+            "type": "object",
+            "properties": {
+              "key": {
+                "type": "object",
+                "additionalProperties": true
+              },
+              "partition": {
+                "type": "integer",
+                "description": "Optionally specify the partition where to produce the record",
+                "minimum": 0,
+                "maximum": 10000
+              },
+              "value": {
+                "type": "object",
+                "additionalProperties": true
+              }
+            }
+          }
+        },
+        "value_schema": {
+          "type": "string",
+          "description": "Full schema encoded as a string (e.g. JSON serialized for Avro data)",
+          "minLength": 18,
+          "maxLength": 2048
+        },
+        "value_schema_id": {
+          "type": "integer",
+          "description": "ID returned by a previous request using the same schema. This ID corresponds to the ID of the schema in the registry.",
+          "minimum": 1,
+          "maximum": 50000
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "topic_name",
+        "format",
+        "records"
+      ]
+    },
+    "strict": false,
+    "title": "Topic Message Produce",
+    "description": "Produce messages into a Kafka topic.\n\n**REQUIRED BEFORE CALLING THIS TOOL — follow these steps in order:**\n1. Kafka REST API must be enabled. Call `aiven_service_update` with `user_config: {\"kafka_rest\": true}` if not already enabled.\n2. Call `aiven_service_get` once to check if `components` contains `kafka_rest` with `state: \"running\"`. If not ready, tell the user to wait and ask them when to re-check. Do NOT poll in a loop."
+  },
+  "aiven_kafka_connect_available_connectors": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name"
+      ]
+    },
+    "strict": true,
+    "title": "Connect Available Connectors",
+    "description": "**Kafka Connect plan gate — call `aiven_service_get` first.** Read `service.plan`. On **free** Kafka plans (e.g. `free-0`), Kafka Connect is usually **not** included: Connect REST calls may return **403** (e.g. \"Kafka Connect API disabled\"). Do **not** call this tool when `service.plan` is `free-*` or the tier is known not to include Connect; tell the user to upgrade instead of hitting the API.\n\n**Typically no Kafka Connect:** `free-*` (e.g. `free-0`).\n\n**Typically includes Kafka Connect:** `startup-*` (e.g. `startup-2`, `startup-4`), `business-*`, `premium-*`.\n\nOn supported plans you may still need `user_config.kafka_connect: true`. A **403** saying Kafka Connect is **disabled** is usually a **plan / product** limit, not missing token permissions."
+  },
+  "aiven_kafka_connect_list": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name"
+      ]
+    },
+    "strict": true,
+    "title": "Connect List",
+    "description": "**Kafka Connect plan gate — call `aiven_service_get` first.** Read `service.plan`. On **free** Kafka plans (e.g. `free-0`), Kafka Connect is usually **not** included: Connect REST calls may return **403** (e.g. \"Kafka Connect API disabled\"). Do **not** call this tool when `service.plan` is `free-*` or the tier is known not to include Connect; tell the user to upgrade instead of hitting the API.\n\n**Typically no Kafka Connect:** `free-*` (e.g. `free-0`).\n\n**Typically includes Kafka Connect:** `startup-*` (e.g. `startup-2`, `startup-4`), `business-*`, `premium-*`.\n\nOn supported plans you may still need `user_config.kafka_connect: true`. A **403** saying Kafka Connect is **disabled** is usually a **plan / product** limit, not missing token permissions."
+  },
+  "aiven_kafka_connect_get_connector_status": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "connector_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "connector_name"
+      ]
+    },
+    "strict": true,
+    "title": "Connect Get Connector Status",
+    "description": "**Kafka Connect plan gate — call `aiven_service_get` first.** Read `service.plan`. On **free** Kafka plans (e.g. `free-0`), Kafka Connect is usually **not** included: Connect REST calls may return **403** (e.g. \"Kafka Connect API disabled\"). Do **not** call this tool when `service.plan` is `free-*` or the tier is known not to include Connect; tell the user to upgrade instead of hitting the API.\n\n**Typically no Kafka Connect:** `free-*` (e.g. `free-0`).\n\n**Typically includes Kafka Connect:** `startup-*` (e.g. `startup-2`, `startup-4`), `business-*`, `premium-*`.\n\nOn supported plans you may still need `user_config.kafka_connect: true`. A **403** saying Kafka Connect is **disabled** is usually a **plan / product** limit, not missing token permissions."
+  },
+  "aiven_kafka_connect_pause_connector": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "connector_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "connector_name"
+      ]
+    },
+    "strict": true,
+    "title": "Connect Pause Connector",
+    "description": "**Kafka Connect plan gate — call `aiven_service_get` first.** Read `service.plan`. On **free** Kafka plans (e.g. `free-0`), Kafka Connect is usually **not** included: Connect REST calls may return **403** (e.g. \"Kafka Connect API disabled\"). Do **not** call this tool when `service.plan` is `free-*` or the tier is known not to include Connect; tell the user to upgrade instead of hitting the API.\n\n**Typically no Kafka Connect:** `free-*` (e.g. `free-0`).\n\n**Typically includes Kafka Connect:** `startup-*` (e.g. `startup-2`, `startup-4`), `business-*`, `premium-*`.\n\nOn supported plans you may still need `user_config.kafka_connect: true`. A **403** saying Kafka Connect is **disabled** is usually a **plan / product** limit, not missing token permissions."
+  },
+  "aiven_kafka_connect_resume_connector": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "connector_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "connector_name"
+      ]
+    },
+    "strict": true,
+    "title": "Connect Resume Connector",
+    "description": "**Kafka Connect plan gate — call `aiven_service_get` first.** Read `service.plan`. On **free** Kafka plans (e.g. `free-0`), Kafka Connect is usually **not** included: Connect REST calls may return **403** (e.g. \"Kafka Connect API disabled\"). Do **not** call this tool when `service.plan` is `free-*` or the tier is known not to include Connect; tell the user to upgrade instead of hitting the API.\n\n**Typically no Kafka Connect:** `free-*` (e.g. `free-0`).\n\n**Typically includes Kafka Connect:** `startup-*` (e.g. `startup-2`, `startup-4`), `business-*`, `premium-*`.\n\nOn supported plans you may still need `user_config.kafka_connect: true`. A **403** saying Kafka Connect is **disabled** is usually a **plan / product** limit, not missing token permissions."
+  },
+  "aiven_kafka_connect_restart_connector": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "connector_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "connector_name"
+      ]
+    },
+    "strict": true,
+    "title": "Connect Restart Connector",
+    "description": "**Kafka Connect plan gate — call `aiven_service_get` first.** Read `service.plan`. On **free** Kafka plans (e.g. `free-0`), Kafka Connect is usually **not** included: Connect REST calls may return **403** (e.g. \"Kafka Connect API disabled\"). Do **not** call this tool when `service.plan` is `free-*` or the tier is known not to include Connect; tell the user to upgrade instead of hitting the API.\n\n**Typically no Kafka Connect:** `free-*` (e.g. `free-0`).\n\n**Typically includes Kafka Connect:** `startup-*` (e.g. `startup-2`, `startup-4`), `business-*`, `premium-*`.\n\nOn supported plans you may still need `user_config.kafka_connect: true`. A **403** saying Kafka Connect is **disabled** is usually a **plan / product** limit, not missing token permissions."
+  },
+  "aiven_kafka_connect_delete_connector": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "connector_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "connector_name"
+      ]
+    },
+    "strict": true,
+    "title": "Connect Delete Connector",
+    "description": "**Kafka Connect plan gate — call `aiven_service_get` first.** Read `service.plan`. On **free** Kafka plans (e.g. `free-0`), Kafka Connect is usually **not** included: Connect REST calls may return **403** (e.g. \"Kafka Connect API disabled\"). Do **not** call this tool when `service.plan` is `free-*` or the tier is known not to include Connect; tell the user to upgrade instead of hitting the API.\n\n**Typically no Kafka Connect:** `free-*` (e.g. `free-0`).\n\n**Typically includes Kafka Connect:** `startup-*` (e.g. `startup-2`, `startup-4`), `business-*`, `premium-*`.\n\nOn supported plans you may still need `user_config.kafka_connect: true`. A **403** saying Kafka Connect is **disabled** is usually a **plan / product** limit, not missing token permissions."
+  },
+  "aiven_kafka_schema_registry_subjects": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name"
+      ]
+    },
+    "strict": true,
+    "title": "Schema Registry Subjects",
+    "description": "Lists Schema Registry subjects"
+  },
+  "aiven_kafka_schema_registry_subject_version_get": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "subject_name": {
+          "type": "string"
+        },
+        "version_id": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "subject_name",
+        "version_id"
+      ]
+    },
+    "strict": true,
+    "title": "Schema Registry Subject Version Get",
+    "description": "Get Schema Registry Subject version"
+  },
+  "aiven_pg_service_available_extensions": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name"
+      ]
+    },
+    "strict": true,
+    "title": "Service Available Extensions",
+    "description": "List PostgreSQL extensions that can be loaded with CREATE EXTENSION in this service"
+  },
+  "aiven_pg_service_query_statistics": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "limit": {
+          "type": "integer",
+          "description": "Limit for number of results",
+          "minimum": 1,
+          "maximum": 5000,
+          "default": 100
+        },
+        "offset": {
+          "type": "integer",
+          "description": "Offset for retrieved results based on sort order",
+          "minimum": 0,
+          "default": 0
+        },
+        "order_by": {
+          "type": "string",
+          "description": "Sort order can be either asc or desc and multiple comma separated columns with their own order can be specified: :asc,:desc. Accepted sort columns are: blk_read_time, blk_write_time, calls, database_name, local_blks_dirtied, local_blks_hit, local_blks_read, local_blks_written, max_plan_time, max_time, mean_plan_time, mean_time, min_plan_time, min_time, query, queryid, rows, shared_blks_dirtied, shared_blks_hit, shared_blks_read, shared_blks_written, stddev_plan_time, stddev_time, temp_blks_read, temp_blks_written, total_plan_time, total_time, user_name, wal_bytes, wal_fpi, wal_records",
+          "maxLength": 256,
+          "default": "calls:desc"
+        }
+      },
+      "required": [
+        "project",
+        "service_name"
+      ]
+    },
+    "strict": false,
+    "title": "Service Query Statistics",
+    "description": "Fetch PostgreSQL service query statistics"
+  },
+  "aiven_pg_bouncer_create": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "database": {
+          "type": "string",
+          "description": "Service database name",
+          "maxLength": 63
+        },
+        "pool_mode": {
+          "enum": [
+            "session",
+            "transaction",
+            "statement"
+          ],
+          "description": "PGBouncer pool mode"
+        },
+        "pool_name": {
+          "type": "string",
+          "description": "Connection pool name",
+          "maxLength": 63
+        },
+        "pool_size": {
+          "type": "integer",
+          "description": "Size of PGBouncer's PostgreSQL side connection pool",
+          "minimum": 1,
+          "maximum": 10000,
+          "default": 10
+        },
+        "username": {
+          "type": "string",
+          "description": "Service username",
+          "maxLength": 64
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "database",
+        "pool_name"
+      ]
+    },
+    "strict": false,
+    "title": "Bouncer Create",
+    "description": "**PgBouncer connection pools** — `aiven_pg_bouncer_create`, `aiven_pg_bouncer_update`, and `aiven_pg_bouncer_delete` call Aiven’s `connection_pool` API.\n\n**Plan gate — call `aiven_service_get` first.** Read `service.plan` (string). Do **not** call these tools if the plan does not support connection pooling; tell the user they need a higher tier instead of attempting the API.\n\n**Plans that do _not_ include connection pooling:** `free-1-1gb`, `free-1-5gb`, any `free-*` plan, and **`hobbyist`**.\n\n**Plans that support connection pooling:** `startup-*`, `business-*`, and `premium-*` (e.g. `startup-4`, `business-8`).\n\nIf the API returns **403** with a message about the service plan not including connection pooling, interpret that as a **plan limitation**, not necessarily a missing token permission."
+  },
+  "aiven_pg_bouncer_update": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "pool_name": {
+          "type": "string"
+        },
+        "database": {
+          "type": "string",
+          "description": "Service database name",
+          "maxLength": 63
+        },
+        "pool_mode": {
+          "enum": [
+            "session",
+            "transaction",
+            "statement"
+          ],
+          "description": "PGBouncer pool mode"
+        },
+        "pool_size": {
+          "type": "integer",
+          "description": "Size of PGBouncer's PostgreSQL side connection pool",
+          "minimum": 1,
+          "maximum": 10000
+        },
+        "username": {
+          "type": "string",
+          "description": "Service username",
+          "maxLength": 64
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "pool_name"
+      ]
+    },
+    "strict": false,
+    "title": "Bouncer Update",
+    "description": "**PgBouncer connection pools** — `aiven_pg_bouncer_create`, `aiven_pg_bouncer_update`, and `aiven_pg_bouncer_delete` call Aiven’s `connection_pool` API.\n\n**Plan gate — call `aiven_service_get` first.** Read `service.plan` (string). Do **not** call these tools if the plan does not support connection pooling; tell the user they need a higher tier instead of attempting the API.\n\n**Plans that do _not_ include connection pooling:** `free-1-1gb`, `free-1-5gb`, any `free-*` plan, and **`hobbyist`**.\n\n**Plans that support connection pooling:** `startup-*`, `business-*`, and `premium-*` (e.g. `startup-4`, `business-8`).\n\nIf the API returns **403** with a message about the service plan not including connection pooling, interpret that as a **plan limitation**, not necessarily a missing token permission."
+  },
+  "aiven_pg_bouncer_delete": {
+    "schema": {
+      "type": "object",
+      "properties": {
+        "project": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "pool_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "project",
+        "service_name",
+        "pool_name"
+      ]
+    },
+    "strict": true,
+    "title": "Bouncer Delete",
+    "description": "**PgBouncer connection pools** — `aiven_pg_bouncer_create`, `aiven_pg_bouncer_update`, and `aiven_pg_bouncer_delete` call Aiven’s `connection_pool` API.\n\n**Plan gate — call `aiven_service_get` first.** Read `service.plan` (string). Do **not** call these tools if the plan does not support connection pooling; tell the user they need a higher tier instead of attempting the API.\n\n**Plans that do _not_ include connection pooling:** `free-1-1gb`, `free-1-5gb`, any `free-*` plan, and **`hobbyist`**.\n\n**Plans that support connection pooling:** `startup-*`, `business-*`, and `premium-*` (e.g. `startup-4`, `business-8`).\n\nIf the API returns **403** with a message about the service plan not including connection pooling, interpret that as a **plan limitation**, not necessarily a missing token permission."
+  }
+}