Ärikratt

Regional statistics

region_stats

Read-only

County medians, employment and aid; omit county for all counties. Land is national. Optional sections add quarterly figures, filing coverage, labour market, public buying, energy labels, land, property, construction, municipal acts, municipality rankings and tourism. Small cells are suppressed. Labour taxes are not wages; registered unemployment is a count, not a rate. Filing absence is not proven non-filing. Buying uses registered seat and all retained history, independent of year; ceilings are not spend. Energy labels cover certified buildings, not all buildings or verified current validity. Property stock counts registered apartment-property units, not dwellings. Transactions are dated aggregates: respect frozen periods and never pool medians. national_construction: national series inside a county dossier only; null without county. Municipal topics are incomplete relevance indicators. Guest-night cost is not revenue; national tourism does not establish county seasonality. Preserve dates, units and nulls. county_brief keeps those figures; code region_report. Truncated lists keep totals. Use sector_stats for an industry. Do not look up natural persons, owners or parcel records.

Input Schema

Name	Required	Description	Default
`year`	No	Year
`county`	No	County name or alias. Omit for every county. Valid: Ida-Viru maakond, Lääne-Viru maakond, Harju maakond, Hiiu maakond, Jõgeva maakond, Järva maakond, Lääne maakond, Põlva maakond, Pärnu maakond, Rapla maakond, Saare maakond, Tartu maakond, Valga maakond, Viljandi maakond, Võru maakond, Maakond puudu.
`sections`	No	Opt-in context sections; omitted or [] returns pre-integration core only. Available: energy_labels, labour_market, land, municipal_acts, municipalities_ranked, national_construction, property_market, property_stock, public_buying, quarterly, report_coverage, tourism
`quarterly_form`	No	Quarterly legal-form group: OÜ, AS, other retained legal forms. Independent of annual-account year.	ou

Output Schema

Name	Required	Description
`aid`	No
`land`	No	Opt-in: returned only when sections includes land. Aggregate cadastral context, independently dated. National scope when county is omitted.
`slug`	No
`year`	No
`as_of`	Yes
`found`	No
`county`	No
`largest`	No
`partial`	No
`sectors`	No
`sources`	Yes
`tourism`	No	Opt-in: returned only when sections includes tourism. TU110 annual county totals and normalized TU121 national monthly arrivals; independent periods, null means not reported. Cost is not revenue/profit/yield.
`counties`	No
`delta_pct`	No
`quarterly`	No	Opt-in: returned only when sections includes quarterly. Eight latest quarters from a fixed 12-quarter complete-reporting legal-entity cohort. Current geography/classifier. Small cells excluded before all rollups. Empty for old snapshots.
`share_pct`	No
`truncated`	No
`demography`	No
`disclaimer`	Yes
`gross_wage`	No
`year_label`	No
`snapshot_id`	Yes
`bankruptcies`	No
`county_brief`	No	Compact county figures from the report note: tax-debt company count and share, bounded aid sum and decision count, procurement win count and value, 30-day bankruptcy notice count, and median wage versus the national figure. Numbers only.
`transactions`	No
`unemployment`	No
`company_count`	No
`energy_labels`	No	Opt-in: returned only when sections includes energy_labels.
`label_en_note`	No	Interpretation of English sector label coverage and fallback.
`labour_market`	No	Opt-in: returned only when sections includes labour_market. Official aggregate context; source gaps remain null, periods and classification are independent of company report year. Lists may be truncated.
`largest_total`	No	Largest total. queries._company_rows, fill_sector_english_labels and MCP tools: company selection and context metadata.
`median_series`	No
`public_buying`	No	Opt-in: returned only when sections includes public_buying.
`sectors_total`	No	Sectors total. queries._company_rows, fill_sector_english_labels and MCP tools: company selection and context metadata.
`counties_total`	No	Number of counties before envelope trimming.
`employees_unit`	No
`median_revenue`	No
`municipal_acts`	No	Opt-in: returned only when sections includes municipal_acts. Current municipal regulations: derived title-keyword relevance, not a complete compliance checklist. Null for older snapshots.
`municipalities`	No
`property_stock`	No	Opt-in: returned only when sections includes property_stock. Registered apartment-property units (korteriomand), not physical dwellings. Source Last-Modified date; RIK kinnistusraamat (Kris.xml), CC BY-SA 4.0, https://creativecommons.org/licenses/by-sa/4.0/. Missing input or old snapshots: null.
`source_details`	Yes	Full attribution and acquisition evidence: source_metadata(key).
`employees_total`	No
`open_call_count`	No
`property_market`	No	Opt-in: returned only when sections includes property_market.
`report_coverage`	No	Opt-in: returned only when sections includes report_coverage.
`counties_compare`	No
`delta_pct_reason`	No
`omitted_sections`	No	Sections removed to fit the response budget, including default sections. Request one named section to retrieve it. Present only when truncated.
`report_note_code`	No	County report code. region_report marks a county response; the figures are in county_brief.
`share_pct_reason`	No
`median_revenue_unit`	No
`wage_municipalities`	No
`company_count_reason`	No
`median_revenue_reason`	No
`municipalities_ranked`	No	Opt-in. Same active-company municipality rows as municipalities, ordered by company_count descending then name. median_revenue is null when median_revenue_n < 5.
`national_construction`	No	Opt-in: returned only when sections includes national_construction and county is supplied; national series inside the county dossier, null without county.
`employees_total_reason`	No
`excluded_unit_uncertain`	No	Companies left out of this revenue ranking because revenue is null and monetary_null_reason is unit_uncertain. count is the filtered total; companies lists at most 20 with registry_code and name, and has no rank. count 0 means none were excluded.

Schema Changelog

Changes observed during successful MCP inspections.

Changed69 schema fields changedOct 29, 2026

addedOutput schema / properties / bankruptcies / properties / attribution

Added value: +{
+  "description": "Attribution. stat_tables sector/region_bankruptcies: official NACE or national context.",
+  "type": "string"
+}

addedOutput schema / properties / bankruptcies / properties / emtak

Added value: +{
+  "description": "Emtak. stat_tables sector/region_bankruptcies: official NACE or national context.",
+  "type": "string"
+}

addedOutput schema / properties / bankruptcies / properties / indicator

Added value: +{
+  "description": "Indicator. stat_tables sector/region_bankruptcies: official NACE or national context.",
+  "type": "string"
+}

addedOutput schema / properties / bankruptcies / properties / label

Added value: +{
+  "description": "Label. stat_tables sector/region_bankruptcies: official NACE or national context.",
+  "type": "string"
+}

