Portugal (public data)
Server Details
Portugal public data: weather, INE, Parliament, contracts, SNS, fuel, transit, power cuts.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- ThiagoJacobLannes/portugal-mcp
- GitHub Stars
- 1
- Server Listing
- portugal-mcp
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 56 tools
Most tools map to a clearly distinct dataset or action, and the bus_* vs transit_* and SNS curated-vs-generic splits are explicitly signposted. A few orchestration/lookup tools such as find_medicine_near versus medicine_availability + pharmacies require reading descriptions, but there are no true duplicates.
All names use snake_case, and most follow either a domain_action pattern (bus_find_stops, sns_query_dataset) or a clear resource-noun pattern (fuel_prices, parliament_votes). Minor verb-first outliers like find_medicine_near and where_is are readable but slightly break the pattern.
A 56-tool surface is very large, even for a broad public-data server. Although the tools are mostly distinct, the volume increases selection burden and suggests several domains could be grouped behind search/query meta-tools.
The server covers many high-value areas and includes open_data_search/preview and SNS dataset query fallbacks. However, obvious public-data domains such as education, justice/crime, elections, air/water quality, and local budgets are absent, so coverage is broad but not complete.
Available Tools
56 toolsactive_incidentsAInspect
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 ("4450-208") or municipality ("Matosinhos") to search around; any other text (a parish or village) filters by the incident's location name instead. lat, lon: search around these coordinates (best when the user shares their location). radius_km: search radius around the point (default 10, max 100). kind: "all", "fire", "road", "weather" (trees, floods, wind, landslides) or "rescue". limit: max incidents listed (counts always cover every match). With no place at all, returns the national picture (counts by kind and district, biggest first).
Inputs: lat, lon, kind, near, +2 more. Returns: object
bpstat_searchAInspect
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 first search of a domain takes a few seconds to a minute; then it is cached for a week. Args: lang: "PT" or "EN" (labels are richer in PT).
Inputs: query (required), lang, limit, domain_id. Returns: object
bpstat_seriesAInspect
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".
Inputs: series_ids (required), lang, since, last_n. Returns: object
bus_find_stopsAInspect
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 id also works. lat, lon: A coordinate (WGS84). Results are sorted by straight-line distance from it. Note: buses inside Lisbon city are mostly run by Carris (a different company, not covered here); Carris Metropolitana serves the wider region. radius_m: Only stops within this many metres of lat/lon. Default 500 when no query is given; unlimited when a query is given. limit: Max stops to return (default 10, max 50).
Inputs: lat, lon, limit, query, +1 more. Returns: object
bus_line_infoAInspect
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 today (some lines are seasonal or weekday-only).
Departure times past midnight are written "24:30", "25:10" (same service day).
Args: line: 4-digit line number ("4715") or free text matched against line names. include_stops: Also list every stop (id + name) in order for each direction.
Inputs: line (required), include_stops. Returns: object
bus_next_arrivalsAInspect
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 day is covered, so late at night the list may be short or empty.
Args: stop_id: 6-digit stop id, e.g. "060361". line_id: Optional 4-digit line number to keep only that line, e.g. "2794". limit: Max arrivals to return (default 10, max 50).
Inputs: stop_id (required), limit, line_id. Returns: object
bus_service_alertsAInspect
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". include_upcoming: Also return alerts that start in the future (default True). language: Preferred language ("pt" or "en"); falls back to what exists. limit: Max alerts to return (default 20, max 100).
Inputs: limit, line_id, stop_id, language, +1 more. Returns: object
bus_vehicle_positionsAInspect
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".
Inputs: line_id (required). Returns: object
earthquakesAInspect
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).
Inputs: days, limit, region, min_magnitude. Returns: object
electricity_priceAInspect
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).
Inputs: day, cheapest. Returns: object
ev_charger_detailAInspect
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. "PTEZCEAMD00051*1").
Inputs: site_or_point_id (required). Returns: object
ev_chargersAInspect
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, lon: Point to search around (WGS84). radius_km: Search radius (default 5, max 100). min_power_kw: Only points that can deliver at least this power, e.g. 50 for fast DC. connector: "CCS" (CCS2), "Type 2", "CHAdeMO", "CEE", or "DC" / "AC". available_only: Only points whose live status is "available" right now. limit: Max sites to return (default 10, max 50).
Each site: operator, address, distance_km, opening hours and its matching points, each
with status (available, in use, out of order...), max power, connectors and price
(per_kwh / per_minute / per_session in EUR, from the feed). IMPORTANT: these are the
charging operator's published fees and may not be the whole bill: see price_note and
tell the user. data_freshness says how old the inventory and live status are.
The first call of the day downloads ~220 MB from MOBI.E and can take 1-3 minutes.
Inputs: lat (required), lon (required), limit, connector, +3 more. Returns: object
find_medicine_nearAInspect
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 public.
Args: medicine: Brand name or active substance, e.g. "quetiapina", "Brufen 400". city: Municipality or town, e.g. "Lisboa". Or give lat/lon instead. lat, lon: Optional user position (sorts pharmacies by distance). limit: Max pharmacies returned (default 8).
Inputs: medicine (required), lat, lon, city, +1 more. Returns: object
fire_riskAInspect
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.
Inputs: municipality (required), day. Returns: object
fuel_pricesAInspect
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. "Gasóleo simples" (regular diesel, 2101), "Gasolina simples 95" (regular 95 petrol, 3201), "Gasolina 98", "GPL Auto" (LPG), or plain words: "diesel", "petrol", "95", "98", "lpg", "cng". See fuel_types() for the full list. district: Portuguese district, e.g. "Lisboa", "Porto", "Faro". municipality: Municipality (concelho), e.g. "Sintra", "Vila Nova de Gaia". Overrides district. lat, lon: A point (WGS84). Results get distance_km and are limited to radius_km. radius_km: Search radius around lat/lon (default 10). brand: Only this brand (substring match), e.g. "Galp", "Prio", "Intermarché". limit: How many stations to return (default 10, max 50).
Each station: price_eur (per litre, or per kg/m3 for gas), brand, name, address, municipality, distance_km (with lat/lon), coordinates and last_update (the station's last price update). Also returns how many stations matched and the min/median/max price. Always mention the source (DGEG) and the last_update when quoting prices.
Inputs: fuel_type (required), lat, lon, brand, +4 more. Returns: object
fuel_station_detailAInspect
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.
Inputs: station_id (required). Returns: object
fuel_typesAInspect
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".
Inputs: no named parameters. Returns: object
ine_indicatorAInspect
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. "Total", "Mulheres"). lang: "PT" or "EN". limit: max rows.
Inputs: varcd (required), lang, limit, place, +2 more. Returns: object
ine_searchAInspect
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".
Inputs: query (required), lang, limit. Returns: object
lisbon_eventsAInspect
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 guiadas", "crianças".
free_only: only free events.
Inputs: day, limit, query, until, +2 more. Returns: object
lisbon_recyclingAInspect
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).
Inputs: lat (required), lon (required), kind, limit, +1 more. Returns: object
lisbon_street_worksAInspect
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 da República". lat, lon: within radius_m metres of a point (max 3000). day: ISO date the occupation must cover; default today.
Inputs: day, lat, lon, limit, +3 more. Returns: object
local_accommodationAInspect
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. municipality: e.g. "Lisboa", "Porto", "Albufeira". lat, lon: registered accommodation within radius_m metres (max 2000) of a point.
Inputs: lat, lon, name, limit, +5 more. Returns: object
medicine_availabilityAInspect
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").
Checks, all from www.infarmed.pt (latest versions are found automatically):
shortages Infarmed is actively monitoring (with its circulars and advice);
the monthly list of medicines whose export is temporarily suspended because of shortage / supply risk in Portugal;
the quarterly prior-notification list (LNP) of medicines with availability concerns.
status is one or more of: monitored_shortage, export_suspended, prior_notification, no_issue_in_published_lists. "No issue" does not prove the medicine is available: Infarmed's full shortage search is not queried (see not_checked).
Args: medicine: Brand name or active substance, optionally with strength/form. limit: Max rows returned per list (default 15).
Inputs: medicine (required), limit. Returns: object
medicine_helpAInspect
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.
Inputs: no named parameters. Returns: object
municipalityCInspect
A municipality (concelho): district, INE code, area, parishes, 2021 census, town-hall contacts.
Inputs: name (required). Returns: object
open_data_datasetAInspect
Details and downloadable files of one dados.gov.pt dataset (id or slug from open_data_search).
Inputs: dataset (required). Returns: object
open_data_previewAInspect
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).
Inputs: url (required), rows. Returns: object
open_data_searchBInspect
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).
Inputs: query (required), limit, organization. Returns: object
parliament_deputiesBInspect
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.
Inputs: name, limit, party, legislature, +2 more. Returns: object
parliament_initiativeAInspect
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".
Inputs: initiative_id (required), legislature. Returns: object
parliament_searchAInspect
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 whose latest vote had this result. since: "YYYY-MM-DD" — submitted on or after this date. legislature: Roman numeral, default the current one (XVII). limit: max results, newest first.
Inputs: type, limit, query, since, +3 more. Returns: object
parliament_votesBInspect
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.
Inputs: limit, party, query, since, +2 more. Returns: object
pharmaciesAInspect
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 duty first, then open now, then distance (when lat/lon are given). Stock is not public: never say a pharmacy has a medicine.
Args: city: Municipality or town/parish, e.g. "Lisboa", "Porto", "Cascais", "Alvalade, Lisboa" (add ", " to disambiguate a town). lat, lon: Optional user position: adds distance_km and allows radius_km. With no city, the municipality is found from the coordinate. radius_km: Keep only pharmacies within this distance of lat/lon. on_duty_only: Only pharmacies on the duty roster today. open_now_only: Only pharmacies open right now. limit: Max pharmacies returned (default 20, max 100).
Inputs: lat, lon, city, limit, +3 more. Returns: object
postal_codeAInspect
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.
Inputs: code (required). Returns: object
power_cutsAInspect
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.
Inputs: days, limit, parish, postal_code, +1 more. Returns: object
public_contractsAInspect
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 year (default: this year; 2012 onwards). sort: "value" (largest first) or "date" (newest first). limit: max rows.
Inputs: sort, year, buyer, limit, +5 more. Returns: object
public_contracts_summaryAInspect
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.
Inputs: entity (required), top, role, year. Returns: object
public_holidaysAInspect
Portugal's national public holidays for a year (default: this year), with weekday.
Carnival is listed as optional: it is usually a day off by government decision, not by law. Municipal holidays (one per concelho, e.g. Lisbon 13 June, Porto 24 June) are not included.
Inputs: year, upcoming_only. Returns: object
sea_forecastAInspect
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.
Inputs: day, lat, lon, place. Returns: object
sns_consultation_wait_statsAInspect
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 usually 2-3 months back, provisional); there is no breakdown by specialty in the open data.
Per period (latest first): consultations_in_month / _year_to_date (total, first, subsequent) and first_consultations_within_max_time_pct for the month and year-to-date.
Args: institution: Hospital or ULS name; mapped to its ULS. region: Norte | Centro | LVT (Lisboa) | Alentejo | Algarve. Ignored if institution is given. period: Latest month to include, "YYYY-MM" (default: newest available). months: How many months back (default 6, max 24).
Inputs: months, period, region, institution. Returns: object
sns_emergency_statsAInspect
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 https://tempos.min-saude.pt. Not medical advice: in an emergency call 112; SNS 24 (808 24 24 24) for advice.
Scope: one institution, one region, or (neither) all of mainland Portugal's SNS hospitals.
Per period (latest first): visits_in_month and visits_year_to_date by type (general, paediatric, obstetric, psychiatric, total), triage_in_month by colour (red = immediate, orange = very urgent, yellow = urgent, green = less urgent, blue = non-urgent, white = not clinical / other) and triage_share_in_month_pct.
Args:
institution: Hospital or ULS name, accent-insensitive ("Santa Maria", "São João",
"Hospital de Faro"). A hospital is mapped to its ULS; check scope.
region: Norte | Centro | LVT (Lisboa) | Alentejo | Algarve. Ignored if institution is given.
period: Latest month to include, "YYYY-MM" (default: newest available).
months: How many months back to return (default 6, max 24).
Inputs: months, period, region, institution. Returns: object
sns_find_institutionsAInspect
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 lat/lon given), whether
it reports emergency / consultation / surgery data on tempos.min-saude.pt, and
stats_entity — the name under which the official statistics report it (statistics are
per ULS / hospital group, not per building). This list does NOT contain live waiting times;
for live emergency waits send the user to https://tempos.min-saude.pt.
Args:
query: Part of the name, accent-insensitive, e.g. "Santa Maria", "Faro", "ULS Algarve".
lat, lon: Sort by distance from this point (WGS84), e.g. Lisbon 38.7223, -9.1393.
Without query, umbrella ULS entries are skipped (they duplicate a hospital's location).
emergency_only: Only places that report emergency-department data.
limit: Max results (default 10, max 50).
Inputs: lat, lon, limit, query, +1 more. Returns: object
sns_query_datasetAInspect
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'(likeis a case- and accent-insensitive "contains"; dates use date'YYYY-MM-DD')select:
tempo, instituicao, total_urgenciasor aggregatessum(total_urgencias) as totalgroup_by:
regiaoortempo(combine with aggregates in select)order_by:
tempo descMost hospital-activity datasets (fieldtempo, monthly) store YEAR-TO-DATE CUMULATIVE values: December is the annual total; a single month = this month minus the previous one. Many datasets have aregiaoand aninstituicao(orentidade) field. Official statistics, not live data.
Args: dataset_id: e.g. "ocupacao-do-internamento" (from sns_search_datasets). where, select, group_by, order_by: ODSQL clauses (optional). limit: Rows to return (default 20, max 100). offset: Skip rows, for paging.
Inputs: dataset_id (required), limit, where, offset, +3 more. Returns: object
sns_search_datasetsAInspect
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"). Then call sns_query_dataset with the dataset_id and the field names returned here. Portuguese keywords work best; matching is accent-insensitive.
Args: query: Keywords, e.g. "ocupação internamento", "partos", "urgência". Empty = list all (id + title). limit: Max results (default 10, max 50; ignored when listing all).
Inputs: limit, query. Returns: object
sns_surgery_wait_statsAInspect
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 open data has NO breakdown by specialty or procedure — say so if asked for one.
Per period (latest first):
waiting_list: patients on the surgical waiting list (LIC) at month end, how many are still within the legal maximum guaranteed response time (TMRG, 180 days for normal priority since 2018) and the % within it.
mean_days_before_surgery_in_month / _year_to_date: average days between hospital admission and the operation for scheduled inpatient surgery (this is NOT the time on the waiting list).
surgeries_in_month / surgeries_year_to_date: scheduled (= inpatient + day surgery) and urgent.
Args: institution: Hospital or ULS name ("Santa Maria", "Coimbra", "IPO Porto"); mapped to its ULS. region: Norte | Centro | LVT (Lisboa) | Alentejo | Algarve. Ignored if institution is given. period: Latest month to include, "YYYY-MM" (default: newest available). months: How many months back (default 6, max 24).
Inputs: months, period, region, institution. Returns: object
tourism_placesBInspect
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é", "Pestana". lat, lon: closest first, within radius_km (max 200).
Inputs: kind (required), lat, lon, name, +3 more. Returns: object
transit_departuresAInspect
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 Lisbon operators. when: ISO date-time in Lisbon time, e.g. "2026-11-03T08:00". Default: now. window_minutes: how far ahead to look (max 720). line: keep only a line or destination, e.g. "28E", "Sintra", "Azul".
Inputs: stop (required), line, when, limit, +2 more. Returns: object
transit_find_stopsAInspect
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 operators. lat, lon: find the nearest instead of (or as well as) by name.
Inputs: lat, lon, limit, query, +1 more. Returns: object
transit_operatorsBInspect
Which transport operators have timetables here, and what each one covers.
Inputs: no named parameters. Returns: object
transit_trips_betweenAInspect
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", "faro", "madeira", or "intercity" (FlixBus coaches and CP). Default: CP and the Lisbon operators. when: ISO date-time in Lisbon time; default now. window_minutes: departures within this window (max 1440).
Inputs: origin (required), destination (required), when, limit, +2 more. Returns: object
transit_vehiclesAInspect
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 use bus_vehicle_positions / bus_next_arrivals (Carris Metropolitana).
Inputs: operator (required), lat, lon, line, +2 more. Returns: object
weather_forecastAInspect
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.
Inputs: lat, lon, place. Returns: object
weather_warningsAInspect
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.
Inputs: area, include_green. Returns: object
where_isAInspect
Which parish, municipality and district a coordinate is in, plus altitude, land use and hazard maps.
Inputs: lat (required), lon (required). Returns: object
wildfiresAInspect
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 parish contains this, e.g. "Algarve", "Monchique", "Viseu".
min_hectares: only fires at least this large.
sort: "area" (largest first) or "date" (newest first).
limit: max fires listed (totals always cover every match).
Inputs: sort, year, limit, place, +2 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
IPMA Portugal MCP — weather, UV, sea state, and earthquakes from the Instituto Português do Mar e…
BPstat — Banco de Portugal statistics API (Portuguese central bank). Keyless.
Public hazard, water, weather and EPA data with source, age and licence on every reading.
Read-only Irish public data for AI assistants: stats, weather, transport, law, property and maps.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides comprehensive access to Portuguese weather data from IPMA, including forecasts, warnings, sea state, fire risk, UV index, seismic activity, and weather station observations for all Portuguese cities and islands.10MIT
- AlicenseAqualityDmaintenanceProvides access to Portuguese weather data from IPMA (Instituto Português do Mar e da Atmosfera), including weather forecasts, meteorological warnings, seismic data, UV index, and real-time observations from weather stations across Portugal.6MIT
- AlicenseAqualityDmaintenanceProvides AI assistants with live tools for Portuguese public data including fuel prices, weather, postal codes, statistics, and open data.8MIT
- AlicenseBqualityCmaintenanceProvides access to Portuguese meteorological data from IPMA (Instituto Português do Mar e da Atmosfera), including weather forecasts, warnings, UV index, seismic data, and weather station observations for cities in Portugal.6MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.