Previous value: -"Results per page (default: server default, max: 300). One page holds at most 150 entries, which keeps a response within about 50 KB; a larger value is reduced to that cap and echoed as appliedFilters.perPage, and totalPages is counted at the reduced size, so page + 1 continues where a page ends; notice discloses the reduction whenever the result runs past one page."New value: +"Results per page (default: server default). Positive integers above 300 are served at that maximum with the requested and served sizes echoed and a notice. totalPages uses the served size."

Previous value: -300New value: +9007199254740991

Added value: +{
+  "description": "Select a source-specific entity listing. Entries carry canonical id, name and sourceId only; global classification filters and include_aggregates=true are unavailable. Default false keeps all source entities.",
+  "pattern": "^\\s*\\d*\\s*$",
+  "type": "string"
+}

Added value: +{
+  "description": "Source dataset requested, omitted for the global country listing.",
+  "type": "string"
+}

Removed value: -false

Added value: +[
+  {
+    "additionalProperties": false,
+    "description": "An entity from a selected source.",
+    "properties": {
+      "id": {
+        "description": "Canonical source entity ID, accepted unchanged by worldbank_get_data.",
+        "type": "string"
+      },
+      "name": {
+        "description": "Source entity name.",
+        "type": "string"
+      },
+      "sourceId": {
+        "description": "Source owning this entity.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "name",
+      "sourceId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "description": "A country or aggregate entry.",
+    "properties": {
+      "capitalCity": {
+        "description": "Capital city name (empty for aggregates).",
+        "type": "string"
+      },
+      "id": {
+        "description": "Country or aggregate ID (ISO2 or WB aggregate code).",
+        "type": "string"
+      },
+      "incomeLevel": {
+        "additionalProperties": false,
+        "description": "World Bank income classification.",
+        "properties": {
+          "id": {
+            "description": "Income level code.",
+            "type": "string"
+          },
+          "name": {
+            "description": "Income level name.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "name"
+        ],
+        "type": "object"
+      },
+      "isAggregate": {
+        "description": "True when this entry is a regional or income-group aggregate rather than an individual country.",
+        "type": "boolean"
+      },
+      "iso2": {
+        "description": "ISO2 country code.",
+        "type": "string"
+      },
+      "latitude": {
+        "description": "Capital latitude (empty for aggregates).",
+        "type": "string"
+      },
+      "lendingType": {
+        "description": "World Bank lending type name: IDA, IBRD, Blend, or Not classified (lending_type filters by the codes IDX, IBD, IDB, LNX). Aggregates report Aggregates.",
+        "type": "string"
+      },
+      "longitude": {
+        "description": "Capital longitude (empty for aggregates).",
+        "type": "string"
+      },
+      "name": {
+        "description": "Country or aggregate name.",
+        "type": "string"
+      },
+      "region": {
+        "additionalProperties": false,
+        "description": "World Bank region this country belongs to.",
+        "properties": {
+          "id": {
+            "description": "Region code.",
+            "type": "string"
+          },
+          "name": {
+            "description": "Region name.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "name"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "id",
+      "iso2",
+      "name",
+      "region",
+      "incomeLevel",
+      "lendingType",
+      "capitalCity",
+      "longitude",
+      "latitude",
+      "isAggregate"
+    ],
+    "type": "object"
+  }
+]

Previous value: -"A country or aggregate entry."New value: +"A global country or aggregate, or an entity from the selected source."

Removed value: -{
-  "capitalCity": {
-    "description": "Capital city name (empty for aggregates).",
-    "type": "string"
-  },
-  "id": {
-    "description": "Country or aggregate ID (ISO2 or WB aggregate code).",
-    "type": "string"
-  },
-  "incomeLevel": {
-    "additionalProperties": false,
-    "description": "World Bank income classification.",
-    "properties": {
-      "id": {
-        "description": "Income level code.",
-        "type": "string"
-      },
-      "name": {
-        "description": "Income level name.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "id",
-      "name"
-    ],
-    "type": "object"
-  },
-  "isAggregate": {
-    "description": "True when this entry is a regional or income-group aggregate rather than an individual country.",
-    "type": "boolean"
-  },
-  "iso2": {
-    "description": "ISO2 country code.",
-    "type": "string"
-  },
-  "latitude": {
-    "description": "Capital latitude (empty for aggregates).",
-    "type": "string"
-  },
-  "lendingType": {
-    "description": "World Bank lending type name: IDA, IBRD, Blend, or Not classified (lending_type filters by the codes IDX, IBD, IDB, LNX). Aggregates report Aggregates.",
-    "type": "string"
-  },
-  "longitude": {
-    "description": "Capital longitude (empty for aggregates).",
-    "type": "string"
-  },
-  "name": {
-    "description": "Country or aggregate name.",
-    "type": "string"
-  },
-  "region": {
-    "additionalProperties": false,
-    "description": "World Bank region this country belongs to.",
-    "properties": {
-      "id": {
-        "description": "Region code.",
-        "type": "string"
-      },
-      "name": {
-        "description": "Region name.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "id",
-      "name"
-    ],
-    "type": "object"
-  }
-}

Removed value: -[
-  "id",
-  "iso2",
-  "name",
-  "region",
-  "incomeLevel",
-  "lendingType",
-  "capitalCity",
-  "longitude",
-  "latitude",
-  "isAggregate"
-]

Removed value: -"object"

Previous value: -"Machine-readable failure mode. Declared by this tool: `invalid_filter`: An invalid region or income_level code was provided. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `source_not_found`: source_id does not name a source. `source_not_queryable`: The selected source has no supported country/series/time layout. `unsupported_source_filter`: Global classification filters are combined with source_id. `invalid_filter`: An invalid region or income_level code was provided. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "invalid_filter"
-]New value: +[
+  "source_not_found",
+  "source_not_queryable",
+  "unsupported_source_filter",
+  "invalid_filter"
+]

Previous value: -"Results per page (default: server default, max: 300)."New value: +"Results per page (default: server default, max: 300). One page holds at most 150 entries, which keeps a response within about 50 KB; a larger value is reduced to that cap and echoed as appliedFilters.perPage, and totalPages is counted at the reduced size, so page + 1 continues where a page ends; notice discloses the reduction whenever the result runs past one page."

Previous value: -[
-  {
-    "not": {
-      "required": [
-        "error"
-      ]
-    },
-    "required": [
-      "countries",
-      "totalCount",
-      "currentPage",
-      "totalPages"
-    ]
-  },
-  {
-    "required": [
-      "error"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "countries",
+      "appliedFilters",
+      "totalCount",
+      "currentPage",
+      "totalPages"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": false,
+  "description": "The effective listing parameters — which filters were in force and the page size served.",
+  "properties": {
+    "includeAggregates": {
+      "description": "Whether aggregates were requested, including the default of false.",
+      "type": "boolean"
+    },
+    "incomeLevel": {
+      "description": "Income level code applied, omitted when none.",
+      "type": "string"
+    },
+    "lendingType": {
+      "description": "Lending type code applied, omitted when none.",
+      "type": "string"
+    },
+    "page": {
+      "description": "Page number requested.",
+      "type": "number"
+    },
+    "perPage": {
+      "description": "Results per page actually served — the requested size or server default, reduced to the page cap when larger. totalPages is counted at this size.",
+      "type": "number"
+    },
+    "region": {
+      "description": "Region code applied, omitted when none.",
+      "type": "string"
+    },
+    "requestedPerPage": {
+      "description": "Page size asked for, present only when it exceeded the page cap and perPage was reduced.",
+      "type": "number"
+    }
+  },
+  "required": [
+    "includeAggregates",
+    "page",
+    "perPage"
+  ],
+  "type": "object"
+}

Previous value: -"Context for an empty page: which filters matched nothing, or the page range that exists when the requested page is past the end."New value: +"Context for an empty page — which filters matched nothing, or the page range that exists when the requested page is past the end — or for a page size reduced to the page cap."

Previous value: -"When true, includes regional, income-group, and world aggregate entries alongside individual countries. Default false (individual countries only)."New value: +"When true, includes regional, income-group, and world aggregate entries alongside individual countries. Default false (individual countries only). No aggregate is returned under region or lending_type, whichever code is given, so this changes nothing when either is set."

Added value: +{
+  "anyOf": [
+    {
+      "const": "",
+      "type": "string"
+    },
+    {
+      "description": "IDX (IDA), IBD (IBRD), IDB (Blend), or LNX (Not classified).",
+      "enum": [
+        "IBD",
+        "IDB",
+        "IDX",
+        "LNX"
+      ],
+      "type": "string"
+    }
+  ],
+  "description": "Filter by World Bank lending type code: IDX (IDA), IBD (IBRD), IDB (Blend — eligible for both), or LNX (Not classified). IDX, IBD, and IDB are also the codes worldbank_get_poverty takes for its lending groups; a country's lendingType field reports the name (IDA, IBRD, Blend, Not classified)."
+}

Previous value: -"Filter by World Bank region code. Valid codes: EAS (East Asia & Pacific), ECS (Europe & Central Asia), LCN (Latin America & Caribbean), MEA (Middle East & North Africa), NAC (North America), SAS (South Asia), SSF (Sub-Saharan Africa)."New value: +"Filter by World Bank region code. A country's region.id is one of EAS (East Asia & Pacific), ECS (Europe & Central Asia), LCN (Latin America & Caribbean), MEA (Middle East, North Africa, Afghanistan & Pakistan), NAC (North America), SAS (South Asia), or SSF (Sub-Saharan Africa). Any other World Bank region or grouping code also filters, by membership: AFE (Africa Eastern and Southern), AFW (Africa Western and Central), ARB (Arab World), EUU (European Union), LDC (Least developed countries), and the rest of the codes the World Bank publishes for regions."

Previous value: -"World Bank lending type classification."New value: +"World Bank lending type name: IDA, IBRD, Blend, or Not classified (lending_type filters by the codes IDX, IBD, IDB, LNX). Aggregates report Aggregates."

Previous value: -"Current page number."New value: +"Page number requested — past totalPages when the request ran off the end."

Added value: +{
+  "description": "Context for an empty page: which filters matched nothing, or the page range that exists when the requested page is past the end.",
+  "type": "string"
+}

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "countries",
+      "totalCount",
+      "currentPage",
+      "totalPages"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `invalid_filter`: An invalid region or income_level code was provided. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "invalid_filter"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "countries",
-  "totalCount",
-  "currentPage",
-  "totalPages"
-]

Added value: +{
+  "description": "Current page number.",
+  "type": "number"
+}

Removed value: -{
-  "description": "Current page number.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Total number of pages.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Total matching entries before pagination (includes aggregates if include_aggregates=true).",
-  "type": "number"
-}

Added value: +{
+  "description": "Total matching entries before pagination (includes aggregates if include_aggregates=true).",
+  "type": "number"
+}

Added value: +{
+  "description": "Total number of pages.",
+  "type": "number"
+}

Previous value: -[
-  "countries",
-  "total",
-  "page",
-  "pages"
-]New value: +[
+  "countries",
+  "totalCount",
+  "currentPage",
+  "totalPages"
+]