addedOutput schema / properties / bankruptcies / properties / level

Added value: +{
+  "description": "Level. stat_tables sector/region_bankruptcies: official NACE or national context.",
+  "type": "string"
+}

addedOutput schema / properties / bankruptcies / properties / source

Added value: +{
+  "description": "Source. stat_tables sector/region_bankruptcies: official NACE or national context.",
+  "type": "string"
+}

addedOutput schema / properties / bankruptcies / properties / table_code

Added value: +{
+  "description": "Table code. stat_tables sector/region_bankruptcies: official NACE or national context.",
+  "type": "string"
+}

addedOutput schema / properties / bankruptcies / properties / unit

Added value: +{
+  "description": "Unit. stat_tables sector/region_bankruptcies: official NACE or national context.",
+  "type": "string"
+}

addedOutput schema / properties / counties_total

Added value: +{
+  "description": "Number of counties before envelope trimming.",
+  "type": "integer"
+}

addedOutput schema / properties / county_brief / properties

Added value: +{
+  "aid": {
+    "additionalProperties": true,
+    "description": "Aid. tools._county_brief: non-null county report figures.",
+    "properties": {
+      "decisions": {
+        "description": "Decisions. tools._county_brief: non-null county report figures.",
+        "type": "integer"
+      },
+      "period": {
+        "description": "Period. tools._county_brief: non-null county report figures.",
+        "type": "string"
+      },
+      "sum": {
+        "description": "Sum. tools._county_brief: non-null county report figures.",
+        "type": "number"
+      }
+    },
+    "type": "object"
+  },
+  "bankruptcy_notices": {
+    "additionalProperties": true,
+    "description": "Bankruptcy notices. tools._county_brief: non-null county report figures.",
+    "properties": {
+      "notices": {
+        "description": "Notices. tools._county_brief: non-null county report figures.",
+        "type": "integer"
+      },
+      "period": {
+        "description": "Period. tools._county_brief: non-null county report figures.",
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "median_wage": {
+    "additionalProperties": true,
+    "description": "Median wage. tools._county_brief: non-null county report figures.",
+    "properties": {
+      "difference_eur": {
+        "description": "Difference eur. tools._county_brief: non-null county report figures.",
+        "type": "number"
+      },
+      "difference_pct": {
+        "description": "Difference pct. tools._county_brief: non-null county report figures.",
+        "type": "number"
+      },
+      "national_value": {
+        "description": "National value. tools._county_brief: non-null county report figures.",
+        "type": "number"
+      },
+      "period": {
+        "description": "Period. tools._county_brief: non-null county report figures.",
+        "type": "string"
+      },
+      "value": {
+        "description": "Value. tools._county_brief: non-null county report figures.",
+        "type": "number"
+      }
+    },
+    "type": "object"
+  },
+  "tax_debt": {
+    "additionalProperties": true,
+    "description": "Tax debt. tools._county_brief: non-null county report figures.",
+    "properties": {
+      "companies": {
+        "description": "Companies. tools._county_brief: non-null county report figures.",
+        "type": "integer"
+      },
+      "denominator": {
+        "description": "Denominator. tools._county_brief: non-null county report figures.",
+        "type": "integer"
+      },
+      "period": {
+        "description": "Period. tools._county_brief: non-null county report figures.",
+        "type": "string"
+      },
+      "share_pct": {
+        "description": "Share pct. tools._county_brief: non-null county report figures.",
+        "type": "number"
+      },
+      "threshold_eur": {
+        "description": "Threshold eur. tools._county_brief: non-null county report figures.",
+        "type": "integer"
+      }
+    },
+    "type": "object"
+  }
+}

addedOutput schema / properties / gross_wage / properties / attribution

Added value: +{
+  "description": "Attribution. stat_tables.region_gross_wage: official county wage context.",
+  "type": "string"
+}

addedOutput schema / properties / gross_wage / properties / county

Added value: +{
+  "description": "County. stat_tables.region_gross_wage: official county wage context.",
+  "type": "string"
+}

addedOutput schema / properties / gross_wage / properties / indicator

Added value: +{
+  "description": "Indicator. stat_tables.region_gross_wage: official county wage context.",
+  "type": "string"
+}

addedOutput schema / properties / gross_wage / properties / label

Added value: +{
+  "description": "Label. stat_tables.region_gross_wage: official county wage context.",
+  "type": "string"
+}

addedOutput schema / properties / gross_wage / properties / level

Added value: +{
+  "description": "Level. stat_tables.region_gross_wage: official county wage context.",
+  "type": "string"
+}

addedOutput schema / properties / gross_wage / properties / source

Added value: +{
+  "description": "Source. stat_tables.region_gross_wage: official county wage context.",
+  "type": "string"
+}

addedOutput schema / properties / gross_wage / properties / table_code

Added value: +{
+  "description": "Table code. stat_tables.region_gross_wage: official county wage context.",
+  "type": "string"
+}

addedOutput schema / properties / gross_wage / properties / unit

Added value: +{
+  "description": "Unit. stat_tables.region_gross_wage: official county wage context.",
+  "type": "string"
+}

addedOutput schema / properties / label_en_note

Added value: +{
+  "description": "Interpretation of English sector label coverage and fallback.",
+  "type": "string"
+}

addedOutput schema / properties / labour_market / properties / latest

Added value: +{
+  "additionalProperties": {
+    "properties": {
+      "code": {
+        "description": "Code. labour_market._latest_values and tools._bound_labour_context: latest official labour measures.",
+        "type": "string"
+      },
+      "unit": {
+        "description": "Unit. labour_market._latest_values and tools._bound_labour_context: latest official labour measures.",
+        "type": "string"
+      },
+      "values": {
+        "additionalProperties": {
+          "properties": {
+            "national_reason": {
+              "description": "National reason. labour_market._latest_values and tools._bound_labour_context: latest official labour measures.",
+              "type": "string"
+            },
+            "national_value": {
+              "description": "National value. labour_market._latest_values and tools._bound_labour_context: latest official labour measures. Null when the source value or applicable observation is unavailable.",
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "period": {
+              "description": "Period. labour_market._latest_values and tools._bound_labour_context: latest official labour measures.",
+              "type": "string"
+            },
+            "reason": {
+              "description": "Reason. labour_market._latest_values and tools._bound_labour_context: latest official labour measures.",
+              "type": "string"
+            },
+            "value": {
+              "description": "Value. labour_market._latest_values and tools._bound_labour_context: latest official labour measures. Null when the source value or applicable observation is unavailable.",
+              "type": [
+                "number",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "period",
+            "value",
+            "national_value"
+          ],
+          "type": "object"
+        },
+        "description": "Values. labour_market._latest_values and tools._bound_labour_context: latest official labour measures.",
+        "type": "object"
+      }
+    },
+    "required": [
+      "code",
+      "unit",
+      "values"
+    ],
+    "type": "object"
+  },
+  "description": "Latest observed values by Statistics Estonia table and metric. Preserved when historical rows are trimmed. Each table has code, unit and values; each metric retains its own period, value, national_value and missingness reasons.",
+  "type": "object"
+}

addedOutput schema / properties / labour_market / properties / rows_returned

Added value: +{
+  "description": "Rows returned. labour_market._latest_values and tools._bound_labour_context: latest official labour measures.",
+  "type": "integer"
+}

addedOutput schema / properties / labour_market / properties / rows_truncated

Added value: +{
+  "description": "Rows truncated. labour_market._latest_values and tools._bound_labour_context: latest official labour measures.",
+  "type": "boolean"
+}

addedOutput schema / properties / land / properties / land_cover_total

Added value: +{
+  "description": "Land cover total. land: aggregate cadastre measures.",
+  "type": "integer"
+}

addedOutput schema / properties / land / properties / land_use_total

Added value: +{
+  "description": "Land use total. land: aggregate cadastre measures.",
+  "type": "integer"
+}

addedOutput schema / properties / land / properties / note

Added value: +{
+  "description": "Note. land: aggregate cadastre measures.",
+  "type": "string"
+}

addedOutput schema / properties / land / properties / ownership / items / properties / area_missing_units

Added value: +{
+  "description": "Area missing units. land: aggregate cadastre measures.",
+  "type": "integer"
+}

addedOutput schema / properties / land / properties / ownership_total

Added value: +{
+  "description": "Ownership total. land: aggregate cadastre measures.",
+  "type": "integer"
+}

addedOutput schema / properties / land / properties / source

Added value: +{
+  "additionalProperties": true,
+  "description": "Source. land: aggregate cadastre measures.",
+  "properties": {
+    "as_of": {
+      "description": "As of. land: aggregate cadastre measures. Null when the source value or applicable observation is unavailable.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "as_of_basis": {
+      "description": "As of basis. land: aggregate cadastre measures.",
+      "type": "string"
+    },
+    "attribution": {
+      "description": "Attribution. land: aggregate cadastre measures.",
+      "type": "string"
+    },
+    "key": {
+      "description": "Key. land: aggregate cadastre measures.",
+      "type": "string"
+    },
+    "licence": {
+      "description": "Licence. land: aggregate cadastre measures.",
+      "type": "string"
+    },
+    "licence_url": {
+      "description": "Licence url. land: aggregate cadastre measures.",
+      "type": "string"
+    },
+    "name": {
+      "description": "Name. land: aggregate cadastre measures.",
+      "type": "string"
+    },
+    "status": {
+      "description": "Status. land: aggregate cadastre measures.",
+      "type": "string"
+    },
+    "url": {
+      "description": "Url. land: aggregate cadastre measures.",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

addedOutput schema / properties / land / properties / truncated

Added value: +{
+  "description": "Truncated. land: aggregate cadastre measures.",
+  "type": "boolean"
+}

addedOutput schema / properties / largest_total

Added value: +{
+  "description": "Largest total. queries._company_rows, fill_sector_english_labels and MCP tools: company selection and context metadata.",
+  "type": "integer"
+}

addedOutput schema / properties / municipal_acts / properties / excluded_invalid_title

Added value: +{
+  "description": "Excluded invalid title. municipal_acts: current municipal regulation metadata.",
+  "type": "integer"
+}

addedOutput schema / properties / municipal_acts / properties / municipalities / items / properties

Added value: +{
+  "code": {
+    "description": "Code. municipal_acts: current municipal regulation metadata.",
+    "type": "string"
+  },
+  "current_count": {
+    "description": "Current count. municipal_acts: current municipal regulation metadata.",
+    "type": "integer"
+  },
+  "name": {
+    "description": "Name. municipal_acts: current municipal regulation metadata.",
+    "type": "string"
+  },
+  "published_12m": {
+    "description": "Published 12m. municipal_acts: current municipal regulation metadata.",
+    "type": "integer"
+  }
+}

addedOutput schema / properties / municipal_acts / properties / new_12m_basis

Added value: +{
+  "description": "New 12m basis. municipal_acts: current municipal regulation metadata.",
+  "type": "string"
+}

addedOutput schema / properties / municipal_acts / properties / period_start_exclusive

Added value: +{
+  "description": "Period start exclusive. municipal_acts: current municipal regulation metadata.",
+  "type": "string"
+}

addedOutput schema / properties / municipal_acts / properties / relevance

Added value: +{
+  "description": "Relevance. municipal_acts: current municipal regulation metadata.",
+  "type": "string"
+}

addedOutput schema / properties / municipal_acts / properties / topics / items / properties

Added value: +{
+  "acts": {
+    "description": "Acts. municipal_acts: current municipal regulation metadata.",
+    "items": {
+      "additionalProperties": true,
+      "properties": {
+        "effective_date": {
+          "description": "Effective date. municipal_acts: current municipal regulation metadata.",
+          "type": "string"
+        },
+        "global_id": {
+          "description": "Global id. municipal_acts: current municipal regulation metadata.",
+          "type": "string"
+        },
+        "municipality": {
+          "description": "Municipality. municipal_acts: current municipal regulation metadata.",
+          "type": "string"
+        },
+        "publication_date": {
+          "description": "Publication date. municipal_acts: current municipal regulation metadata. Null when the source value or applicable observation is unavailable.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "title": {
+          "description": "Title. municipal_acts: current municipal regulation metadata.",
+          "type": "string"
+        },
+        "url": {
+          "description": "Url. municipal_acts: current municipal regulation metadata.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "acts_total": {
+    "description": "Acts total. municipal_acts: current municipal regulation metadata.",
+    "type": "integer"
+  },
+  "key": {
+    "description": "Key. municipal_acts: current municipal regulation metadata.",
+    "type": "string"
+  },
+  "truncated": {
+    "description": "Truncated. municipal_acts: current municipal regulation metadata.",
+    "type": "boolean"
+  }
+}

addedOutput schema / properties / property_stock / properties / geography_note

Added value: +{
+  "description": "Geography note. property_stock: aggregate registered apartment-property units.",
+  "type": "string"
+}

addedOutput schema / properties / property_stock / properties / note

Added value: +{
+  "description": "Note. property_stock: aggregate registered apartment-property units.",
+  "type": "string"
+}

addedOutput schema / properties / property_stock / properties / source / properties

Added value: +{
+  "as_of": {
+    "description": "As of. property_stock: aggregate registered apartment-property units. Null when the source value or applicable observation is unavailable.",
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "as_of_basis": {
+    "description": "As of basis. property_stock: aggregate registered apartment-property units.",
+    "type": "string"
+  },
+  "attribution": {
+    "description": "Attribution. property_stock: aggregate registered apartment-property units.",
+    "type": "string"
+  },
+  "key": {
+    "description": "Key. property_stock: aggregate registered apartment-property units.",
+    "type": "string"
+  },
+  "licence": {
+    "description": "Licence. property_stock: aggregate registered apartment-property units.",
+    "type": "string"
+  },
+  "licence_url": {
+    "description": "Licence url. property_stock: aggregate registered apartment-property units.",
+    "type": "string"
+  },
+  "name": {
+    "description": "Name. property_stock: aggregate registered apartment-property units.",
+    "type": "string"
+  },
+  "status": {
+    "description": "Status. property_stock: aggregate registered apartment-property units.",
+    "type": "string"
+  },
+  "url": {
+    "description": "Url. property_stock: aggregate registered apartment-property units.",
+    "type": "string"
+  }
+}

addedOutput schema / properties / public_buying / properties / coverage / properties

Added value: +{
+  "joined_buyer_count": {
+    "description": "Joined buyer count. public_buying: retained procurement observations and coverage.",
+    "type": "integer"
+  },
+  "joined_notice_count": {
+    "description": "Joined notice count. public_buying: retained procurement observations and coverage.",
+    "type": "integer"
+  },
+  "source_buyer_count": {
+    "description": "Source buyer count. public_buying: retained procurement observations and coverage.",
+    "type": "integer"
+  },
+  "source_end": {
+    "description": "Source end. public_buying: retained procurement observations and coverage. Null when the source value or applicable observation is unavailable.",
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "source_notice_count": {
+    "description": "Source notice count. public_buying: retained procurement observations and coverage.",
+    "type": "integer"
+  },
+  "source_start": {
+    "description": "Source start. public_buying: retained procurement observations and coverage. Null when the source value or applicable observation is unavailable.",
+    "type": [
+      "string",
+      "null"
+    ]
+  }
+}

addedOutput schema / properties / public_buying / properties / rows / items / properties / unknown_procedure_notice_n

Added value: +{
+  "description": "Unknown procedure notice n. public_buying: retained procurement observations and coverage.",
+  "type": "integer"
+}

changedOutput schema / properties / report_coverage / anyOf

Previous value: -[
-  {
-    "additionalProperties": true,
-    "description": "Fixed FY2024/2025 R-status OÜ cohort registered before 2023 with 12-31 year end. Dated absence is not evidence of non-filing. Ingestion-unavailable and suppressed values are null. With county omitted, contains shared metadata and columns for each county report_coverage.values.",
-    "properties": {
-      "as_of": {
-        "type": "string"
-      },
-      "chosen_year_rule": {
-        "type": "string"
-      },
-      "columns": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "ingestion_status": {
-        "type": "string"
-      },
-      "rows": {
-        "items": {
-          "additionalProperties": true,
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "rows_total": {
-        "type": "integer"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "description": "Fixed FY2024/2025 R-status OÜ cohort registered before 2023 with 12-31 year end. Dated absence is not evidence of non-filing. Ingestion-unavailable and suppressed values are null. With county omitted, contains shared metadata and columns for each county report_coverage.values.",
+    "properties": {
+      "as_of": {
+        "type": "string"
+      },
+      "chosen_year_rule": {
+        "type": "string"
+      },
+      "columns": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "fiscal_year_end": {
+        "description": "Fiscal year end. report_coverage._coverage_payload: fixed FY2024–2025 ingestion observations.",
+        "type": "string"
+      },
+      "fiscal_years": {
+        "description": "Fiscal years. report_coverage._coverage_payload: fixed FY2024–2025 ingestion observations.",
+        "items": {
+          "type": "integer"
+        },
+        "type": "array"
+      },
+      "imported_at": {
+        "description": "Imported at. report_coverage._coverage_payload: fixed FY2024–2025 ingestion observations. Null when the source value or applicable observation is unavailable.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "ingestion_status": {
+        "type": "string"
+      },
+      "label": {
+        "description": "Label. report_coverage._coverage_payload: fixed FY2024–2025 ingestion observations.",
+        "type": "string"
+      },
+      "legal_form": {
+        "description": "Legal form. report_coverage._coverage_payload: fixed FY2024–2025 ingestion observations.",
+        "type": "string"
+      },
+      "loaded_years": {
+        "description": "Loaded years. report_coverage._coverage_payload: fixed FY2024–2025 ingestion observations.",
+        "items": {
+          "type": "integer"
+        },
+        "type": "array"
+      },
+      "membership_basis": {
+        "description": "Membership basis. report_coverage._coverage_payload: fixed FY2024–2025 ingestion observations.",
+        "type": "string"
+      },
+      "national_completeness": {
+        "description": "National completeness. report_coverage._coverage_payload: fixed FY2024–2025 ingestion observations.",
+        "type": "string"
+      },
+      "note": {
+        "description": "Note. report_coverage._coverage_payload: fixed FY2024–2025 ingestion observations.",
+        "type": "string"
+      },
+      "registered_before": {
+        "description": "Registered before. report_coverage._coverage_payload: fixed FY2024–2025 ingestion observations.",
+        "type": "string"
+      },
+      "rows": {
+        "items": {
+          "additionalProperties": true,
+          "properties": {
+            "absent_count": {
+              "description": "Observed company count for the period; null when ingestion is unavailable or the cohort is suppressed.",
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "absent_share_pct": {
+              "description": "Percentage of the cohort; null for empty cohorts, unavailable ingestion or suppression.",
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "at_least_one_count": {
+              "description": "Observed company count for the period; null when ingestion is unavailable or the cohort is suppressed.",
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "both_years_count": {
+              "description": "Observed company count for the period; null when ingestion is unavailable or the cohort is suppressed.",
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "cohort_count": {
+              "description": "Cohort size; null under privacy suppression, including unavailable ingestion.",
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "completeness_pct": {
+              "description": "Percentage of the cohort; null for empty cohorts, unavailable ingestion or suppression.",
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "found_count": {
+              "description": "Observed company count for the period; null when ingestion is unavailable or the cohort is suppressed.",
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "period": {
+              "description": "Period. report_coverage._coverage_payload: fixed FY2024–2025 ingestion observations.",
+              "type": "string"
+            },
+            "reason": {
+              "description": "ingestion_unavailable or suppressed; null for a loaded, unsuppressed observation.",
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "rows_total": {
+        "type": "integer"
+      },
+      "source_cutoff": {
+        "description": "Source cutoff. report_coverage._coverage_payload: fixed FY2024–2025 ingestion observations. Null when the source value or applicable observation is unavailable.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "status": {
+        "description": "Status. report_coverage._coverage_payload: fixed FY2024–2025 ingestion observations.",
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / sectors / items / properties / label_en

Added value: +{
+  "description": "Label en. queries._company_rows, fill_sector_english_labels and MCP tools: company selection and context metadata. Null when the source value or applicable observation is unavailable.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / sectors / items / properties / label_en_method

Added value: +{
+  "description": "Label en method. queries._company_rows, fill_sector_english_labels and MCP tools: company selection and context metadata. Null when the source value or applicable observation is unavailable.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / sectors_total

Added value: +{
+  "description": "Sectors total. queries._company_rows, fill_sector_english_labels and MCP tools: company selection and context metadata.",
+  "type": "integer"
+}

addedOutput schema / properties / sources / items / properties / as_of_basis

Added value: +{
+  "description": "As of basis. privacy._sources: compact source attribution; absent clocks are omitted.",
+  "type": "string"
+}

addedOutput schema / properties / sources / items / properties / table

Added value: +{
+  "description": "Table. privacy._sources: compact source attribution; absent clocks are omitted.",
+  "type": "string"
+}

addedOutput schema / properties / tourism / properties / annual / items / properties / CAP_BEDP

Added value: +{
+  "description": "Source tourism measure CAP_BEDP; null when not reported. See measures for label and unit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / annual / items / properties / CAP_BEDR

Added value: +{
+  "description": "Source tourism measure CAP_BEDR; null when not reported. See measures for label and unit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / annual / items / properties / CAP_ESTA

Added value: +{
+  "description": "Source tourism measure CAP_ESTA; null when not reported. See measures for label and unit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / annual / items / properties / OCC_ARR

Added value: +{
+  "description": "Source tourism measure OCC_ARR; null when not reported. See measures for label and unit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / annual / items / properties / OCC_ARR_BSNS

Added value: +{
+  "description": "Source tourism measure OCC_ARR_BSNS; null when not reported. See measures for label and unit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / annual / items / properties / OCC_ARR_HOL

Added value: +{
+  "description": "Source tourism measure OCC_ARR_HOL; null when not reported. See measures for label and unit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / annual / items / properties / OCC_NI

Added value: +{
+  "description": "Source tourism measure OCC_NI; null when not reported. See measures for label and unit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / annual / items / properties / OCC_NI_COST

Added value: +{
+  "description": "Source tourism measure OCC_NI_COST; null when not reported. See measures for label and unit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / annual / items / properties / OCC_OR_BEDP

Added value: +{
+  "description": "Source tourism measure OCC_OR_BEDP; null when not reported. See measures for label and unit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / annual / items / properties / OCC_OR_BEDR

Added value: +{
+  "description": "Source tourism measure OCC_OR_BEDR; null when not reported. See measures for label and unit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / annual_geography

Added value: +{
+  "description": "Annual geography. tourism.tourism: separate annual and monthly official tourism measures.",
+  "type": "string"
+}

addedOutput schema / properties / tourism / properties / annual_year

Added value: +{
+  "description": "Annual year. tourism.tourism: separate annual and monthly official tourism measures. Null when the source value or applicable observation is unavailable.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / availability_reason

Added value: +{
+  "description": "Availability reason. tourism.tourism: separate annual and monthly official tourism measures. Null when no missing-value, suppression or unavailability reason applies.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / available

Added value: +{
+  "description": "Available. tourism.tourism: separate annual and monthly official tourism measures.",
+  "type": "boolean"
+}

addedOutput schema / properties / tourism / properties / measures

Added value: +{
+  "additionalProperties": {
+    "additionalProperties": true,
+    "properties": {
+      "label": {
+        "description": "Label. tourism.tourism: separate annual and monthly official tourism measures.",
+        "type": "string"
+      },
+      "unit": {
+        "description": "Unit. tourism.tourism: separate annual and monthly official tourism measures.",
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "description": "Source measure codes mapped to labels and units.",
+  "type": "object"
+}

addedOutput schema / properties / tourism / properties / monthly / items / properties / OCC_ARR

Added value: +{
+  "description": "Source tourism measure OCC_ARR; null when not reported. See measures for label and unit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / monthly / items / properties / OCC_ARR_NONRES

Added value: +{
+  "description": "Source tourism measure OCC_ARR_NONRES; null when not reported. See measures for label and unit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / monthly / items / properties / OCC_ARR_RES

Added value: +{
+  "description": "Source tourism measure OCC_ARR_RES; null when not reported. See measures for label and unit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / tourism / properties / monthly_geography

Added value: +{
+  "description": "Monthly geography. tourism.tourism: separate annual and monthly official tourism measures.",
+  "type": "string"
+}

addedOutput schema / properties / tourism / properties / note

Added value: +{
+  "description": "Note. tourism.tourism: separate annual and monthly official tourism measures.",
+  "type": "string"
+}

addedOutput schema / properties / tourism / properties / null_reason

Added value: +{
+  "description": "Null reason. tourism.tourism: separate annual and monthly official tourism measures.",
+  "type": "string"
+}

addedOutput schema / properties / wage_municipalities / items / properties / period

Added value: +{
+  "description": "Period. stat_tables.region_municipality_wages: latest municipal wage observations.",
+  "type": "string"
+}

Changed1 schema field changedOct 27, 2026

changedOutput schema / properties / national_construction / description

Previous value: -"Opt-in: returned only when sections includes national_construction. "New value: +"Opt-in: returned only when sections includes national_construction and county is supplied; national series inside the county dossier, null without county."

Changed7 schema fields changedOct 18, 2026

addedOutput schema / properties / county_brief

Added value: +{
+  "additionalProperties": true,
+  "description": "Compact county figures from the report note: tax-debt company count and share, bounded aid sum and decision count, procurement win count and value, 30-day bankruptcy notice count, and median wage versus the national figure. Numbers only.",
+  "type": [
+    "object",
+    "null"
+  ]
+}

addedOutput schema / properties / omitted_sections

Added value: +{
+  "description": "Sections removed to fit the response budget, including default sections. Request one named section to retrieve it. Present only when truncated.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / report_note_code

Added value: +{
+  "description": "County report code. region_report marks a county response; the figures are in county_brief.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / source_details

Added value: +{
+  "description": "Full attribution and acquisition evidence: source_metadata(key).",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / sources / items / properties / as_of
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```
addedOutput schema / properties / sources / items / properties / key
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```

changedOutput schema / required

Previous value: -[
-  "snapshot_id",
-  "as_of",
-  "sources",
-  "disclaimer"
-]New value: +[
+  "snapshot_id",
+  "as_of",
+  "sources",
+  "source_details",
+  "disclaimer"
+]

Changed1 schema field changedOct 12, 2026

addedOutput schema / properties / excluded_unit_uncertain

Added value: +{
+  "additionalProperties": true,
+  "description": "Companies left out of this revenue ranking because revenue is null and monetary_null_reason is unit_uncertain. count is the filtered total; companies lists at most 20 with registry_code and name, and has no rank. count 0 means none were excluded.",
+  "properties": {
+    "companies": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "registry_code": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "count": {
+      "type": [
+        "number",
+        "null"
+      ]
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

Changed1 schema field changedOct 10, 2026

changedOutput schema / properties / labour_market / description

Previous value: -"Opt-in: returned only when sections includes labour_market. Official aggregate context; source gaps remain null, periods and classification are independent of company report year. Lists may be trimmed under the 8 KB envelope."New value: +"Opt-in: returned only when sections includes labour_market. Official aggregate context; source gaps remain null, periods and classification are independent of company report year. Lists may be truncated."

Changed3 schema fields changedOct 6, 2026

changedInput schema / properties / sections / description

Previous value: -"Opt-in context sections; omitted or [] returns pre-integration core only. Available: energy_labels, labour_market, land, municipal_acts, national_construction, property_market, property_stock, public_buying, quarterly, report_coverage, tourism"New value: +"Opt-in context sections; omitted or [] returns pre-integration core only. Available: energy_labels, labour_market, land, municipal_acts, municipalities_ranked, national_construction, property_market, property_stock, public_buying, quarterly, report_coverage, tourism"

changedOutput schema / description

Previous value: -"Default returns pre-integration core sections. Opt-in sections (via sections): energy_labels, labour_market, land, municipal_acts, national_construction, property_market, property_stock, public_buying, quarterly, report_coverage, tourism. Unknown section names are validation errors. Nested previews retain totals/truncation; core section containers are never dropped."New value: +"Default returns pre-integration core sections. Opt-in sections (via sections): energy_labels, labour_market, land, municipal_acts, municipalities_ranked, national_construction, property_market, property_stock, public_buying, quarterly, report_coverage, tourism. Unknown section names are validation errors. Nested previews retain totals/truncation; core section containers are never dropped."

addedOutput schema / properties / municipalities_ranked

Added value: +{
+  "description": "Opt-in. Same active-company municipality rows as municipalities, ordered by company_count descending then name. median_revenue is null when median_revenue_n < 5.",
+  "items": {
+    "additionalProperties": true,
+    "properties": {
+      "company_count": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "employees_total": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "median_revenue": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "median_revenue_n": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "name": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "slug": {
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}

Changed24 schema fields changedOct 5, 2026

addedInput schema / properties / quarterly_form

Added value: +{
+  "default": "ou",
+  "description": "Quarterly legal-form group: OÜ, AS, other retained legal forms. Independent of annual-account year.",
+  "enum": [
+    "ou",
+    "as",
+    "other"
+  ],
+  "title": "Quarterly Form",
+  "type": "string"
+}

addedInput schema / properties / sections

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Opt-in context sections; omitted or [] returns pre-integration core only. Available: energy_labels, labour_market, land, municipal_acts, national_construction, property_market, property_stock, public_buying, quarterly, report_coverage, tourism",
+  "title": "Sections"
+}

addedOutput schema / description

Added value: +"Default returns pre-integration core sections. Opt-in sections (via sections): energy_labels, labour_market, land, municipal_acts, national_construction, property_market, property_stock, public_buying, quarterly, report_coverage, tourism. Unknown section names are validation errors. Nested previews retain totals/truncation; core section containers are never dropped."

addedOutput schema / properties / bankruptcies / additionalProperties
```
Added value: +true
```

addedOutput schema / properties / bankruptcies / properties

Added value: +{
+  "series": {
+    "items": {
+      "properties": {
+        "period": {
+          "type": "string"
+        },
+        "reason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "unit": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "value": {
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "period",
+        "value"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "series_total": {
+    "type": "integer"
+  }
+}

changedOutput schema / properties / bankruptcies / type

Previous value: -[
-  "string",
-  "number",
-  "boolean",
-  "null"
-]New value: +[
+  "object",
+  "null"
+]

addedOutput schema / properties / counties / items / properties / report_coverage

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "description": "Compact all-county coverage: values are positional rows matching the shared top-level report_coverage.columns. All three periods are retained; suppressed counts including cohort size are null.",
+      "properties": {
+        "values": {
+          "items": {
+            "items": {
+              "type": [
+                "string",
+                "number",
+                "null"
+              ]
+            },
+            "type": "array"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / energy_labels

Added value: +{
+  "description": "Opt-in: returned only when sections includes energy_labels. ",
+  "properties": {
+    "as_of": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "as_of_basis": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "counties": {
+      "items": {
+        "properties": {
+          "ETA": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "KEK": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "county": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "n": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "unknown": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "counties_total": {
+      "type": "integer"
+    },
+    "distribution": {
+      "items": {
+        "properties": {
+          "calculation_type": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "energy_class": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "n": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "distribution_total": {
+      "type": "integer"
+    },
+    "excluded_date_buildings": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "located_county": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "located_municipality": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "methodology": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "missing_valid_to": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "municipalities": {
+      "items": {
+        "properties": {
+          "ETA": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "KEK": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "municipality": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "n": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "unknown": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "municipalities_total": {
+      "type": "integer"
+    },
+    "n": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "note": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "partial_only_buildings": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "registered_buildings": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "registered_rows": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "truncated": {
+      "type": "boolean"
+    },
+    "view": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

addedOutput schema / properties / gross_wage / additionalProperties
```
Added value: +true
```

addedOutput schema / properties / gross_wage / properties

Added value: +{
+  "series": {
+    "items": {
+      "properties": {
+        "period": {
+          "type": "string"
+        },
+        "reason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "unit": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "value": {
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "period",
+        "value"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "series_total": {
+    "type": "integer"
+  }
+}

changedOutput schema / properties / gross_wage / type

Previous value: -[
-  "string",
-  "number",
-  "boolean",
-  "null"
-]New value: +[
+  "object",
+  "null"
+]

addedOutput schema / properties / labour_market

Added value: +{
+  "description": "Opt-in: returned only when sections includes labour_market. Official aggregate context; source gaps remain null, periods and classification are independent of company report year. Lists may be trimmed under the 8 KB envelope.",
+  "properties": {
+    "classification": {
+      "type": "string"
+    },
+    "rows": {
+      "items": {
+        "properties": {
+          "code": {
+            "type": "string"
+          },
+          "metric": {
+            "type": "string"
+          },
+          "national_reason": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "national_value": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "period": {
+            "type": "string"
+          },
+          "reason": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "table_code": {
+            "type": "string"
+          },
+          "unit": {
+            "type": "string"
+          },
+          "value": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "table_code",
+          "metric",
+          "period",
+          "value"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "rows_total": {
+      "type": "integer"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

addedOutput schema / properties / land

Added value: +{
+  "additionalProperties": true,
+  "description": "Opt-in: returned only when sections includes land. Aggregate cadastral context, independently dated. National scope when county is omitted.",
+  "properties": {
+    "area_km2": {
+      "type": "number"
+    },
+    "area_missing_units": {
+      "type": "integer"
+    },
+    "as_of": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "land_cover": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "area_km2": {
+            "type": "number"
+          },
+          "category": {
+            "type": "string"
+          },
+          "unit_count": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "land_use": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "area_km2": {
+            "type": "number"
+          },
+          "category": {
+            "type": "string"
+          },
+          "unit_count": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "ownership": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "area_km2": {
+            "type": "number"
+          },
+          "category": {
+            "type": "string"
+          },
+          "unit_count": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "scope": {
+      "type": "string"
+    },
+    "unit_count": {
+      "type": "integer"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

addedOutput schema / properties / municipal_acts

Added value: +{
+  "additionalProperties": true,
+  "description": "Opt-in: returned only when sections includes municipal_acts. Current municipal regulations: derived title-keyword relevance, not a complete compliance checklist. Null for older snapshots.",
+  "properties": {
+    "as_of": {
+      "type": "string"
+    },
+    "current_count": {
+      "type": "integer"
+    },
+    "mapping_version": {
+      "type": "string"
+    },
+    "municipalities": {
+      "items": {
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "published_12m": {
+      "description": "Publication dates of current redactions; not newly enacted laws.",
+      "type": "integer"
+    },
+    "source_geography_level": {
+      "const": "municipality"
+    },
+    "topic_method": {
+      "const": "title_keywords"
+    },
+    "topics": {
+      "items": {
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "truncated": {
+      "type": "boolean"
+    },
+    "unassigned_count": {
+      "type": "integer"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

addedOutput schema / properties / national_construction

Added value: +{
+  "description": "Opt-in: returned only when sections includes national_construction. ",
+  "items": {
+    "additionalProperties": true,
+    "properties": {
+      "geography": {
+        "type": "string"
+      },
+      "key": {
+        "type": "string"
+      },
+      "series": {
+        "items": {
+          "additionalProperties": true,
+          "properties": {
+            "period": {
+              "type": "string"
+            },
+            "value": {
+              "type": [
+                "number",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "series_total": {
+        "type": "integer"
+      },
+      "source_url": {
+        "type": "string"
+      },
+      "table": {
+        "type": "string"
+      },
+      "truncated": {
+        "type": "boolean"
+      },
+      "unit": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}

addedOutput schema / properties / property_market

Added value: +{
+  "additionalProperties": true,
+  "description": "Opt-in: returned only when sections includes property_market. ",
+  "properties": {
+    "frozen_since": {
+      "const": "2026-05-11",
+      "type": "string"
+    },
+    "grain": {
+      "type": "string"
+    },
+    "population": {
+      "type": "string"
+    },
+    "price_unit": {
+      "type": "string"
+    },
+    "rows": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "area_code": {
+            "type": "string"
+          },
+          "deal_count": {
+            "type": "integer"
+          },
+          "median_price_m2": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "municipality": {
+            "type": "string"
+          },
+          "partial": {
+            "type": "boolean"
+          },
+          "period": {
+            "type": "string"
+          },
+          "price_reason": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "property_subtype": {
+            "type": "string"
+          },
+          "property_type": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "rows_total": {
+      "type": "integer"
+    },
+    "truncated": {
+      "type": "boolean"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

addedOutput schema / properties / property_stock

Added value: +{
+  "additionalProperties": true,
+  "description": "Opt-in: returned only when sections includes property_stock. Registered apartment-property units (korteriomand), not physical dwellings. Source Last-Modified date; RIK kinnistusraamat (Kris.xml), CC BY-SA 4.0, https://creativecommons.org/licenses/by-sa/4.0/. Missing input or old snapshots: null.",
+  "properties": {
+    "as_of": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "county_available": {
+      "type": "boolean"
+    },
+    "scope": {
+      "type": "string"
+    },
+    "source": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "unit_count": {
+      "type": "integer"
+    },
+    "unknown_county_count": {
+      "type": "integer"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

addedOutput schema / properties / public_buying

Added value: +{
+  "additionalProperties": true,
+  "description": "Opt-in: returned only when sections includes public_buying. ",
+  "properties": {
+    "coverage": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "geography_basis": {
+      "const": "registered_seat",
+      "type": "string"
+    },
+    "note": {
+      "type": "string"
+    },
+    "rows": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "buyer_count": {
+            "description": "Number of joined legal-entity buyers; public counts are not small-cell suppressed.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "ceiling_eur": {
+            "description": "Sum of consistent known lot ceilings, not expenditure.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "ceiling_known_n": {
+            "description": "Lots contributing a known ceiling, including zero.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "county": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "lot_count": {
+            "description": "Observed latest-revision folder/lot pairs with a legal-entity winner.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "notice_count": {
+            "description": "Retained notice count for matched legal buyers.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "procedure_count": {
+            "description": "Distinct unambiguous folders.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "shared_or_unknown_winner_lots": {
+            "description": "Lots not attributable to exactly one joined legal-entity winner.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "single_tender_n": {
+            "description": "Known lots with exactly one tender.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "single_tender_share": {
+            "description": "single_tender_n / tenders_known_n; null if denominator is zero.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "tenders_known_n": {
+            "description": "Lots with a consistent known non-negative integer tender count.",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "tenders_unknown_n": {
+            "description": "Lots with missing or conflicting tender counts.",
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "rows_total": {
+      "description": "County count before envelope trimming.",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "truncated": {
+      "type": "boolean"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

addedOutput schema / properties / quarterly

Added value: +{
+  "additionalProperties": true,
+  "description": "Opt-in: returned only when sections includes quarterly. Eight latest quarters from a fixed 12-quarter complete-reporting legal-entity cohort. Current geography/classifier. Small cells excluded before all rollups. Empty for old snapshots.",
+  "properties": {
+    "method": {
+      "type": "string"
+    },
+    "segments": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "coverage_count": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "legal_form": {
+            "enum": [
+              "ou",
+              "as",
+              "other"
+            ],
+            "type": "string"
+          },
+          "rows": {
+            "items": {
+              "additionalProperties": true,
+              "properties": {
+                "employee_count": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "employee_count_yoy_pct": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "headcount_change": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "labour_taxes": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "labour_taxes_yoy_pct": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "period": {
+                  "type": "string"
+                },
+                "turnover": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "turnover_yoy_pct": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "rows_total": {
+            "type": "integer"
+          },
+          "suppressed": {
+            "type": "boolean"
+          },
+          "truncated": {
+            "type": "boolean"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "segments_total": {
+      "type": "integer"
+    },
+    "truncated": {
+      "type": "boolean"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

addedOutput schema / properties / report_coverage

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "description": "Fixed FY2024/2025 R-status OÜ cohort registered before 2023 with 12-31 year end. Dated absence is not evidence of non-filing. Ingestion-unavailable and suppressed values are null. With county omitted, contains shared metadata and columns for each county report_coverage.values.",
+      "properties": {
+        "as_of": {
+          "type": "string"
+        },
+        "chosen_year_rule": {
+          "type": "string"
+        },
+        "columns": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "ingestion_status": {
+          "type": "string"
+        },
+        "rows": {
+          "items": {
+            "additionalProperties": true,
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "rows_total": {
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Opt-in: returned only when sections includes report_coverage. "
+}

addedOutput schema / properties / sources / items / properties / licence_checked_at
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```
addedOutput schema / properties / sources / items / properties / licence_evidence_url
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```
addedOutput schema / properties / sources / items / properties / rights_status
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```

addedOutput schema / properties / tourism

Added value: +{
+  "additionalProperties": true,
+  "description": "Opt-in: returned only when sections includes tourism. TU110 annual county totals and normalized TU121 national monthly arrivals; independent periods, null means not reported. Cost is not revenue/profit/yield.",
+  "properties": {
+    "annual": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "county": {
+            "type": "string"
+          },
+          "period": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "annual_total": {
+      "type": "integer"
+    },
+    "monthly": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "period": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "monthly_total": {
+      "type": "integer"
+    },
+    "sources": {
+      "items": {
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "truncated": {
+      "type": "boolean"
+    }
+  },
+  "type": "object"
+}

Changed1 schema field changedSep 27, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "aid": {
+      "additionalProperties": true,
+      "properties": {
+        "decisions": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "period": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "sum": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "sum_reason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "unit": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "year": {
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "as_of": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "bankruptcies": {
+      "type": [
+        "string",
+        "number",
+        "boolean",
+        "null"
+      ]
+    },
+    "company_count": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "company_count_reason": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "counties": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "aid_sum": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "company_count": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "county": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "employees": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "median_revenue": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "counties_compare": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "company_count": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "county": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "median_revenue": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "median_revenue_reason": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "county": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "delta_pct": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "delta_pct_reason": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "demography": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "deleted": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "new": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "year": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "disclaimer": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "employees_total": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "employees_total_reason": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "employees_unit": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "found": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "gross_wage": {
+      "type": [
+        "string",
+        "number",
+        "boolean",
+        "null"
+      ]
+    },
+    "largest": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "registry_code": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "revenue": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "revenue_unit": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "year": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "median_revenue": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "median_revenue_reason": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "median_revenue_unit": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "median_series": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "median_revenue": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "reason": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "unit": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "year": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "municipalities": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "company_count": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "median_revenue": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "median_revenue_reason": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "unit": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "open_call_count": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "partial": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "sectors": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "company_count": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "employees": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "employees_reason": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "emtak": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "label": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "revenue_sum": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "revenue_sum_reason": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "share_pct": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "share_pct_reason": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "slug": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "snapshot_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "sources": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "attribution": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "licence": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "licence_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "transactions": {
+      "additionalProperties": true,
+      "properties": {
+        "frozen_at": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "median_price_m2": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "note": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "note_code": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "note_params": {
+          "additionalProperties": true,
+          "properties": {},
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "partial": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "period": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "property_type": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "reason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "unit": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "truncated": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "unemployment": {
+      "additionalProperties": true,
+      "properties": {
+        "period": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "reason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "source": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "unit": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "value": {
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "wage_municipalities": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "unit": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "value": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "year": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "year_label": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "snapshot_id",
+    "as_of",
+    "sources",
+    "disclaimer"
+  ],
+  "title": "region_statsOutput",
+  "type": "object"
+}

First observedSep 26, 2026

TDQS

A4.1/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover read-only/safe, but the description adds substantial semantic guardrails beyond them: small-cell suppression, 'labour taxes are not wages', unemployment is a count not a rate, filing absence is not non-filing, ceilings are not spend, property stock counts units not dwellings, transactions are dated aggregates to never pool, truncated lists keep totals. This is exactly the kind of caveat an agent needs to interpret results correctly.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core purpose is front-loaded, and most caveats carry real informational weight, but the body is an undifferentiated semicolon stream that mixes purpose, caveats, sibling routing and report codes. It could be reorganized into scannable groups without losing content.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return values needn't be explained, and the description covers the key interpretive edge cases and parameter semantics thoroughly. It is complete for correct invocation; only structure, not coverage, is the weakness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% so the baseline is 3, but the description adds interpretation: county omission semantics, the enumerated sections and their purpose ('quarterly figures, filing coverage, labour market...'), and the national_construction null-without-county behavior. It does little for quarterly_form beyond the schema's own text.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening ('County medians, employment and aid; omit county for all counties') names the resource and scope clearly enough that an agent knows it returns county-level statistics, and 'Use sector_stats for an industry' distinguishes it from a sibling. It never states a clean verb+resource sentence, but the coverage of what data comes back is specific.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides concrete when-to guidance: omit county to get all counties, use sector_stats for industry queries, and 'Do not look up natural persons, owners or parcel records' states exclusions. The guidance is scattered across the paragraph rather than structured, but it does name alternatives and boundaries.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Ärikratt tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?