DatoQA — Economic Indicators
Official country economic indicators and annual history, with units, dates, citations and gaps.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~8,220Tokens (tool definitions)
~6.8 KBTypical response size
Significant attention impact (6.42% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"economic-indicators": {
"url": "https://datoqa.bhazarstudio.workers.dev/mcp/economy"
}
}
}Remote endpoints
https://datoqa.bhazarstudio.workers.dev/mcp/economystreamable-httpWhat it can do
Tool inventory
Tools (13)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢catalog(report_countries, report_indicators, report_from, report_to, language)
Inspect this connection’s scope, tools and access policy. With no arguments returns the usual catalog. On the general or economy connection, optionally supply report_countries (1–10 World Bank codes) for a FREE live preview of the optional paid country comparison: population/GDP/inflation by default, or up to six selected historical indicators over ten years, aligned JSON and CSV, definitions and source evidence. Preview reports price, missing cells, availability and the exact HTTP purchase path; it never signs or pays. Existing data tools remain free. Buying requires an authorized x402 HTTP client, not just MCP. Source/schema checks are not independent factual verification.
Input Schema
{
"type": "object",
"properties": {
"report_countries": {
"description": "Optional free preview for these distinct World Bank country codes, e.g. FRA, DEU, ESP. General/economy connections only.",
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z0-9]{3}$"
}
},
"report_indicators": {
"description": "Custom historical comparison: select up to six of the 22 WDI indicators. Supply report_from and report_to together, up to ten years. Missing cells block payment.",
"minItems": 1,
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"enum": [
"population",
"gdp",
"gdp_per_capita",
"gdp_real",
"gdp_growth",
"inflation",
"life_expectancy",
"fertility",
"urban_population",
"internet_users",
"electricity_access",
"unemployment",
"renewable_energy",
"forest_area",
"agricultural_land",
"trade",
"exports",
"imports",
"infant_mortality",
"basic_drinking_water",
"basic_sanitation",
"primary_completion"
]
}
},
"report_from": {
"type": "integer",
"minimum": 1960,
"maximum": 9007199254740991
},
"report_to": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 2025
},
"language": {
"default": "en",
"type": "string",
"enum": [
"en",
"fr"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"const": "DatoQA"
},
"version": {
"type": "string"
},
"available_records": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"title": {
"type": "string"
},
"profile": {
"type": "string"
},
"tools": {
"type": "array",
"items": {
"type": "string"
}
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
}
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
}
},
"required": [
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"description": "General availability catalog or a scoped thematic directory; theme metadata is not a live availability guarantee."
}🟢list_us_economic_indicators
Discover three official BLS US monthly series, original units, seasonal adjustment, latest periods and freshness. Rolling ten calendar years, not a full archive. CPI is an index, payroll employment counts jobs in thousands. Read source notes.
Input Schema
{
"type": "object",
"properties": {}
}Output Schema
{
"type": "object",
"properties": {
"country": {
"type": "string"
},
"source": {
"type": "string"
},
"endpoint": {
"type": "string"
},
"requested_window": {
"type": "object",
"properties": {
"from": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"to": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
},
"indicators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"available",
"source_unavailable_or_stale"
]
},
"period": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"latest_available": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"numeric_values": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"missing_values": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"freshness": {
"anyOf": [
{
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"key",
"status",
"period",
"latest_available",
"numeric_values",
"missing_values",
"freshness",
"citation"
],
"additionalProperties": {}
}
},
"refresh_interval_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"max_collection_age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"notice": {
"type": "string"
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
}
},
"required": [
"country",
"source",
"endpoint",
"requested_window",
"indicators",
"refresh_interval_seconds",
"max_collection_age_seconds",
"notice",
"independently_verified"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_us_economic_indicators(indicator, limit, period)
BLS US monthly consumer_price_index (CPI-U NSA, 1982-84=100), unemployment (SA percent civilian labor force 16+), nonfarm_employment (SA thousands of payroll jobs). Default last 12 monthly periods; limit 1-120 or exact period YYYY-MM, mutually exclusive. Retains source decimals, missing values, preliminary/revision footnotes and evidence. Not real-time, a percent inflation rate or monthly job creation; not independently verified.
Input Schema
{
"type": "object",
"properties": {
"indicator": {
"type": "string",
"enum": [
"consumer_price_index",
"unemployment",
"nonfarm_employment"
],
"description": "BLS monthly series key; use list_us_economic_indicators to check availability and units."
},
"limit": {
"description": "Latest monthly periods, default 12; omit when period is supplied.",
"type": "integer",
"minimum": 1,
"maximum": 120
},
"period": {
"description": "Exact source month YYYY-MM, for example 2025-06; cannot be combined with limit.",
"type": "string"
}
},
"required": [
"indicator"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"source_unavailable_or_stale",
"period_not_covered",
"published_monthly_data",
"no_numeric_data_in_period"
],
"description": "Read this before using values; a successful transport does not establish data availability."
},
"returned": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Domain-specific result count, not necessarily the number of stored records in items."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"domain": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Source-specific payload; inspect units, observation dates, nulls and source notes."
},
"freshness": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
"provenance": {
"type": "object",
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"source_url": {
"type": "string"
},
"license": {
"type": "string"
},
"retrieved_at": {
"type": "string"
},
"verified_at": {
"type": "string"
},
"valid_until": {
"type": "string"
},
"verification_method": {
"type": "string"
},
"content_sha256": {
"type": "string"
},
"verification_level": {
"type": "string",
"enum": [
"official_source_and_schema_checked",
"public_aggregator_and_schema_checked",
"method_specific"
]
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"verification_scope": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"source_id",
"source_name",
"source_url",
"license",
"retrieved_at",
"verified_at",
"valid_until",
"verification_method",
"content_sha256",
"verification_level",
"independently_verified",
"verification_scope"
],
"additionalProperties": false
},
"display_label": {
"type": "string"
}
},
"required": [
"id",
"domain",
"data",
"freshness",
"citation",
"provenance"
],
"additionalProperties": {}
}
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"notice": {
"type": "string"
},
"directory": {
"type": "string"
},
"available_period": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
}
},
"required": [
"status",
"returned",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢list_interest_rate_series(provider)
Discover scoped official policy rates: provider=boe for UK Bank Rate daily since 1975 (historical regimes and notes preserved); fed for eight US series with distinct starts since 1982 (pre-1994 target reconstructed); ecb for three current instruments and historical minimum-bid refinancing since 1999, sparse dates of changes; boc default for two Canadian daily series since 2010. Original bank data free. Inspect coverage, units, freshness and source notes. Not independently verified.
Input Schema
{
"type": "object",
"properties": {
"provider": {
"default": "boc",
"type": "string",
"enum": [
"boc",
"ecb",
"fed",
"boe"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"available",
"source_unavailable_or_stale"
]
},
"provider": {
"type": "string",
"enum": [
"boc",
"ecb",
"fed",
"boe"
]
},
"providers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"endpoint": {
"type": "string"
},
"country": {
"type": "string"
},
"configured_series": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"coverage": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"freshness": {
"anyOf": [
{
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"query": {
"type": "string"
},
"refresh_interval_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"max_collection_age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"notice": {
"type": "string"
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
}
},
"required": [
"status",
"endpoint",
"country",
"configured_series",
"coverage",
"freshness",
"citation",
"query",
"refresh_interval_seconds",
"max_collection_age_seconds",
"notice",
"independently_verified"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_interest_rates(provider, series, year, date, format)
Retrieve or export central-bank policy rates in percent. provider=boe series=bank_rate since 1975; boc default overnight_target/bank_rate since 2010; ecb deposit_facility/main_refinancing/marginal_lending and historical main_refinancing_minimum_bid since 1999; fed eight series from directory with distinct starts since 1982. Latest numeric observation by default, optional year or exact date (mutually exclusive). format=csv provides a ready-to-import table with notes and provenance. No date filling, inferred announcement dates or retail quotes. Historical instruments are not current rates. Original source data free; not independently verified.
Input Schema
{
"type": "object",
"properties": {
"provider": {
"default": "boc",
"type": "string",
"enum": [
"boc",
"ecb",
"fed",
"boe"
]
},
"series": {
"type": "string",
"enum": [
"overnight_target",
"bank_rate",
"deposit_facility",
"main_refinancing",
"main_refinancing_minimum_bid",
"marginal_lending",
"federal_funds_target",
"federal_funds_lower",
"federal_funds_upper",
"reserve_balances",
"excess_reserves",
"required_reserves",
"primary_credit",
"overnight_reverse_repo"
]
},
"year": {
"type": "integer",
"minimum": 1975,
"maximum": 9007199254740991
},
"date": {
"type": "string"
},
"format": {
"default": "json",
"description": "CSV includes selected observations, original decimals, null flags, definitions and provenance. MCP returns CSV content alongside JSON; source-date gaps keep JSON only.",
"type": "string",
"enum": [
"json",
"csv"
]
}
},
"required": [
"series"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"source_unavailable_or_stale",
"year_not_covered",
"published_rates",
"no_numeric_data_in_period"
],
"description": "Read this before using values; a successful transport does not establish data availability."
},
"returned": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Domain-specific result count, not necessarily the number of stored records in items."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"domain": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Source-specific payload; inspect units, observation dates, nulls and source notes."
},
"freshness": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
"provenance": {
"type": "object",
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"source_url": {
"type": "string"
},
"license": {
"type": "string"
},
"retrieved_at": {
"type": "string"
},
"verified_at": {
"type": "string"
},
"valid_until": {
"type": "string"
},
"verification_method": {
"type": "string"
},
"content_sha256": {
"type": "string"
},
"verification_level": {
"type": "string",
"enum": [
"official_source_and_schema_checked",
"public_aggregator_and_schema_checked",
"method_specific"
]
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"verification_scope": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"source_id",
"source_name",
"source_url",
"license",
"retrieved_at",
"verified_at",
"valid_until",
"verification_method",
"content_sha256",
"verification_level",
"independently_verified",
"verification_scope"
],
"additionalProperties": false
},
"display_label": {
"type": "string"
}
},
"required": [
"id",
"domain",
"data",
"freshness",
"citation",
"provenance"
],
"additionalProperties": {}
}
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"notice": {
"type": "string"
},
"directory": {
"type": "string"
},
"available_years": {
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"series": {
"type": "string"
},
"requested_date": {
"type": [
"string",
"null"
]
},
"latest_only": {
"type": "boolean"
}
},
"required": [
"status",
"returned",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢list_economic_indicators
Eurostat EU/EFTA country codes and monthly/quarterly economic series since 2020. Includes latest published periods, source definitions, units and collection status. Country codes differ from World Bank; Greece is EL.
Input Schema
{
"type": "object",
"properties": {}
}Output Schema
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"endpoint": {
"type": "string"
},
"country_code_system": {
"type": "string"
},
"countries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"code",
"name"
],
"additionalProperties": false
}
},
"configured_country_allowlist": {
"type": "array",
"items": {
"type": "string"
}
},
"indicators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
}
},
"required": [
"key"
],
"additionalProperties": {}
}
},
"period": {
"type": "string"
},
"refresh_interval_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"max_collection_age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"collection": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
}
},
"required": [
"source",
"endpoint",
"country_code_system",
"countries",
"configured_country_allowlist",
"indicators",
"period",
"refresh_interval_seconds",
"max_collection_age_seconds",
"collection",
"independently_verified"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_economic_indicators(country, indicator, limit, language)
Eurostat HICP annual inflation rate (monthly), seasonally adjusted unemployment rate (monthly), or real GDP growth over the previous quarter (quarterly). EU/EFTA only, since 2020 through latest published periods. Source flags, missing cells, units and evidence retained. Use list_economic_indicators for countries; not real-time or independently verified.
Input Schema
{
"type": "object",
"properties": {
"country": {
"type": "string",
"description": "Eurostat EU/EFTA country code from list_economic_indicators, for example FR or EL for Greece; not a World Bank three-character code."
},
"indicator": {
"type": "string",
"enum": [
"inflation",
"unemployment",
"gdp_growth"
],
"description": "Eurostat series key from list_economic_indicators; check frequency, units and adjustment."
},
"limit": {
"default": 24,
"description": "Maximum latest monthly or quarterly observations returned, default 24.",
"type": "integer",
"minimum": 1,
"maximum": 240
},
"language": {
"default": "en",
"description": "Response metadata language: en or fr; original source notes are preserved.",
"type": "string",
"enum": [
"en",
"fr"
]
}
},
"required": [
"country",
"indicator"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"source_unavailable_or_stale",
"available_in_scoped_coverage",
"no_data_in_period"
]
},
"returned": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"country": {
"type": "string"
},
"indicator": {
"type": "string"
},
"directory": {
"type": "string"
},
"record": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"domain": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Source-specific payload; inspect units, observation dates, nulls and source notes."
},
"freshness": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
"provenance": {
"type": "object",
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"source_url": {
"type": "string"
},
"license": {
"type": "string"
},
"retrieved_at": {
"type": "string"
},
"verified_at": {
"type": "string"
},
"valid_until": {
"type": "string"
},
"verification_method": {
"type": "string"
},
"content_sha256": {
"type": "string"
},
"verification_level": {
"type": "string",
"enum": [
"official_source_and_schema_checked",
"public_aggregator_and_schema_checked",
"method_specific"
]
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"verification_scope": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"source_id",
"source_name",
"source_url",
"license",
"retrieved_at",
"verified_at",
"valid_until",
"verification_method",
"content_sha256",
"verification_level",
"independently_verified",
"verification_scope"
],
"additionalProperties": false
},
"display_label": {
"type": "string"
}
},
"required": [
"id",
"domain",
"data",
"freshness",
"citation",
"provenance"
],
"additionalProperties": {}
},
"interpretation": {
"type": "object",
"properties": {
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
}
},
"required": [
"independently_verified"
],
"additionalProperties": {}
}
},
"required": [
"status",
"returned",
"country",
"indicator"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_indicators(country, indicator, language)
Annual population, GDP in current US dollars and CPI inflation from World Bank WDI worldwide economies. Use list_countries for supported three-character codes. Five completed years only, not real-time. Returns units, definitions, producers, footnotes and provenance. Null is missing, never zero. Not independently verified.
Input Schema
{
"type": "object",
"properties": {
"country": {
"type": "string",
"pattern": "^[A-Z0-9]{3}$",
"description": "World Bank three-character economy code from list_countries, for example USA or FRA."
},
"indicator": {
"description": "Optional annual series: population, gdp (current USD), or inflation (annual CPI percent). Omit for all three.",
"type": "string",
"enum": [
"population",
"gdp",
"inflation"
]
},
"language": {
"default": "en",
"description": "Response metadata language: en or fr; original producer attribution is preserved.",
"type": "string",
"enum": [
"en",
"fr"
]
}
},
"required": [
"country"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"source_unavailable",
"country_not_supported",
"source_stale",
"available_in_scoped_coverage",
"partially_unavailable"
],
"description": "Read this before using values; a successful transport does not establish data availability."
},
"returned": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Domain-specific result count, not necessarily the number of stored records in items."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"domain": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Source-specific payload; inspect units, observation dates, nulls and source notes."
},
"freshness": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
"provenance": {
"type": "object",
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"source_url": {
"type": "string"
},
"license": {
"type": "string"
},
"retrieved_at": {
"type": "string"
},
"verified_at": {
"type": "string"
},
"valid_until": {
"type": "string"
},
"verification_method": {
"type": "string"
},
"content_sha256": {
"type": "string"
},
"verification_level": {
"type": "string",
"enum": [
"official_source_and_schema_checked",
"public_aggregator_and_schema_checked",
"method_specific"
]
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"verification_scope": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"source_id",
"source_name",
"source_url",
"license",
"retrieved_at",
"verified_at",
"valid_until",
"verification_method",
"content_sha256",
"verification_level",
"independently_verified",
"verification_scope"
],
"additionalProperties": false
},
"display_label": {
"type": "string"
}
},
"required": [
"id",
"domain",
"data",
"freshness",
"citation",
"provenance"
],
"additionalProperties": {}
}
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"notice": {
"type": "string"
},
"directory": {
"type": "string"
},
"as_of": {
"type": "string"
},
"country": {
"type": "string"
},
"language": {
"type": "string",
"enum": [
"en",
"fr"
]
},
"coverage": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"interpretation": {
"type": "object",
"properties": {
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
}
},
"required": [
"independently_verified"
],
"additionalProperties": {}
}
},
"required": [
"status",
"returned",
"items",
"as_of",
"country",
"language",
"coverage",
"interpretation"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢list_countries
List economies and territories available for annual indicators. Aggregated regions are excluded. Coverage and missing values vary by indicator.
Input Schema
{
"type": "object",
"properties": {}
}Output Schema
{
"type": "object",
"properties": {
"countries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"iso2": {
"type": "string"
},
"name": {
"type": "string"
},
"region": {
"type": "string"
}
},
"required": [
"code",
"iso2",
"name",
"region"
],
"additionalProperties": false
}
},
"count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"scope": {
"type": "string"
}
},
"required": [
"countries",
"count",
"retrieved_at",
"scope"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_historical_indicators
List twenty-two annual World Bank historical series, units, definitions via records, and latest collection status. Coverage starts in 1960 with missing years preserved. Not real-time.
Input Schema
{
"type": "object",
"properties": {}
}Output Schema
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"code": {
"type": "string"
},
"en": {
"type": "string"
},
"fr": {
"type": "string"
},
"collection": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"required": [
"key",
"code",
"en",
"fr",
"collection"
],
"additionalProperties": {}
}
},
"period": {
"type": "object",
"properties": {
"from": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"to": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
},
"coverage": {
"type": "string"
},
"refresh": {
"type": "string"
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
}
},
"required": [
"items",
"period",
"coverage",
"refresh",
"independently_verified"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_historical_indicators(format, country, indicator, from, to, ...)
Annual historical series for one World Bank country and indicator from 1960 to the last completed year. Use list_historical_indicators for keys and list_countries for countries. Choose GDP per capita, current dollars or constant 2015 dollars explicitly; these are not interchangeable. Nulls are missing, not zero. Provenance and original definitions included; not independently verified.
Input Schema
{
"type": "object",
"properties": {
"format": {
"default": "json",
"description": "CSV content with null flags, original values, source notes and provenance, alongside JSON. No missing-date filling.",
"type": "string",
"enum": [
"json",
"csv"
]
},
"country": {
"type": "string",
"pattern": "^[A-Z0-9]{3}$",
"description": "World Bank three-character economy code from list_countries, for example USA or FRA."
},
"indicator": {
"type": "string",
"enum": [
"population",
"gdp",
"gdp_per_capita",
"gdp_real",
"gdp_growth",
"inflation",
"life_expectancy",
"fertility",
"urban_population",
"internet_users",
"electricity_access",
"unemployment",
"renewable_energy",
"forest_area",
"agricultural_land",
"trade",
"exports",
"imports",
"infant_mortality",
"basic_drinking_water",
"basic_sanitation",
"primary_completion"
],
"description": "Annual series key from list_historical_indicators, for example gdp_per_capita; inspect units before comparing."
},
"from": {
"default": 1960,
"description": "Inclusive first observation year, at least 1960 and no later than to.",
"type": "integer",
"minimum": 1960,
"maximum": 2025
},
"to": {
"default": 2025,
"description": "Inclusive last observation year, no later than the last completed calendar year. Available data may end earlier.",
"type": "integer",
"minimum": 1960,
"maximum": 2025
},
"language": {
"default": "en",
"description": "Response metadata language: en or fr; original definitions and source notes are preserved.",
"type": "string",
"enum": [
"en",
"fr"
]
}
},
"required": [
"country",
"indicator"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"source_unavailable_or_stale",
"available_historical_series",
"no_numeric_data_in_period"
],
"description": "Read this before using values; a successful transport does not establish data availability."
},
"returned": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Domain-specific result count, not necessarily the number of stored records in items."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"domain": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Source-specific payload; inspect units, observation dates, nulls and source notes."
},
"freshness": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
"provenance": {
"type": "object",
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"source_url": {
"type": "string"
},
"license": {
"type": "string"
},
"retrieved_at": {
"type": "string"
},
"verified_at": {
"type": "string"
},
"valid_until": {
"type": "string"
},
"verification_method": {
"type": "string"
},
"content_sha256": {
"type": "string"
},
"verification_level": {
"type": "string",
"enum": [
"official_source_and_schema_checked",
"public_aggregator_and_schema_checked",
"method_specific"
]
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"verification_scope": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"source_id",
"source_name",
"source_url",
"license",
"retrieved_at",
"verified_at",
"valid_until",
"verification_method",
"content_sha256",
"verification_level",
"independently_verified",
"verification_scope"
],
"additionalProperties": false
},
"display_label": {
"type": "string"
}
},
"required": [
"id",
"domain",
"data",
"freshness",
"citation",
"provenance"
],
"additionalProperties": {}
}
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"notice": {
"type": "string"
},
"directory": {
"type": "string"
}
},
"required": [
"status",
"returned",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_record(id)
Get an unexpired record with provenance and its explicit verification level. Source/schema validation is not independent factual verification.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Opaque record id returned by a DatoQA data response. Reuse it exactly; do not invent an id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"domain": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Source-specific payload; inspect units, observation dates, nulls and source notes."
},
"freshness": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
"provenance": {
"type": "object",
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"source_url": {
"type": "string"
},
"license": {
"type": "string"
},
"retrieved_at": {
"type": "string"
},
"verified_at": {
"type": "string"
},
"valid_until": {
"type": "string"
},
"verification_method": {
"type": "string"
},
"content_sha256": {
"type": "string"
},
"verification_level": {
"type": "string",
"enum": [
"official_source_and_schema_checked",
"public_aggregator_and_schema_checked",
"method_specific"
]
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"verification_scope": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"source_id",
"source_name",
"source_url",
"license",
"retrieved_at",
"verified_at",
"valid_until",
"verification_method",
"content_sha256",
"verification_level",
"independently_verified",
"verification_scope"
],
"additionalProperties": false
},
"display_label": {
"type": "string"
}
},
"required": [
"id",
"domain",
"data",
"freshness",
"citation",
"provenance"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_evidence(id)
Retrieve the source JSON snapshot and SHA-256 digest for a currently available record. The digest proves snapshot integrity, not factual truth.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "Record id returned by a DatoQA data response; returns the retained source snapshot for that record."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"record_id": {
"type": "string"
},
"sha256": {
"type": "string"
},
"hash_scope": {
"type": "string",
"const": "utf8_source_payload_json"
},
"source_payload_json": {
"type": "string"
},
"first_observed_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"notice": {
"type": "string"
}
},
"required": [
"record_id",
"sha256",
"hash_scope",
"source_payload_json",
"first_observed_at",
"source_url",
"notice"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence
Recent observations
verifiedversion not recorded13 tools