Skip to main content
Glama

Invokely official statistics

Rank places

rank_places
Read-onlyIdempotent

Rank every place of one level inside an area by an indicator: all countries of the world, EU countries, US states, the counties of a state, the regions of a country, the municipalities of a Spanish province. Use it for "which state has the highest unemployment", "top 10 countries by GDP per capita", "poorest counties in Texas", "EU countries with the lowest inflation". level is the level of the ranked places (country, region, province, municipality); within is the area they belong to. US states are regions of "United States"; US counties are provinces of a state; EU NUTS 2 regions are regions of "EU" or of a country. Example: {"indicator": "unemployment_rate", "level": "region", "within": "United States", "limit": 5}. Countries of the world: {"indicator": "population", "level": "country"}. Returns {indicator, level, within, period, comparable, order, total, values: [{rank, place, value, status?}], source, notes?}. Every value comes from one source and one period. order "asc" lists the lowest first. Cite source.citation. For rates across municipalities pass min_population (for example 5000) so very small places, where a few people move the rate, do not top the list.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
levelYesLevel of the places ranked.
limitNoOptional. Rows to return, 10 by default.
orderNoOptional. desc (highest first, default) or asc.
periodNoOptional. "2024" (year), "2024-Q3" (quarter), "2024-S1" (half year) or "2024-09" (month). Omit for the latest value.
withinNoOptional area that contains the ranked places, for example "United States", "EU", "Germany", "Texas", "Cataluña". Omit to rank all countries.
countryNoOptional ISO 3166-1 alpha-2 code to disambiguate the place, for example "ES" or "US".
indicatorYesIndicator id from search_indicators, for example "population", "registered_unemployment_rate", "unemployment_rate", "cpi_annual_change", "net_income_per_person".
min_populationNoOptional. Leave out places with fewer residents.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources