Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SPAIN_MCP_OFFLINENo`1` serves only from cache (tests, evals)
SPAIN_MCP_CACHE_DIRNoOn-disk cache of upstream responses~/.cache/spain-open-data-mcp
SPAIN_MCP_HTTP_TIMEOUTNoSeconds per upstream request60

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
resolve_placeA

Find the INE code and level (CCAA, province, municipality, district, tract) for a place in Spain.

Use this first when a question names a place. Returns the best match first, with
alternatives (e.g. 'Valencia' is both a city and a province). Handles accents, Basque,
Catalan and Galician names, and common English names (Seville, Catalonia).
Neighbourhood names are not supported; use districts or tracts from `demographics`
or `income` with `sub_areas`.
demographicsA

Population, sex, five-year age bands, 5-year trend, and household profile for a place in Spain.

Municipality, province and CCAA: census population by age band (latest 1 January),
cross-checked against the official Padrón figure. Municipality, district and tract:
household size, single-person households, mean age, share under 18 and 65+ from INE's
income atlas. Use sub_areas to compare a city's districts or tracts, e.g. to find
where young families or older residents concentrate.
incomeA

Household income for a place in Spain from INE's income atlas, down to census tract.

Returns net and gross income per person and per household, mean and median per consumption unit, inequality (Gini, P80/P20), income sources (wages, pensions, benefits), a trend, and benchmarks against the province, region and Spain. Use it for purchasing power, price positioning and choosing between districts. Figures are euros of the data year; the atlas runs about two years behind.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
data-licencesWhere each figure comes from, its licence and the attribution it requires.

TDQS

A4/5.0

Scored across 3 tools

Disambiguation5/5

Each tool targets a clearly distinct concern: resolve_place does code/level lookup, demographics returns population/household data, and income returns economic data. Descriptions explicitly explain when to use each and how they chain, leaving little room for misselection.

Naming Consistency3/5

Names mix conventions: resolve_place is a verb_noun pattern while demographics and income are bare nouns. It is still readable and each name is self-explanatory, but there is no single predictable pattern.

Tool Count3/5

Three tools is on the thin side for a server branded as covering Spanish open data broadly, though it is coherent for a focused socioeconomic surface. Each tool earns its place but the set feels lean.

Completeness4/5

The resolve_place → demographics/income chain gives a complete workflow for place-based socioeconomic queries, with sub_areas supporting drill-down. Gaps exist for other open-data domains (housing, employment, health), but the stated socioeconomic purpose is well covered.

Maintenance

ActivityMaintained
ResponsivenessUnresponsive