spain-open-data-mcp

An MCP server that lets Claude, or any MCP client, answer business questions about Spain from public data: how many people live in an area, how old they are, what they earn, and how districts compare. Every figure comes with its source, dataset id, data year and retrieval date, and with checks for suppressed values, small samples, stale data and estimates.

Status: version 0.1, live. Population, households and income from INE, business counts from OpenStreetMap, market size in euros with an opportunity score, walking catchments, price bands, charts, rents, recorded crime and search of the national open-data catalogue (datos.gob.es), down to census tract. Use it hosted as a Claude connector or install it from PyPI (Install).

What the opportunity score is, and is not. It is the market in euros per competing business, against the region. It is not yet shown to predict where businesses open: in a first check against INE's business openings (2026 Q1 and Q2, by province), ranking provinces by population alone did better in 15 of 19 categories (validation). The registered test reports from mid-2027. Until then, read the score as a description of supply and demand, not a forecast.

Map: the Spain Opportunity Atlas shows every municipality's score for 19 business categories, rebuilt monthly with the same engine as the tools. Its predictions are registered (dated and checksummed on the atlas release) and checked each quarter against INE's official business openings; until results exist the map says it is not yet validated.

A real question in Claude through the hosted connector (2026-10-18): a gym chain choosing its next three sites in Madrid. Every figure matches the server's output.

What it can answer today

• "How many people live in Valladolid, and how is the population changing?"
• "Which districts of Valladolid have the highest household income?"
• "How old is the population of Parquesol, in Valladolid?"
• "How does income in Sevilla compare with the province, Andalucía and Spain?"
• "Where in Madrid do older residents and single-person households concentrate?"
• "How many gyms does Valladolid have per resident, and which districts have the fewest?"
• "Which supermarket chains dominate in Las Palmas?"
• "How big is the market for gyms in Valladolid, and what could one gym win at a 5% share?"
• "Which towns in Valladolid province are under-served for pharmacies?"
• "A gym charged €40 a month in Madrid in 2023. What fits in Sevilla today?"
• "Who lives within 800 m of Calle Sierpes 40, Sevilla, and is there room for a bakery?"
• "How many people live within a 10-minute walk of Calle Triana, Las Palmas?"

Example conversations

From real use in Claude (hosted connector, 2026-10-17 and 18; each figure rechecked against the server):

• "I lead expansion for a mid-size gym chain. Rank Madrid's districts for our next 3 sites." Claude ranked all 21 districts by market (€7.8M to €37.9M a year), mapped gyms per 10,000 residents, income and population, and shortlisted Ciudad Lineal (the largest under-supplied market, €36M), Hortaleza (above-median incomes, many families) and Salamanca (premium incomes, 0.76 gyms per 10,000 against 1.3 to 1.4 next door). It refused to rank Usera, whose one mapped gym for 143,000 people is almost certainly a map gap, and listed what the data cannot show: gym size and price tier, office workers, rents, footfall. One slip: it called Hortaleza's share of children (19.2%) the h

... View full README on GitHub