# Portugal (public data)

> Portugal (public data) is a free MCP server for legal and government. Weather, statistics, Parliament, contracts, health and transit data for Portugal. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, self-hosted
- **Website:** https://thiagolannes.com
- **Repository:** https://github.com/thiagojacoblannes/portugal-mcp
- **MCP Registry name:** io.github.ThiagoJacobLannes/portugal-mcp
- **Categories:** legal and government, maps and travel, analytics and data
- **Listing updated:** 2026-11-14

## About

Portugal's open data is scattered across many agencies; this server puts it behind one set of read-only tools. Each answer names its official source and date. The README groups tools into features such as weather and warnings from IPMA, postal codes and municipalities, INE and Banco de Portugal statistics, Parliament votes and deputies, public contracts from Portal BASE, SNS emergency and waiting-time figures, medicine shortages, fuel prices, EV chargers and public transport.

Transit covers buses and trains across several cities and regions, including live positions in some. Tools accept questions in Portuguese. An environment variable lets you load only some feature groups or drop others, which keeps the tool list short for smaller context windows.

No keys or accounts are needed, and the author states it is not affiliated with any of the sources. It runs locally from PyPI over stdio or against a hosted streamable-HTTP endpoint.

## Features

- **Weather and risk:** Forecasts, warnings, fire risk, sea state and earthquakes.
- **Official statistics:** INE and Banco de Portugal indicators and series.
- **Parliament and contracts:** Search initiatives, votes, deputies and public contracts.
- **Health data:** Emergency room stats, waiting times and medicine availability.
- **Fuel and EV:** Fuel prices, station details and charger lookup.
- **Public transport:** Bus stops, arrivals, alerts and train or bus departures.
- **Selectable features:** Load or drop feature groups with an environment variable.

## Good for

