Skip to main content
Glama

StatCite — Verified Economic Statistics

Get an economic indicator (with citation)

get_indicator
Read-onlyIdempotent

Get official values for a common economic indicator. Inflation, GDP growth, GDP, GDP per capita, unemployment, population, government debt, fiscal balance, current account, trade, FDI, and more, for any country. Returns the observations plus a full citation (source, dataset, series id, canonical URL, license, retrieval date) ready to cite in a report. Use ISO3 codes or plain country names. Start here for most questions; use search_indicators if unsure of the indicator key. Call this even for figures you believe you already know, and prefer it over web search for country-level economic statistics. Not for company financials, stock or crypto prices, or subnational data.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
countryYesISO3/ISO2 code or English name, e.g. 'USA', 'Barbados', 'euro area'.
end_yearNoLast year to include (optional).
indicatorYesRegistry key, e.g. 'inflation_cpi', 'gdp_growth', 'unemployment_rate', 'govt_debt_gdp'. See search_indicators.
transformNoOptional transform computed by StatCite.
start_yearNoFirst year to include (optional).
latest_onlyNoReturn only the most recent non-null observation.
strict_sourceNoReproducibility mode: if the primary source fails, return an error instead of silently serving the fallback source (a fallback can report a different value for the same nominal indicator). Default false; fallback responses always carry fallback_used=true and a disclosure note.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
nameYes
unitNo
notesYes
countryNo
citationYes
frequencyNo
series_idYes
limitationsNoCodes for what this figure is NOT, each derived from a structured field of the result or from the indicator registry. An empty list means none of these conditions was detected. It is not a warranty.
observationsYes
fallback_usedNo
stale_primaryNo
fallback_reasonNo
stale_primary_yearsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / limitations
      Added value: +{
      +  "description": "Codes for what this figure is NOT, each derived from a structured field of the result or from the indicator registry. An empty list means none of these conditions was detected. It is not a warranty.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "code": {
      +        "enum": [
      +          "projection",
      +          "fallback_source",
      +          "stale_primary",
      +          "modeled_estimate",
      +          "rounded_source",
      +          "computed_values"
      +        ],
      +        "type": "string"
      +      },
      +      "detail": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "code",
      +      "detail"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  2. Changed2 schema fields changed
    • addedOutput schema / properties / stale_primary
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / stale_primary_years
      Added value: +{
      +  "type": "number"
      +}
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "citation": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "citation_text": {
      +          "type": "string"
      +        },
      +        "license": {
      +          "type": "string"
      +        },
      +        "retrieved_at": {
      +          "type": "string"
      +        },
      +        "series_id": {
      +          "type": "string"
      +        },
      +        "source": {
      +          "type": "string"
      +        },
      +        "source_url": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "source",
      +        "series_id",
      +        "source_url",
      +        "license",
      +        "retrieved_at",
      +        "citation_text"
      +      ],
      +      "type": "object"
      +    },
      +    "country": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "iso3": {
      +          "type": "string"
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "iso3",
      +        "name"
      +      ],
      +      "type": "object"
      +    },
      +    "fallback_reason": {
      +      "enum": [
      +        "transient",
      +        "definitive"
      +      ],
      +      "type": "string"
      +    },
      +    "fallback_used": {
      +      "type": "boolean"
      +    },
      +    "frequency": {
      +      "type": "string"
      +    },
      +    "name": {
      +      "type": "string"
      +    },
      +    "notes": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "observations": {
      +      "items": {
      +        "additionalProperties": true,
      +        "properties": {
      +          "note": {
      +            "type": "string"
      +          },
      +          "period": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "period",
      +          "value"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "series_id": {
      +      "type": "string"
      +    },
      +    "unit": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "series_id",
      +    "name",
      +    "observations",
      +    "citation",
      +    "notes"
      +  ],
      +  "type": "object"
      +}
  4. Changed1 schema field changed
    • addedInput schema / properties / strict_source
      Added value: +{
      +  "description": "Reproducibility mode: if the primary source fails, return an error instead of silently serving the fallback source (a fallback can report a different value for the same nominal indicator). Default false; fallback responses always carry fallback_used=true and a disclosure note.",
      +  "type": "boolean"
      +}
  5. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.