# Invokely

> Official statistics for AI agents. One MCP or REST call returns a figure with its unit, period, resolved place and a citable official source. Coverage: the United States by state and county, European Union countries and regions, and Spain down to municipality.

Use the MCP server for answers that need an official number. Always cite the source block and the period. For municipal unemployment in Spain use registered_unemployment_rate; the survey unemployment_rate for Spain is published only down to province.

## Connect
- [MCP server](https://invokely.ai/mcp): Streamable HTTP. API key (Authorization: Bearer ivk_...) or OAuth for Claude.ai and ChatGPT connectors.
- [MCP trial](https://invokely.ai/mcp/trial): No account, 25 calls a day per IP address.
- [Agent documentation](https://invokely.ai/docs): Tools, arguments, response format, client configuration.
- [OpenAPI](https://invokely.ai/openapi.json): REST API description.

## Tools
- search_indicators: Find official statistical indicators by natural language, in English or Spanish. Use this first when you do not know the exact indicator id.
- resolve_place: Turn a place name into the normalized entity Invokely uses, with its official codes (INE, Idescat, NUTS, ISO, US FIPS) and parent.
- get_value: Get one official figure for an indicator and place: the latest by default, or a given period.
- get_series: Get the time series of an indicator for one place, oldest to newest, from one source so the points are comparable.
- compare: Compare one indicator across 2 to 10 places for the same period, using one shared source and definition whenever possible.

## Indicators
- population: Population. Resident population. Spain and the EU: 1 January, with Spanish figures from the official municipal register (Padrón). United States: Census Bureau population estimates for 1 July.
- population_16_64: Population aged 16 to 64. Resident population aged 16 to 64 on 1 January (INE annual census). Used as the working-age denominator.
- population_density: Population density. Resident population divided by land area in km².
- foreign_population_share: Foreign nationals share of population. Residents with foreign nationality as a percentage of total population on 1 January.
- population_65_plus_share: Population aged 65 and over. Residents aged 65 or over as a percentage of total population on 1 January.
- median_age: Median age. Age that divides the resident population into two halves of equal size. Spain and the EU: on 1 January. United States: American Community Survey five-year estimate, where the period shown is the last year of the five-year span.
- average_age: Average age. Mean age of the resident population on 1 January.
- dependency_ratio: Dependency ratio. Population under 16 plus population 65 and over, divided by population aged 16 to 64, times 100.
- births_july_june: Live births, July to June. Estimated live births to resident mothers from July 1 of the previous year through June 30 of the reported year.
- deaths_july_june: Deaths, July to June. Estimated deaths of residents from July 1 of the previous year through June 30 of the reported year.
- crude_birth_rate_july_june: Crude birth rate, July to June. Estimated live births from July 1 of the previous year through June 30 of the reported year per 1,000 residents, using the average of the population estimates at the two July 1 endpoints.
- crude_death_rate_july_june: Crude death rate, July to June. Estimated deaths from July 1 of the previous year through June 30 of the reported year per 1,000 residents, using the average of the population estimates at the two July 1 endpoints.
- births: Live births. Live births to mothers resident in the area during the year.
- deaths: Deaths. Deaths of residents in the area during the year.
- crude_birth_rate: Crude birth rate. Live births per 1,000 residents during the year.
- crude_death_rate: Crude death rate. Deaths per 1,000 residents during the year.
- fertility_rate: Total fertility rate. Average number of children a woman would have over her lifetime at current age-specific fertility rates.
- life_expectancy: Life expectancy at birth. Average number of years a newborn would live at current age-specific mortality, both sexes.
- registered_unemployment: Registered unemployment. Job seekers registered as unemployed at public employment offices on the last working day of the month.
- registered_unemployment_rate: Registered unemployment rate. Registered unemployment divided by resident population aged 16 to 64 of the same year, times 100. Comparable across municipalities, provinces, regions and Spain.
- unemployment_rate: Unemployment rate. Unemployed people as a percentage of the labour force, using the survey definition of unemployment: without work, available and looking for work. Spain: EPA, aged 16 and over. EU: Labour Force Survey, aged 15 to 74. United States: civilian labour force aged 16 and over, from the Current Population Survey for the nation and from BLS Local Area Unemployment Statistics models, consistent with that survey, for states and counties.
- youth_unemployment_rate: Youth unemployment rate (under 25). Unemployed people under 25 as a percentage of the labour force under 25.
- employment_population_ratio: Employment-population ratio. Employed people as a percentage of the civilian noninstitutional population aged 16 and older.
- labor_force_participation_rate: Labor force participation rate. The labor force, comprising employed and unemployed people, as a percentage of the civilian noninstitutional population aged 16 and older.
- employment_rate: Employment rate. Employed people as a percentage of the population aged 16 and over (Spain, EPA) or 20 to 64 (EU headline indicator).
- activity_rate: Activity rate. Labour force (employed plus unemployed) as a percentage of the population aged 16 and over (Spain, EPA) or 15 to 64 (EU).
- social_security_affiliates: Social Security affiliates. Workers registered with Social Security, by place of residence or work centre as stated by the source.
- cpi_index: Consumer price index (CPI). INE consumer price index, general index, base 2021 = 100.
- cpi_annual_change: Inflation (CPI annual change). Percentage change of the general CPI with respect to the same month of the previous year.
- hicp_annual_rate: HICP inflation (annual rate). Harmonised index of consumer prices, all items, annual rate of change. Comparable across EU countries.
- net_income_per_person: Average net income per person. Average annual net income per person, from tax and social security records (INE household income distribution atlas). Reference year is the income year.
- net_income_per_household: Average net income per household. Average annual net income per household (INE household income distribution atlas).
- gini_index: Gini index. Income inequality on a 0 to 100 scale, where 0 is perfect equality.
- at_risk_of_poverty_rate: At-risk-of-poverty rate. Share of people with equivalised disposable income below 60% of the national median, after social transfers.
- poverty_rate: Poverty rate (US official measure). People living in families or alone with income below the official US poverty thresholds, as a percentage of people whose poverty status can be determined. United States: Census Bureau Small Area Income and Poverty Estimates (SAIPE), all ages.
- median_household_income: Median household income. Household income in the past 12 months at the middle of the distribution, in US dollars adjusted to the last year of the period. United States: American Community Survey five-year estimate, where the period shown is the last year of the five-year span.
- minimum_wage: Monthly minimum wage. Statutory gross monthly minimum wage in EUR (Eurostat, adjusted to 12 payments a year where paid in more).
- gdp: Gross domestic product (GDP). GDP at current market prices, EUR million.
- gdp_usd: Gross domestic product (GDP), US dollars. GDP at current prices, millions of US dollars. United States: Bureau of Economic Analysis GDP by state (the national figure is the total of the same table) and GDP by county.
- gdp_per_capita: GDP per capita. GDP at current market prices divided by population, EUR per inhabitant.
- gdp_per_capita_pps: GDP per capita in PPS (EU27 = 100). GDP per inhabitant in purchasing power standards as a percentage of the EU27 average.
- gdp_growth: Real GDP growth. Annual percentage change of GDP in chain-linked volumes.
- house_price_index_us_monthly_1991: US house price index, January 1991 = 100. Monthly FHFA purchase-only index of single-family house prices, with January 1991 equal to 100.
- house_price_index_us_quarterly_1991: US house price index, Q1 1991 = 100. Quarterly FHFA purchase-only index of single-family house prices, with the first quarter of 1991 equal to 100.
- house_price_annual_change_monthly: House price annual change, monthly. Percentage change in the monthly house price index compared with the same month of the previous year.
- house_price_index: House price index. House price index (INE IPV, base 2015 = 100), all dwellings.
- house_price_annual_change: House prices, annual change. Percentage change of the house price index with respect to the same quarter of the previous year.
- housing_transactions: Home sales. Dwelling sale transactions registered in property registries during the month.
- mortgages: Home mortgages. Number of mortgages constituted on dwellings during the month.
- average_mortgage_amount: Average home mortgage amount. Average amount of mortgages constituted on dwellings during the month, EUR.
- active_companies: Active companies. Active companies on 1 January (INE Central Business Directory, DIRCE).
- companies_created: New companies created. Commercial companies registered in the Mercantile Registry during the month.
- hotel_overnight_stays: Hotel overnight stays. Nights spent by guests in hotel establishments during the month (INE hotel occupancy survey).
- hotel_guests: Hotel guests. Guests checked into hotel establishments during the month.
- international_tourists: International tourist arrivals. Non-resident tourists arriving in Spain by main destination region (INE FRONTUR).
- tourist_nights: Nights spent in tourist accommodation. Nights spent at hotels, holiday accommodation, campsites and similar establishments (Eurostat). Comparable across EU countries and regions.
- euribor_12m: 12-month Euribor. Monthly average of the daily 12-month Euribor rate.
- mortgage_interest_rate: Interest rate on new home loans. Annualised agreed rate (TEDR) on new loans to households for house purchase in Spain.
- federal_debt_gdp_ratio: Gross federal debt to GDP. US gross federal debt outstanding at the end of the fiscal year as a percentage of fiscal-year GDP.
- government_debt: Government debt. General government consolidated gross debt (Maastricht definition) as a percentage of GDP.
- government_deficit: Government balance. General government net lending (+) or net borrowing (-) as a percentage of GDP.

## Optional
- [Methodology](https://invokely.ai/docs/methodology)
- [Sources](https://invokely.ai/sources)
- [Data catalog](https://invokely.ai/data)
- [Pricing](https://invokely.ai/pricing)