- Ask what the weather warnings are for a Portuguese district
- Find the cheapest fuel nearby
- Check how a party voted on a parliamentary initiative
- Look up who won a public contract
- Plan the next train from Lisbon to Porto

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http portugal-mcp https://mcp.thiagolannes.com/portugal
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.thiagolannes.com/portugal
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "portugal-mcp": {
      "url": "https://mcp.thiagolannes.com/portugal"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "portugal-mcp": {
      "type": "http",
      "url": "https://mcp.thiagolannes.com/portugal"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "portugal-mcp": {
      "serverUrl": "https://mcp.thiagolannes.com/portugal"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "portugal-mcp": {
      "type": "http",
      "url": "https://mcp.thiagolannes.com/portugal"
    }
  }
}
```

## Tools

- `weather_forecast`: 5-day weather forecast for a place in Portugal (IPMA, official). Args: place: district capital or island town, e.g. "Lisboa", "Porto", "Faro", "Funchal", "Ponta Delgada". lat, lon: use instead of place for anywhere else; the nearest IPMA forecast location is used. Returns daily min/max temperature, rain probability, weather type, wind, and today's UV index.
- `weather_warnings`: Active IPMA weather warnings (rain, wind, heat, cold, snow, fog, sea, thunderstorms). Args: area: optional district or island group, e.g. "Lisboa", "Madeira", "Açores". Omit for the whole country. include_green: also list green (no-warning) entries. Default false.
- `fire_risk`: Wildfire danger (RCM, risco de incêndio rural) for a municipality, today or tomorrow. Args: municipality: concelho name, e.g. "Sintra", "Monchique". day: 0 = today, 1 = tomorrow. Scale: 1 reduzido, 2 moderado, 3 elevado, 4 muito elevado, 5 máximo.
- `sea_forecast`: Coastal sea forecast: wave height and period, wave direction, sea temperature (IPMA). Args: place: coastal spot, e.g. "Nazaré", "Peniche", "Faro", "Funchal". Or pass lat/lon for the nearest one. day: 0 = today, 1 = tomorrow, 2 = the day after.
- `earthquakes`: Recent earthquakes recorded by IPMA. Args: region: "mainland" (mainland Portugal and Madeira) or "azores". days: look back this many days (max 30). min_magnitude: only quakes at or above this magnitude. limit: max rows (newest first).
- `postal_code`: Look up a Portuguese postal code (código postal, 'XXXX-XXX' or 'XXXX'). Returns district, municipality, locality and the streets the code covers, plus a central point.
- `where_is`: Which parish, municipality and district a coordinate is in, plus altitude, land use and hazard maps.
- `municipality`: A municipality (concelho): district, INE code, area, parishes, 2021 census, town-hall contacts.
- `public_holidays`: Portugal's public holidays for a year (default: this year), with weekday. Always lists the national holidays. Pass `municipality` (a concelho, e.g. "Braga", "Lisboa", "Funchal") to add its own municipal holiday and, in the Azores or Madeira, the regional ones: that answers "is tomorrow a holiday in Braga?". Carnival is listed as optional: it is usually a day off by government decision, not by law.
- `ine_search`: Find INE indicators by keyword (e.g. "inflação", "desemprego", "população", "rendas", "turismo"). Searches INE's catalogue of key indicators. Returns varcd codes to pass to ine_indicator. Any other INE indicator can be read with ine_indicator if you know its code (from www.ine.pt). Args: lang: "PT" (more complete wording) or "EN".
- `ine_indicator`: Values of an INE indicator, latest periods first. Args: varcd: 7-digit indicator code from ine_search, e.g. "0008074". place: geography name to keep, e.g. "Portugal", "Lisboa", "Norte", "Porto". Default: "Portugal" when present, otherwise all geographies. periods: how many of the latest reference periods to return (1-24). category: keep only rows whose category labels contain this text (e.g. "Tota
- `bpstat_search`: Find Banco de Portugal statistical series by keyword. Examples: "euribor 12 meses", "taxa de juro novos empréstimos habitação", "dólar", "dívida pública", "depósitos particulares", "preços habitação". The search picks the most likely statistical domains (or the one you pass as domain_id) and searches the series inside them; it also lists every domain so you can retry with a specific domain_id. The
- `bpstat_series`: Observations of Banco de Portugal series (ids from bpstat_search). Args: series_ids: one or more series ids (max 10), e.g. [12559924]. last_n: latest observations per series (1-500). Ignored when `since` is given. since: "YYYY-MM-DD" — return every observation from this date. lang: "PT" or "EN".
- `parliament_search`: Search initiatives in the Portuguese Parliament: bills, resolutions, inquiries. Args: query: words in the title, e.g. "habitação", "IRS", "imigração". type: e.g. "Projeto de Lei", "Proposta de Lei" (Government bills), "Projeto de Resolução". author: party acronym ("PS", "PSD", "CH", "IL", "L", "PCP", "BE", "CDS-PP", "PAN", "JPP") or "Governo". result: "aprovado" or "rejeitado" — keeps initiatives 
- `parliament_initiative`: Full record of one initiative: every phase with dates, every vote with each group's position, text link. Args: initiative_id: the `id` from parliament_search (e.g. "356403"), or a reference like "Proposta de Lei 3".
- `parliament_votes`: Recent plenary votes, with how each parliamentary group voted. Args: party: show this group's position on each vote (e.g. "PS", "CH"); only votes where it is recorded. query: words in the initiative title. since: "YYYY-MM-DD". result: "aprovado" or "rejeitado". limit: max votes, newest first.
- `parliament_deputies`: Members of Parliament (deputados): party, constituency (círculo), status. Seats per party included. Args: name: part of the parliamentary or full name. party: group acronym, e.g. "PSD", "PS", "CH". constituency: e.g. "Lisboa", "Porto", "Açores", "Europa". include_inactive: also list deputies who left or were replaced. Default false.
- `public_contracts`: Search Portuguese public contracts (Portal BASE) for one year. Args: query: words in the contract object, e.g. "software", "limpeza", "ambulâncias". buyer: public body name or 9-digit NIF, e.g. "Município de Lisboa", "SPMS". supplier: company name or NIF. procedure: e.g. "Ajuste Direto", "Concurso público", "Consulta Prévia". min_value, max_value: contract price range in euros. year: contract-file
- `public_contracts_summary`: Totals for one buyer or supplier in a year: number of contracts, total value, by procedure, top partners. Args: entity: name or 9-digit NIF of a public body or a company. role: "buyer", "supplier" or "any". year: default this year. top: how many top counterparties to list.
- `open_data_search`: Search the datasets of Portugal's national open-data portal (dados.gov.pt). Args: query: e.g. "acidentes rodoviários", "escolas", "qualidade do ar", "alojamento local". organization: optional publisher to filter by, e.g. "INE", "Lisboa" or "Câmara Municipal de Cascais" (a town name finds its town hall's datasets: Lisboa, Porto, Cascais, Oeiras...). limit: max results (1-50).
- `open_data_dataset`: Details and downloadable files of one dados.gov.pt dataset (id or slug from open_data_search).
- `open_data_preview`: First rows of a CSV or JSON file hosted on dados.gov.pt (reads at most 512 KB). Args: url: a resource url from open_data_dataset (must be on dados.gov.pt). rows: how many rows to return (1-100).
- `sns_find_institutions`: Find SNS hospitals / local health units (ULS) by name, or the nearest ones to a coordinate. Use this first when the user names a hospital or a place ("hospitals near Lisbon", "is there an emergency department near 38.72,-9.14?"), then pass `stats_entity` to sns_emergency_stats / sns_surgery_wait_stats / sns_consultation_wait_stats. Each result: name, its parent ULS, coordinates, distance_km (when 
- `sns_emergency_stats`: Emergency-department (urgência) visits per month: by type and by Manchester triage colour. Use for "how busy is the ER at X?", "how many emergency visits in the Algarve last month?", "what share of ER visits are green/blue (non-urgent)?". OFFICIAL MONTHLY STATISTICS ONLY — not the live queue (the latest month is usually 2-3 months back and provisional). For live waiting times send the user to http
- `sns_surgery_wait_stats`: Surgery access indicators per month: surgical waiting list, % within the guaranteed maximum time, mean days from admission to surgery, and surgeries performed. Use for "how long is the wait for surgery at X?", "how many people are on the surgery list in the Norte region?", "how many operations did hospital Y do?". Official monthly statistics (latest month usually 2-3 months back, provisional). The
- `sns_consultation_wait_stats`: Hospital outpatient consultations per month and the % of FIRST specialist consultations (referred by a family doctor via CTH/SIGA) held within the guaranteed maximum time (TMRG). Use for "how long is the wait for a first hospital appointment at X?", "is hospital Y on time with first consultations?", "how many consultations did the Centro region do?". Official monthly statistics (latest month usual
- `sns_search_datasets`: Search the ~150 datasets of the SNS Transparency portal (titles and descriptions are in Portuguese). Use when the curated tools don't cover the question — e.g. hospital bed occupancy ("ocupação"), births/caesareans ("partos"), INEM pre-hospital calls, SNS 24 calls, family doctor coverage ("médico de família", "inscritos"), medicines spending, staff ("trabalhadores"), cancer screening ("rastreios")
- `sns_query_dataset`: Run an ODSQL query on any SNS Transparency portal dataset (Opendatasoft Explore API v2.1). Use after sns_search_datasets for anything the curated tools don't cover. Clauses are ODSQL: - where: `instituicao like "santa maria" and tempo >= date'2026-01-01'` (`like` is a case- and accent-insensitive "contains"; dates use date'YYYY-MM-DD') - select: `tempo, instituicao, total_urgencias` or aggregates 
- `medicine_availability`: Is a medicine in shortage in Portugal? Checks Infarmed's published availability information. Use when someone can't find a medicine, or asks whether X is in shortage ("rutura", "esgotado", "falta"). Searches by brand or active substance (Portuguese names work best, e.g. "quetiapina", "Ozempic", "ácido acetilsalicílico"; dose and form narrow it, e.g. "quetiapina 300 mg libertação prolongada"). Chec
- `pharmacies`: Pharmacies in a Portuguese municipality, with which ones are on duty today and open now. Use for "farmácia de serviço em X", "pharmacy open now near me", or to list pharmacies to call. Each pharmacy has name, address, phone, coordinates, today's hours, open_now, on_duty (official duty roster for the duty day 09:00-09:00) and the duty type (e.g. "Permanente - Aberta 24h"). Results are sorted: on du
- `find_medicine_near`: One-shot answer to "I need medicine X in city Y — what do I do?" in Portugal. Runs medicine_availability(medicine) and pharmacies(city or lat/lon), and returns: the shortage status (compact), the pharmacies on duty today and the ones open now (nearest first when lat/lon are given), the help lines (Linha 1400, SNS 24, 112) and next steps. It never says a pharmacy has the medicine: stock is not publ
- `medicine_help`: Verified help lines in Portugal for medicine problems: 112, SNS 24, Linha 1400, Infarmed. Use when someone can't find a medicine, needs urgent advice, or asks who to call. Each line has its number, what it is for, hours where published, and the page it was checked on.
- `fuel_prices`: Cheapest fuel stations in Portugal for one fuel type, cheapest first (official DGEG prices). Use for "where is diesel/petrol/LPG cheapest in Lisboa / near me / in Braga?". Give an area as a district, a municipality, or a point (lat + lon, with radius_km); with no area it searches all of Portugal. Names are case- and accent-insensitive ("evora" works). Args: fuel_type: A DGEG fuel name or id, e.g. 
- `fuel_station_detail`: Full details of one fuel station: every fuel it sells with price and last update, opening hours, services (car wash, shop, tyre air...) and payment methods. Use after fuel_prices, with a station `id` from its results.
- `fuel_types`: List DGEG fuel types (id, name, unit) and the districts accepted by fuel_prices. Only needed when unsure which fuel name to pass; fuel_prices also understands "diesel", "petrol", "95", "98", "lpg".
- `ev_chargers`: Public EV charging sites near a point in Portugal (MOBI.E network), nearest first, with live status and the price the network publishes for each charging point. Use for "where can I charge near X?", "fast chargers near me", "is there a free CCS charger nearby?". Needs coordinates; if the user gives a place name, use known coordinates for it. Covers mainland Portugal, Azores and Madeira. Args: lat,
- `ev_charger_detail`: Everything about one MOBI.E charging site: all its points with live status, power, connectors and price, plus operator contact, opening hours and accepted authentication (app, RFID card, credit card...). Use after ev_chargers. Accepts a site_id (e.g. "EZC-AMD-00051"), a point_id (e.g. "AMD-00051-1") or an EVSE id (e.g. "PT*EZC*E*AMD*00051*1").
- `bus_find_stops`: Find Carris Metropolitana bus stops by name and/or near a coordinate. Use this first whenever the user names a place, street, station or gives a location, to get the stop_id needed by bus_next_arrivals. Results include the lines serving each stop. Args: query: Text to match in the stop name (accent/case-insensitive, all words must match), e.g. "Gare do Oriente", "Cacilhas terminal". A 6-digit stop
- `bus_next_arrivals`: Upcoming buses at a Carris Metropolitana stop, real-time where available. Use for "when is the next bus at X?" (get stop_id from bus_find_stops first). Each arrival says whether it is "realtime" (live GPS estimate) or "scheduled" (timetable only: the bus may not have started its trip yet). minutes_from_now uses the real-time estimate when present. Times are Europe/Lisbon. Only today's operational 
- `bus_line_info`: Details of a Carris Metropolitana line: name, route ends, directions, municipalities. Use for "where does line 4715 go?", "which bus goes from Cacilhas to Almada?", or to check whether a line passes a stop (include_stops=True). If `line` is not an exact line number it is treated as text (e.g. "Oriente Setubal") and the matching lines are listed instead. trips_today = 0 means the line does not run 
- `bus_service_alerts`: Service alerts (detours, works, strikes, stops not served) for Carris Metropolitana. Use before recommending a trip, or when the user asks "is line X disrupted?". Filter by line and/or stop; with no filter, returns all current alerts (there are often ~100). Alerts are mostly published in Portuguese only. Args: line_id: 4-digit line number, e.g. "4407". stop_id: 6-digit stop id, e.g. "160584". incl
- `bus_vehicle_positions`: Live GPS positions of the buses currently running on a Carris Metropolitana line. Use for "where is the 3508 right now?" or to see how many buses are out on a line. Each vehicle includes its position, heading, speed, the stop it is at / heading to, and how many seconds old the fix is. Args: line_id: 4-digit line number, e.g. "3508".
- `transit_operators`: Which transport operators have timetables here, and what each one covers.
- `transit_find_stops`: Find train stations, metro stations or bus/tram stops by name, or the nearest to a point. Args: query: e.g. "Oriente", "Porto Campanhã", "Marquês de Pombal", "Prazeres". operator: an operator id (see transit_operators) or a city/region: "porto", "coimbra", "braga", "aveiro", "cascais", "barreiro", "algarve", "faro", "madeira", or "intercity" (FlixBus coaches and CP). Default: CP and the Lisbon ope
- `transit_departures`: Scheduled departures from a station or stop (official timetable, not live). Args: stop: station or stop name, e.g. "Lisboa Oriente", "Cais do Sodré", "Baixa-Chiado", "Prazeres". operator: an operator id (see transit_operators) or a city/region: "porto", "coimbra", "braga", "aveiro", "cascais", "barreiro", "algarve", "faro", "madeira", or "intercity" (FlixBus coaches and CP). Default: CP and the Li
- `transit_trips_between`: Direct services between two stations (no changes), with departure, arrival and duration. Examples: CP "Lisboa Oriente" → "Porto Campanhã"; Fertagus "Roma-Areeiro" → "Setúbal"; Metro "Alameda" → "Aeroporto" (same line only). Scheduled times, not live. Args: operator: an operator id (see transit_operators) or a city/region: "porto", "coimbra", "braga", "aveiro", "cascais", "barreiro", "algarve", "fa
- `transit_vehicles`: Where the buses (and Lisbon trams) are right now: live positions reported by the vehicles. Args: operator: "stcp" (Porto buses), "smtuc" (Coimbra buses) or "carris" (Lisbon buses and trams). City names work too: "porto", "coimbra", "lisboa". line: keep one line, e.g. "500", "205", "28E", "103". lat, lon: keep the vehicles near this point (within radius_km), closest first. For Greater-Lisbon buses 
- `wildfires`: Burnt areas from wildfires in Portugal, mapped by satellite (EFFIS / Copernicus). Not a live list of fires in progress: EFFIS maps burnt areas from satellite a day or more later, and small fires can be missing. Args: period: "today", "week", "month" or "season" (this year so far). Ignored when `year` is given. year: a past year from 2016, for the whole year. place: keep fires whose region or paris
- `active_incidents`: What emergency services (civil protection, ANEPC) are responding to right now in Portugal, closest first. Live occurrences of every kind: fires, road collisions, fallen trees, floods, rescues, with their status (e.g. "Em Curso"), time started and resources on scene. Updated every few minutes. Police-only activity (PSP/GNR) is not published anywhere and is not included. Args: near: a postal code ("
- `power_cuts`: Planned power cuts (E-REDES maintenance works) for a postal code, municipality or parish. Args: postal_code: "2795-082" for that street, or "2795" for the whole postal area. municipality: e.g. "Sintra", "Vila Nova de Gaia". parish: e.g. "Algés" (matches part of the parish name). days: how far ahead to look (max 60). With nothing given, returns a national summary by municipality.
- `electricity_price`: Portugal's day-ahead wholesale electricity price (OMIE), per 15-minute period, in €/MWh. Useful for indexed ("dynamic") tariffs: when is electricity cheapest to run the washing machine or charge the car. Not the retail price on a normal bill. Args: day: ISO date, e.g. "2026-11-10". Default: the most recent day OMIE has published. cheapest: also list this many cheapest periods (max 12).
- `electricity_grid`: How much electricity mainland Portugal used on a day, the peak, and how much wind, solar and hydro the distribution grid generated (E-REDES, 15-minute data, usually one day behind). Args: day: "YYYY-MM-DD" (default: the latest complete day, usually yesterday). Big power stations feed the transmission grid (REN) and show here only as one total.
- `electricity_local`: Electricity in one place (mainland Portugal): billed consumption per month, and how often and for how long the power went out there in recent years compared with the average municipality. Args: municipality: a concelho, e.g. "Sintra". postal_code: "2710" or "2710-123" (consumption is published per 4-digit area); its municipality is used for the outage figures. months: how many recent months of con
- `local_accommodation`: Look up the national register of local accommodation (Alojamento Local, RNAL). Answers "is this flat/guesthouse registered?" and "how many AL are on my street?". Args: registration: the RNAL number, e.g. "12345/AL" or "12345". name: part of the registered name, e.g. "InSuites". address: part of the street address, e.g. "Rua de Santa Catarina". postal_code: "1200-290", or "1200" for the whole area.
- `tourism_places`: Official tourism places in Portugal, near a point or in a municipality/region. Args: kind: one of blue_flag_beaches, surf_spots, golf, spas, unesco, historic_villages, schist_villages, wine_villages, mountain_villages, marinas, walking_routes, santiago_ways, hotels. place: municipality, parish, district or region name, e.g. "Cascais", "Algarve", "Peniche". name: part of the name, e.g. "Nazaré", "P
- `lisbon_events`: What's on in Lisbon: the city's official cultural agenda (exhibitions, concerts, theatre, dance, cinema, guided visits, kids, festivals). Args: day: ISO date, e.g. "2026-11-14". Default today. until: ISO date to look at a range from `day` (max 31 days). query: words in the title, venue or description, e.g. "fado", "Gulbenkian", "jazz". category: e.g. "música", "teatro", "exposições", "visitas guia
- `lisbon_street_works`: Street works and public-space occupations in Lisbon: what is (or will be) blocking a street. Two official sources: licensed temporary occupations of public space (filming, events, scaffolding, containers...) and the city's road and pavement works in progress or planned. Args: parish: freguesia, e.g. "Arroios", "Santa Maria Maior", "Belém". street: part of a street name (works only), e.g. "Avenida 
- `lisbon_recycling`: The nearest recycling points in Lisbon of a given kind. Args: lat, lon: where you are. kind: "ecoponto" (paper, plastic, glass), "vidrao" (glass), "papel", "oleo" (used cooking oil), "reee" (small electronics), "alimentar" (food waste), "ecoilha", "ecocentro" (large items). radius_m: search radius in metres (max 3000).
- `lisbon_metro_status`: Is the Lisbon Metro running normally right now? Status of the four lines (Amarela, Azul, Verde, Vermelha) as Metropolitano de Lisboa publishes it, with the disruption text if any. For timetables use transit_departures with operator "metro".
- `web_archive_search`: Search old versions of Portuguese websites in Arquivo.pt (full text, since 1996). `site` limits to one domain (e.g. "publico.pt", "cm-porto.pt"). `from_date`/`to_date` take a year, "YYYY-MM" or "YYYY-MM-DD". Each result has the capture date, title, a short snippet and a link to the archived copy. Good for "what did the news say about X in 2010?".
- `web_archive_history`: When was a web address captured by Arquivo.pt, and how often did its content change? Returns the first and last capture, captures per year and up to `max_versions` versions where the content changed (spread over the period), each with a link to the archived copy.
- `web_archive_page`: The text of a web page as Arquivo.pt saved it closest to a date. `when` takes a year, "YYYY-MM" or "YYYY-MM-DD" (default: the latest copy). Returns the capture date, the page title, its readable text (cut at `max_chars`, up to 8000) and the archive link. Quote it briefly; the archive link shows the full page.
- `porto_road_closures`: Streets in Porto with traffic or parking restrictions active on a day (default today). Args: near: a street name ("Rua de Santa Catarina", matches part of it) or a Porto postal code ("4000-457"); or pass lat/lon. radius_km: around a postal code or point (default 0.5, max 5). day: "YYYY-MM-DD" (default today); planned restrictions are known weeks ahead. kind: "all", "planned" (works, events, loadin
- `porto_sensors`: Latest readings of Porto's street sensors: air quality, noise and weather. Args: kind: "air" (PM2.5, PM10, NO2, O3, CO in µg/m³), "noise" (LAeq in dB(A)), "weather" (temperature, humidity, rain, wind) or "all". near: a Porto postal code, or pass lat/lon, to sort sensors by distance. Only readings from the last 3 hours are returned; sensors that stopped reporting are counted.
- `election_results`: Official results of a Portuguese election for the country, a district, a municipality or a parish. Args: election: "legislativas2025" (default), "legislativas2024", "legislativas2022", "autarquicas2025", "autarquicas2021", "europeias2024", "presidenciais2021"; or just "autarquicas", "europeias"... for the latest of that kind. place: None for Portugal; a municipality ("Sintra", "Lisboa"), "municipa
- `reservoir_levels`: How full mainland Portugal's reservoirs are, per river basin, in the latest month published. Args: basin: optional, e.g. "Tejo", "Douro", "Guadiana", "Sado", "Ribeiras do Algarve", "Arade". Each basin has its % of capacity, the historical average for that month, the same month a year before and the capacity in hm³; plus the capacity-weighted mainland total.
- `diario_republica`: What the latest Diário da República issue published, with a link to each act. Args: series: 1 (laws, decree-laws, ordinances, government resolutions; default) or 2 (dispatches, notices, appointments, tenders: hundreds per day). query: optional words to filter titles and summaries, e.g. "IRS", "habitação", "Saúde".
- `school_stats`: Statistics for schools in mainland Portugal (InfoEscolas, Ministry of Education). Args: school: part of a school's name ("Pedro Nunes", "Marquês de Pombal") or its DGEEC code. municipality: list that municipality's schools (e.g. "Braga"). level: "1ciclo", "2ciclo", "3ciclo", "secundario" (science-humanities, default) or "profissional" (vocational). Each school has its students, retention or dropou
- `broadband_coverage`: Which fixed broadband technologies reach a place in Portugal, according to ANACOM: fibre, coaxial cable (DOCSIS 3.1 / 3.0) and copper with ADSL, with the date of the data. Args: near: a postal code ("1100-148"; the full 7 digits is the most precise) or a municipality; or pass lat/lon for an exact point. It does not say which operator offers it, and mobile coverage is not included (ANACOM publishes
- `post_offices`: CTT post offices, postal agents and post boxes near a place, closest first (ANACOM register). Args: near: a postal code or municipality; or pass lat/lon. kind: "stations" (post offices, with hours and services), "agents" (postos de correios in shops and parish councils), "boxes" (post boxes, with last collection times) or "all". radius_km: search radius (default 1, max 10).
- `protected_areas`: Is this place in a protected area or Natura 2000 site? (mainland Portugal, ICNF) Args: near: a postal code or municipality (its centre is used); for a precise answer pass lat/lon. Checks the National Network of Protected Areas (natural parks, reserves, protected landscapes), Natura 2000 (SIC/ZEC for habitats, ZPE for birds), Ramsar wetlands and biosphere reserves, and returns each designation that
- `notable_trees`: Classified trees of public interest (arvoredo de interesse público, ICNF): species, size, age. Args: municipality: list a municipality's trees (e.g. "Sintra"), or near / lat / lon: the trees around a place, closest first, within radius_km (max 50).

## FAQ

### Do I need API keys?

No. It is read-only with no keys or accounts.

### Can I limit the tools loaded?

Yes. PORTUGAL_MCP_FEATURES takes a comma list of features to load or to drop.

### Does it cite sources?

The README says each answer states its official source and date.

### Can I ask in Portuguese?

Yes, the tools accept Portuguese questions.

### Is Portugal (public data) free?

Yes. Portugal (public data) is free to use.

### How do I add Portugal (public data) to Claude Code?

Run this command in your terminal: claude mcp add --transport http portugal-mcp https://mcp.thiagolannes.com/portugal

### What are the best alternatives to Portugal (public data)?

The closest alternatives to Portugal (public data) are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/portugal-public-data
