Endpoints: 76,849MCP servers: 32,728Payout addresses: 3,825Paid calls: 6,140Letters: 84Defects: 3,890counted just now
teppi

Server definition

Hash
sha256:30815d9932a6e6bb20b31e432b29d5bb2b6d329e6f486ff7cd77ab131b69dbcf
What it is
What a remote MCP server returned when asked what it offers: 72 tools

The blob, as servednamed by its sha256

{ "instructions": "Portugal's public data in one server: weather and warnings (IPMA), places, postal codes and holidays (national and municipal), official statistics (INE, Banco de Portugal), Parliament, public contracts, the national open-data portal, the health service (SNS), medicines and pharmacies, fuel and EV charging, Lisbon-area buses, train, metro, bus and tram timetables (CP, Lisbon, Porto, Coimbra, Braga, Aveiro, Cascais, Barreiro, the Algarve, Madeira) and FlixBus coaches, live bus positions (Porto, Coimbra, Lisbon), tourism registers (local accommodation, Blue Flag beaches, hotels, surf, routes), Lisbon city data (events, street works, recycling, Metro line status), Porto city data (road closures, air-quality, noise and weather sensors), the day-ahead electricity price (OMIE), national and local electricity consumption and outages (E-REDES), planned power cuts (E-REDES), wildfire burnt areas (EFFIS) and live civil-protection incidents (ANEPC), Arquivo.pt, the archive of Portuguese websites since 1996, official election results (SGMAI), reservoir levels (APA), the latest Diário da República issue, school statistics (InfoEscolas), fixed broadband coverage and CTT post offices (ANACOM), and protected areas and notable trees (ICNF). Everything is read-only public data. Answer in the user's language and always say which source and which date or period each figure comes from.\n\n[clima] Weather tools use IPMA, the official met office. Forecasts cover the 5 next days for district capitals and island towns; for other places pass lat/lon and the nearest IPMA location is used (say which one). Warnings: yellow/orange/red only; green means none.\n\n[geo] Place tools: postal_code for 'XXXX-XXX', where_is for coordinates, municipality for a concelho (parishes, census, contacts of the town hall). public_holidays gives the national holidays; pass municipality to add that concelho's own holiday (and the Azores or Madeira regional ones).\n\n[ine] INE indicators are identified by a 7-digit code (varcd). Use ine_search to find one, then ine_indicator. Values are official and dated by reference period; quote the period.\n\n[bpstat] Banco de Portugal series: search with bpstat_search (e.g. 'euribor 12 meses', 'taxa de juro crédito habitação', 'dólar', 'dívida pública'), then read values with bpstat_series. Always give the observation date and unit.\n\n[parlamento] Parliament tools read the official open-data files of the current legislature (XVII, since June 2025) unless another is asked for. The first call downloads ~100 MB and takes a minute or two; after that it is cached for a day. Votes are by parliamentary group, as the Parliament records them. Report facts only; do not characterise parties or deputies.\n\n[contratos] Public-contract tools read IMPIC's yearly files of the BASE portal (contracts since 2012). The first call for a year downloads 15-55 MB and takes a minute or two. Amounts are contract prices in euros without VAT as reported by the buyer. Tax numbers of individual people are hidden; companies and public bodies keep theirs.\n\n[dados] dados.gov.pt holds ~6,000 open datasets from public bodies. Prefer the specialised tools when one fits; use open_data_search for anything else, open_data_dataset for its files, and open_data_preview to peek at a CSV or JSON file hosted on dados.gov.pt.\n\n[saude] Official open-data statistics about Portugal's national health service (SNS): hospitals and local health units (ULS), emergency-department visits and Manchester triage colours, surgery and first-consultation access indicators, plus generic access to the ~150 datasets of the SNS Transparency portal. Figures are monthly official statistics (the latest month is usually 2-3 months back and provisional) — NOT live emergency-room queues; for live waits point the user to https://tempos.min-saude.pt. This is not medical advice: in an emergency call 112; for health advice call SNS 24 on 808 24 24 24.\n\n[medicamentos] Helps people in Portugal who need a medicine: is it in shortage, and which pharmacies are open or on duty nearby. Informational only, not medical advice: never tell anyone to switch, stop or substitute a medicine; a pharmacist or doctor must decide that. Per-pharmacy stock is NOT public in Portugal: never claim a pharmacy has a medicine; tell the user to call the pharmacy or Linha 1400. In an emergency, 112. For 'I need medicine X in city Y', call find_medicine_near first.\n\n[transit] Timetables (scheduled times, not live) for CP trains, Metro de Lisboa, Carris, Fertagus, Metro do Porto, and the buses of Braga, Coimbra, Aveiro, Cascais, Barreiro, the Algarve and Madeira, plus FlixBus intercity coaches. Use transit_find_stops, then transit_departures or transit_trips_between. Outside Lisbon pass `operator` as the city or region (e.g. 'porto', 'coimbra', 'madeira'): without it only CP and the Lisbon operators are searched. The first use of an operator downloads its timetable (up to a minute). Say the times are scheduled; if a result carries a `warning` that the timetable has ended, say so. Live vehicle positions (Porto STCP, Coimbra SMTUC, Lisbon Carris): transit_vehicles.\n\n[incendios] Wildfire tools use EFFIS satellite mapping of burnt areas (mapped a day or more after the fire; small fires can be missing). They are not a live list of fires in progress. For today's danger use fire_risk (IPMA); in an emergency call 112; for live incidents point to prociv.gov.pt.\n\n[ocorrencias] active_incidents lists what civil protection (ANEPC: firefighters, INEM-assisted rescues, civil protection) is responding to right now: fires, road collisions, fallen trees, floods, rescues, with status and resources on scene, updated every few minutes. It does NOT include police-only activity (PSP/GNR publish nothing live): if the user saw police cars, say so and show what civil protection has nearby, which may or may not be the same event. You don't know the user's location: if they ask about 'here' or 'near me' without a place, ask for their town, parish, postal code or coordinates. Never present it as an official alert; in an emergency, 112.\n\n[eletricidade] power_cuts lists the PLANNED electricity interruptions E-REDES has announced (maintenance and works), usually for the next two weeks, by postal code, municipality or parish. It is not a list of live faults: for an outage happening now, point to E-REDES (808 100 100 or balcaodigital.e-redes.pt). Give the date, start and end time and say it is planned. electricity_price gives OMIE's day-ahead wholesale price for Portugal in €/MWh, per 15 minutes: it is not the retail tariff on a bill, though indexed ('dynamic') tariffs follow it. Cite OMIE. electricity_grid gives a day's national consumption, peak and wind/solar/hydro generation on the distribution grid (one day behind); electricity_local gives a municipality's or postal area's monthly consumption and how often the power went out there. Mainland only (E-REDES).\n\n[turismo] Tourism tools use Turismo de Portugal's official registries (CC BY). local_accommodation checks the national register of local accommodation (Alojamento Local, RNAL): give the registration number ('12345/AL'), a name, an address or postal code, or a point. Being registered does not mean the listing online is honest; say the register shows what the owner declared. tourism_places lists Blue Flag beaches, surf spots, golf, spas, villages, routes, marinas, UNESCO sites and hotels near a place or in a municipality.\n\n[lisboa] Lisbon city tools: lisbon_events (the city's cultural agenda: exhibitions, concerts, theatre, guided visits, mostly with dates, venue and price), lisbon_street_works (licensed occupations of public space such as filming, events and scaffolding, plus the city's road and pavement works in progress or planned), lisbon_recycling (the nearest recycling points by type) and lisbon_metro_status (is each Metro line running normally right now). These cover the Lisboa municipality only.\n\n[arquivo] Arquivo.pt keeps copies of Portuguese websites (mostly .pt) since 1996. web_archive_search finds archived pages by words, web_archive_history shows when an address was captured and how often it changed, web_archive_page gives the text of a page as it was on a date. The newest copy of a page can be weeks or months old, and sites that block crawlers are missing. Quote archived text briefly and give the archive link.\n\n[porto] Porto city tools: porto_road_closures lists the streets where the Câmara do Porto has restricted traffic or parking (works, events, loading, scaffolding: planned) or registered an unplanned restriction (accidents, burst pipes, fallen trees), filtered to what is active on a date. porto_sensors gives the latest readings of the city's air-quality, noise and weather sensors. Both cover the Porto municipality only; give the date or reading time.\n\n[eleicoes] election_results gives official results (SGMAI) for the 2025, 2024 and 2022 legislative elections, the 2025 and 2021 local elections, the 2024 European election and the 2021 presidential election, for the country, a district, a municipality or a parish. Local elections have three bodies: CM (câmara, who governs the town), AM and AF. Report facts only; do not characterise parties.\n\n[agua] reservoir_levels gives how full mainland Portugal's reservoirs are per river basin (% of capacity), for the latest month APA has published, next to the historical average for that month and the same month a year before. Months run in hydrological years (October to September).\n\n[diario] diario_republica lists what the latest Diário da República issue published (Series I: laws, decree-laws, ordinances, resolutions; Series II: dispatches, notices, appointments), with a link to each act. It covers the latest issue only; it cannot search older legislation.\n\n[escolas] school_stats gives InfoEscolas (Ministry of Education) figures per school in mainland Portugal: students, retention or dropout rate, the share finishing the cycle on time next to the national figure for students with a similar profile, and for the 3rd cycle the share of 'direct success' paths. Say which school year the figures refer to; they are not a ranking.\n\n[anacom] broadband_coverage says which fixed technologies (fibre, cable DOCSIS 3.1/3.0, copper with ADSL) reach a place according to ANACOM, with the date of the data; it does not say which operator. Mobile coverage per operator is published by ANACOM only as a map image (geo.anacom.pt). post_offices lists CTT post offices, postal agents and post boxes near a place with hours, services and the last collection time.\n\n[natureza] protected_areas says whether a place (mainland Portugal) is inside a protected area (natural park, reserve...), a Natura 2000 site, a Ramsar wetland or a biosphere reserve (ICNF), with the classifying act. notable_trees lists classified trees of public interest near a place or in a municipality, with species, size and age. Rules for building or activities there are set by each area's management plan: point to ICNF for those.", "tools": [ { "description": "What emergency services (civil protection, ANEPC) are responding to right now in Portugal, closest first.\n\nLive occurrences of every kind: fires, road collisions, fallen trees, floods, rescues, with their\nstatus (e.g. \"Em Curso\"), time started and resources on scene. Updated every few minutes.\nPolice-only activity (PSP/GNR) is not published anywhere and is not included.\nArgs:\n near: a postal code (\"4450-208\") or municipality (\"Matosinhos\") to search around; any other\n text (a parish or village) filters by the incident's location name instead.\n lat, lon: search around these coordinates (best when the user shares their location).\n radius_km: search radius around the point (default 10, max 100).\n kind: \"all\", \"fire\", \"road\", \"weather\" (trees, floods, wind, landslides) or \"rescue\".\n limit: max incidents listed (counts always cover every match).\nWith no place at all, returns the national picture (counts by kind and district, biggest first).\n", "inputSchema": { "properties": { "kind": { "default": "all", "title": "Kind", "type": "string" }, "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "limit": { "default": 15, "title": "Limit", "type": "integer" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "near": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Near" }, "radius_km": { "default": 10, "title": "Radius Km", "type": "number" } }, "title": "active_incidentsArguments", "type": "object" }, "name": "active_incidents", "outputSchema": { "additionalProperties": true, "title": "active_incidentsDictOutput", "type": "object" } }, { "description": "Find Banco de Portugal statistical series by keyword.\n\nExamples: \"euribor 12 meses\", \"taxa de juro novos empréstimos habitação\", \"dólar\", \"dívida pública\",\n\"depósitos particulares\", \"preços habitação\". The search picks the most likely statistical domains\n(or the one you pass as domain_id) and searches the series inside them; it also lists every domain\nso you can retry with a specific domain_id. The first search of a domain takes a few seconds to a\nminute; then it is cached for a week.\nArgs:\n lang: \"PT\" or \"EN\" (labels are richer in PT).\n", "inputSchema": { "properties": { "domain_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Domain Id" }, "lang": { "default": "PT", "title": "Lang", "type": "string" }, "limit": { "default": 15, "title": "Limit", "type": "integer" }, "query": { "title": "Query", "type": "string" } }, "required": [ "query" ], "title": "bpstat_searchArguments", "type": "object" }, "name": "bpstat_search", "outputSchema": { "additionalProperties": true, "title": "bpstat_searchDictOutput", "type": "object" } }, { "description": "Observations of Banco de Portugal series (ids from bpstat_search).\n\nArgs:\n series_ids: one or more series ids (max 10), e.g. [12559924].\n last_n: latest observations per series (1-500). Ignored when `since` is given.\n since: \"YYYY-MM-DD\" — return every observation from this date.\n lang: \"PT\" or \"EN\".\n", "inputSchema": { "properties": { "lang": { "default": "PT", "title": "Lang", "type": "string" }, "last_n": { "default": 12, "title": "Last N", "type": "integer" }, "series_ids": { "items": { "type": "integer" }, "title": "Series Ids", "type": "array" }, "since": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Since" } }, "required": [ "series_ids" ], "title": "bpstat_seriesArguments", "type": "object" }, "name": "bpstat_series", "outputSchema": { "additionalProperties": true, "title": "bpstat_seriesDictOutput", "type": "object" } }, { "description": "Which fixed broadband technologies reach a place in Portugal, according to ANACOM: fibre,\ncoaxial cable (DOCSIS 3.1 / 3.0) and copper with ADSL, with the date of the data.\n\nArgs:\n near: a postal code (\"1100-148\"; the full 7 digits is the most precise) or a municipality;\n or pass lat/lon for an exact point.\nIt does not say which operator offers it, and mobile coverage is not included (ANACOM\npublishes that per operator only as a map at geo.anacom.pt).\n", "inputSchema": { "properties": { "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "near": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Near" } }, "title": "broadband_coverageArguments", "type": "object" }, "name": "broadband_coverage", "outputSchema": { "additionalProperties": true, "title": "broadband_coverageDictOutput", "type": "object" } }, { "description": "Find Carris Metropolitana bus stops by name and/or near a coordinate.\n\nUse this first whenever the user names a place, street, station or gives a location,\nto get the stop_id needed by bus_next_arrivals. Results include the lines serving each stop.\n\nArgs:\n query: Text to match in the stop name (accent/case-insensitive, all words must match),\n e.g. \"Gare do Oriente\", \"Cacilhas terminal\". A 6-digit stop id also works.\n lat, lon: A coordinate (WGS84). Results are sorted by straight-line distance from it.\n Note: buses inside Lisbon city are mostly run by Carris (a different\n company, not covered here); Carris Metropolitana serves the wider region.\n radius_m: Only stops within this many metres of lat/lon. Default 500 when no query is\n given; unlimited when a query is given.\n limit: Max stops to return (default 10, max 50).\n", "inputSchema": { "properties": { "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "limit": { "default": 10, "title": "Limit", "type": "integer" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Query" }, "radius_m": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Radius M" } }, "title": "find_stopsArguments", "type": "object" }, "name": "bus_find_stops", "outputSchema": { "additionalProperties": true, "title": "find_stopsDictOutput", "type": "object" } }, { "description": "Details of a Carris Metropolitana line: name, route ends, directions, municipalities.\n\nUse for \"where does line 4715 go?\", \"which bus goes from Cacilhas to Almada?\", or to check\nwhether a line passes a stop (include_stops=True). If `line` is not an exact line number it\nis treated as text (e.g. \"Oriente Setubal\") and the matching lines are listed instead.\ntrips_today = 0 means the line does not run today (some lines are seasonal or weekday-only).\nDeparture times past midnight are written \"24:30\", \"25:10\" (same service day).\n\nArgs:\n line: 4-digit line number (\"4715\") or free text matched against line names.\n include_stops: Also list every stop (id + name) in order for each direction.\n", "inputSchema": { "properties": { "include_stops": { "default": false, "title": "Include Stops", "type": "boolean" }, "line": { "title": "Line", "type": "string" } }, "required": [ "line" ], "title": "line_infoArguments", "type": "object" }, "name": "bus_line_info", "outputSchema": { "additionalProperties": true, "title": "line_infoDictOutput", "type": "object" } }, { "description": "Upcoming buses at a Carris Metropolitana stop, real-time where available.\n\nUse for \"when is the next bus at X?\" (get stop_id from bus_find_stops first).\nEach arrival says whether it is \"realtime\" (live GPS estimate) or \"scheduled\" (timetable\nonly: the bus may not have started its trip yet). minutes_from_now uses the real-time\nestimate when present. Times are Europe/Lisbon. Only today's operational day is covered,\nso late at night the list may be short or empty.\n\nArgs:\n stop_id: 6-digit stop id, e.g. \"060361\".\n line_id: Optional 4-digit line number to keep only that line, e.g. \"2794\".\n limit: Max arrivals to return (default 10, max 50).\n", "inputSchema": { "properties": { "limit": { "default": 10, "title": "Limit", "type": "integer" }, "line_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Line Id" }, "stop_id": { "title": "Stop Id", "type": "string" } }, "required": [ "stop_id" ], "title": "next_arrivalsArguments", "type": "object" }, "name": "bus_next_arrivals", "outputSchema": { "additionalProperties": true, "title": "next_arrivalsDictOutput", "type": "object" } }, { "description": "Service alerts (detours, works, strikes, stops not served) for Carris Metropolitana.\n\nUse before recommending a trip, or when the user asks \"is line X disrupted?\". Filter by\nline and/or stop; with no filter, returns all current alerts (there are often ~100).\nAlerts are mostly published in Portuguese only.\n\nArgs:\n line_id: 4-digit line number, e.g. \"4407\".\n stop_id: 6-digit stop id, e.g. \"160584\".\n include_upcoming: Also return alerts that start in the future (default True).\n language: Preferred language (\"pt\" or \"en\"); falls back to what exists.\n limit: Max alerts to return (default 20, max 100).\n", "inputSchema": { "properties": { "include_upcoming": { "default": true, "title": "Include Upcoming", "type": "boolean" }, "language": { "default": "pt", "title": "Language", "type": "string" }, "limit": { "default": 20, "title": "Limit", "type": "integer" }, "line_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Line Id" }, "stop_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Stop Id" } }, "title": "service_alertsArguments", "type": "object" }, "name": "bus_service_alerts", "outputSchema": { "additionalProperties": true, "title": "service_alertsDictOutput", "type": "object" } }, { "description": "Live GPS positions of the buses currently running on a Carris Metropolitana line.\n\nUse for \"where is the 3508 right now?\" or to see how many buses are out on a line.\nEach vehicle includes its position, heading, speed, the stop it is at / heading to,\nand how many seconds old the fix is.\n\nArgs:\n line_id: 4-digit line number, e.g. \"3508\".\n", "inputSchema": { "properties": { "line_id": { "title": "Line Id", "type": "string" } }, "required": [ "line_id" ], "title": "vehicle_positionsArguments", "type": "object" }, "name": "bus_vehicle_positions", "outputSchema": { "additionalProperties": true, "title": "vehicle_positionsDictOutput", "type": "object" } }, { "description": "What the latest Diário da República issue published, with a link to each act.\n\nArgs:\n series: 1 (laws, decree-laws, ordinances, government resolutions; default) or 2\n (dispatches, notices, appointments, tenders: hundreds per day).\n query: optional words to filter titles and summaries, e.g. \"IRS\", \"habitação\", \"Saúde\".\n", "inputSchema": { "properties": { "limit": { "default": 30, "title": "Limit", "type": "integer" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Query" }, "series": { "default": 1, "title": "Series", "type": "integer" } }, "title": "diario_republicaArguments", "type": "object" }, "name": "diario_republica", "outputSchema": { "additionalProperties": true, "title": "diario_republicaDictOutput", "type": "object" } }, { "description": "Recent earthquakes recorded by IPMA.\n\nArgs:\n region: \"mainland\" (mainland Portugal and Madeira) or \"azores\".\n days: look back this many days (max 30).\n min_magnitude: only quakes at or above this magnitude.\n limit: max rows (newest first).\n", "inputSchema": { "properties": { "days": { "default": 7, "title": "Days", "type": "integer" }, "limit": { "default": 20, "title": "Limit", "type": "integer" }, "min_magnitude": { "default": 0, "title": "Min Magnitude", "type": "number" }, "region": { "default": "mainland", "title": "Region", "type": "string" } }, "title": "earthquakesArguments", "type": "object" }, "name": "earthquakes", "outputSchema": { "additionalProperties": true, "title": "earthquakesDictOutput", "type": "object" } }, { "description": "Official results of a Portuguese election for the country, a district, a municipality or a parish.\n\nArgs:\n election: \"legislativas2025\" (default), \"legislativas2024\", \"legislativas2022\",\n \"autarquicas2025\", \"autarquicas2021\", \"europeias2024\", \"presidenciais2021\"; or just\n \"autarquicas\", \"europeias\"... for the latest of that kind.\n place: None for Portugal; a municipality (\"Sintra\", \"Lisboa\"), \"municipality, parish\"\n (\"Lisboa, Arroios\"), a district written as \"distrito de Braga\" (the electoral circle in\n legislative elections), or \"Açores\" / \"Madeira\" for the whole region.\n body: local elections only: \"CM\" (câmara, default), \"AM\" (assembleia municipal) or \"AF\"\n (assembleia de freguesia, use with a parish).\nReturns turnout, blank and null votes, and votes, % and seats per list, plus the previous\nelection of the same kind for that place (lists are not matched: coalitions change).\n", "inputSchema": { "properties": { "body": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Body" }, "election": { "default": "legislativas2025", "title": "Election", "type": "string" }, "limit": { "default": 12, "title": "Limit", "type": "integer" }, "place": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Place" } }, "title": "election_resultsArguments", "type": "object" }, "name": "election_results", "outputSchema": { "additionalProperties": true, "title": "election_resultsDictOutput", "type": "object" } }, { "description": "How much electricity mainland Portugal used on a day, the peak, and how much wind, solar and\nhydro the distribution grid generated (E-REDES, 15-minute data, usually one day behind).\n\nArgs:\n day: \"YYYY-MM-DD\" (default: the latest complete day, usually yesterday).\nBig power stations feed the transmission grid (REN) and show here only as one total.\n", "inputSchema": { "properties": { "day": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Day" } }, "title": "electricity_gridArguments", "type": "object" }, "name": "electricity_grid", "outputSchema": { "additionalProperties": true, "title": "electricity_gridDictOutput", "type": "object" } }, { "description": "Electricity in one place (mainland Portugal): billed consumption per month, and how often and\nfor how long the power went out there in recent years compared with the average municipality.\n\nArgs:\n municipality: a concelho, e.g. \"Sintra\".\n postal_code: \"2710\" or \"2710-123\" (consumption is published per 4-digit area); its\n municipality is used for the outage figures.\n months: how many recent months of consumption (max 60).\n", "inputSchema": { "properties": { "months": { "default": 12, "title": "Months", "type": "integer" }, "municipality": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Municipality" }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Postal Code" } }, "title": "electricity_localArguments", "type": "object" }, "name": "electricity_local", "outputSchema": { "additionalProperties": true, "title": "electricity_localDictOutput", "type": "object" } }, { "description": "Portugal's day-ahead wholesale electricity price (OMIE), per 15-minute period, in €/MWh.\n\nUseful for indexed (\"dynamic\") tariffs: when is electricity cheapest to run the washing\nmachine or charge the car. Not the retail price on a normal bill.\nArgs:\n day: ISO date, e.g. \"2026-11-10\". Default: the most recent day OMIE has published.\n cheapest: also list this many cheapest periods (max 12).\n", "inputSchema": { "properties": { "cheapest": { "default": 4, "title": "Cheapest", "type": "integer" }, "day": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Day" } }, "title": "electricity_priceArguments", "type": "object" }, "name": "electricity_price", "outputSchema": { "additionalProperties": true, "title": "electricity_priceDictOutput", "type": "object" } }, { "description": "Everything about one MOBI.E charging site: all its points with live status, power,\nconnectors and price, plus operator contact, opening hours and accepted authentication\n(app, RFID card, credit card...).\n\nUse after ev_chargers. Accepts a site_id (e.g. \"EZC-AMD-00051\"), a point_id\n(e.g. \"AMD-00051-1\") or an EVSE id (e.g. \"PT*EZC*E*AMD*00051*1\").\n", "inputSchema": { "properties": { "site_or_point_id": { "title": "Site Or Point Id", "type": "string" } }, "required": [ "site_or_point_id" ], "title": "ev_charger_detailArguments", "type": "object" }, "name": "ev_charger_detail", "outputSchema": { "additionalProperties": true, "title": "ev_charger_detailDictOutput", "type": "object" } }, { "description": "Public EV charging sites near a point in Portugal (MOBI.E network), nearest first,\nwith live status and the price the network publishes for each charging point.\n\nUse for \"where can I charge near X?\", \"fast chargers near me\", \"is there a free CCS\ncharger nearby?\". Needs coordinates; if the user gives a place name, use known\ncoordinates for it. Covers mainland Portugal, Azores and Madeira.\n\nArgs:\n lat, lon: Point to search around (WGS84).\n radius_km: Search radius (default 5, max 100).\n min_power_kw: Only points that can deliver at least this power, e.g. 50 for fast DC.\n connector: \"CCS\" (CCS2), \"Type 2\", \"CHAdeMO\", \"CEE\", or \"DC\" / \"AC\".\n available_only: Only points whose live status is \"available\" right now.\n limit: Max sites to return (default 10, max 50).\n\nEach site: operator, address, distance_km, opening hours and its matching points, each\nwith status (available, in use, out of order...), max power, connectors and price\n(per_kwh / per_minute / per_session in EUR, from the feed). IMPORTANT: these are the\ncharging operator's published fees and may not be the whole bill: see `price_note` and\ntell the user. `data_freshness` says how old the inventory and live status are.\nThe first call of the day downloads ~220 MB from MOBI.E and can take 1-3 minutes.\n", "inputSchema": { "properties": { "available_only": { "default": false, "title": "Available Only", "type": "boolean" }, "connector": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Connector" }, "lat": { "title": "Lat", "type": "number" }, "limit": { "default": 10, "title": "Limit", "type": "integer" }, "lon": { "title": "Lon", "type": "number" }, "min_power_kw": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Min Power Kw" }, "radius_km": { "default": 5, "title": "Radius Km", "type": "number" } }, "required": [ "lat", "lon" ], "title": "ev_chargersArguments", "type": "object" }, "name": "ev_chargers", "outputSchema": { "additionalProperties": true, "title": "ev_chargersDictOutput", "type": "object" } }, { "description": "One-shot answer to \"I need medicine X in city Y — what do I do?\" in Portugal.\n\nRuns medicine_availability(medicine) and pharmacies(city or lat/lon), and returns: the shortage\nstatus (compact), the pharmacies on duty today and the ones open now (nearest first when\nlat/lon are given), the help lines (Linha 1400, SNS 24, 112) and next steps. It never\nsays a pharmacy has the medicine: stock is not public.\n\nArgs:\n medicine: Brand name or active substance, e.g. \"quetiapina\", \"Brufen 400\".\n city: Municipality or town, e.g. \"Lisboa\". Or give lat/lon instead.\n lat, lon: Optional user position (sorts pharmacies by distance).\n limit: Max pharmacies returned (default 8).\n", "inputSchema": { "properties": { "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "City" }, "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "limit": { "default": 8, "title": "Limit", "type": "integer" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "medicine": { "title": "Medicine", "type": "string" } }, "required": [ "medicine" ], "title": "find_medicine_nearArguments", "type": "object" }, "name": "find_medicine_near", "outputSchema": { "additionalProperties": true, "title": "find_medicine_nearDictOutput", "type": "object" } }, { "description": "Wildfire danger (RCM, risco de incêndio rural) for a municipality, today or tomorrow.\n\nArgs:\n municipality: concelho name, e.g. \"Sintra\", \"Monchique\".\n day: 0 = today, 1 = tomorrow.\nScale: 1 reduzido, 2 moderado, 3 elevado, 4 muito elevado, 5 máximo.\n", "inputSchema": { "properties": { "day": { "default": 0, "title": "Day", "type": "integer" }, "municipality": { "title": "Municipality", "type": "string" } }, "required": [ "municipality" ], "title": "fire_riskArguments", "type": "object" }, "name": "fire_risk", "outputSchema": { "additionalProperties": true, "title": "fire_riskDictOutput", "type": "object" } }, { "description": "Cheapest fuel stations in Portugal for one fuel type, cheapest first (official DGEG prices).\n\nUse for \"where is diesel/petrol/LPG cheapest in Lisboa / near me / in Braga?\". Give an\narea as a district, a municipality, or a point (lat + lon, with radius_km); with no area\nit searches all of Portugal. Names are case- and accent-insensitive (\"evora\" works).\n\nArgs:\n fuel_type: A DGEG fuel name or id, e.g. \"Gasóleo simples\" (regular diesel, 2101),\n \"Gasolina simples 95\" (regular 95 petrol, 3201), \"Gasolina 98\", \"GPL Auto\"\n (LPG), or plain words: \"diesel\", \"petrol\", \"95\", \"98\", \"lpg\", \"cng\".\n See fuel_types() for the full list.\n district: Portuguese district, e.g. \"Lisboa\", \"Porto\", \"Faro\".\n municipality: Municipality (concelho), e.g. \"Sintra\", \"Vila Nova de Gaia\". Overrides district.\n lat, lon: A point (WGS84). Results get distance_km and are limited to radius_km.\n radius_km: Search radius around lat/lon (default 10).\n brand: Only this brand (substring match), e.g. \"Galp\", \"Prio\", \"Intermarché\".\n limit: How many stations to return (default 10, max 50).\n\nEach station: price_eur (per litre, or per kg/m3 for gas), brand, name, address,\nmunicipality, distance_km (with lat/lon), coordinates and last_update (the station's\nlast price update). Also returns how many stations matched and the min/median/max price.\nAlways mention the source (DGEG) and the last_update when quoting prices.\n", "inputSchema": { "properties": { "brand": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Brand" }, "district": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "District" }, "fuel_type": { "title": "Fuel Type", "type": "string" }, "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "limit": { "default": 10, "title": "Limit", "type": "integer" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "municipality": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Municipality" }, "radius_km": { "default": 10, "title": "Radius Km", "type": "number" } }, "required": [ "fuel_type" ], "title": "fuel_pricesArguments", "type": "object" }, "name": "fuel_prices", "outputSchema": { "additionalProperties": true, "title": "fuel_pricesDictOutput", "type": "object" } }, { "description": "Full details of one fuel station: every fuel it sells with price and last update,\nopening hours, services (car wash, shop, tyre air...) and payment methods.\n\nUse after fuel_prices, with a station `id` from its results.\n", "inputSchema": { "properties": { "station_id": { "title": "Station Id", "type": "integer" } }, "required": [ "station_id" ], "title": "fuel_station_detailArguments", "type": "object" }, "name": "fuel_station_detail", "outputSchema": { "additionalProperties": true, "title": "fuel_station_detailDictOutput", "type": "object" } }, { "description": "List DGEG fuel types (id, name, unit) and the districts accepted by fuel_prices.\n\nOnly needed when unsure which fuel name to pass; fuel_prices also understands\n\"diesel\", \"petrol\", \"95\", \"98\", \"lpg\".\n", "inputSchema": { "properties": {}, "title": "fuel_typesArguments", "type": "object" }, "name": "fuel_types", "outputSchema": { "additionalProperties": true, "title": "fuel_typesDictOutput", "type": "object" } }, { "description": "Values of an INE indicator, latest periods first.\n\nArgs:\n varcd: 7-digit indicator code from ine_search, e.g. \"0008074\".\n place: geography name to keep, e.g. \"Portugal\", \"Lisboa\", \"Norte\", \"Porto\". Default: \"Portugal\"\n when present, otherwise all geographies.\n periods: how many of the latest reference periods to return (1-24).\n category: keep only rows whose category labels contain this text (e.g. \"Total\", \"Mulheres\").\n lang: \"PT\" or \"EN\".\n limit: max rows.\n", "inputSchema": { "properties": { "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Category" }, "lang": { "default": "PT", "title": "Lang", "type": "string" }, "limit": { "default": 40, "title": "Limit", "type": "integer" }, "periods": { "default": 3, "title": "Periods", "type": "integer" }, "place": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Place" }, "varcd": { "title": "Varcd", "type": "string" } }, "required": [ "varcd" ], "title": "ine_indicatorArguments", "type": "object" }, "name": "ine_indicator", "outputSchema": { "additionalProperties": true, "title": "ine_indicatorDictOutput", "type": "object" } }, { "description": "Find INE indicators by keyword (e.g. \"inflação\", \"desemprego\", \"população\", \"rendas\", \"turismo\").\n\nSearches INE's catalogue of key indicators. Returns varcd codes to pass to ine_indicator.\nAny other INE indicator can be read with ine_indicator if you know its code (from www.ine.pt).\nArgs:\n lang: \"PT\" (more complete wording) or \"EN\".\n", "inputSchema": { "properties": { "lang": { "default": "PT", "title": "Lang", "type": "string" }, "limit": { "default": 10, "title": "Limit", "type": "integer" }, "query": { "title": "Query", "type": "string" } }, "required": [ "query" ], "title": "ine_searchArguments", "type": "object" }, "name": "ine_search", "outputSchema": { "additionalProperties": true, "title": "ine_searchDictOutput", "type": "object" } }, { "description": "What's on in Lisbon: the city's official cultural agenda (exhibitions, concerts, theatre,\ndance, cinema, guided visits, kids, festivals).\n\nArgs:\n day: ISO date, e.g. \"2026-11-14\". Default today.\n until: ISO date to look at a range from `day` (max 31 days).\n query: words in the title, venue or description, e.g. \"fado\", \"Gulbenkian\", \"jazz\".\n category: e.g. \"música\", \"teatro\", \"exposições\", \"visitas guiadas\", \"crianças\".\n free_only: only free events.\n", "inputSchema": { "properties": { "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Category" }, "day": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Day" }, "free_only": { "default": false, "title": "Free Only", "type": "boolean" }, "limit": { "default": 15, "title": "Limit", "type": "integer" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Query" }, "until": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Until" } }, "title": "lisbon_eventsArguments", "type": "object" }, "name": "lisbon_events", "outputSchema": { "additionalProperties": true, "title": "lisbon_eventsDictOutput", "type": "object" } }, { "description": "Is the Lisbon Metro running normally right now? Status of the four lines (Amarela, Azul,\nVerde, Vermelha) as Metropolitano de Lisboa publishes it, with the disruption text if any.\n\nFor timetables use transit_departures with operator \"metro\".\n", "inputSchema": { "properties": {}, "title": "lisbon_metro_statusArguments", "type": "object" }, "name": "lisbon_metro_status", "outputSchema": { "additionalProperties": true, "title": "lisbon_metro_statusDictOutput", "type": "object" } }, { "description": "The nearest recycling points in Lisbon of a given kind.\n\nArgs:\n lat, lon: where you are.\n kind: \"ecoponto\" (paper, plastic, glass), \"vidrao\" (glass), \"papel\", \"oleo\" (used cooking oil),\n \"reee\" (small electronics), \"alimentar\" (food waste), \"ecoilha\", \"ecocentro\" (large items).\n radius_m: search radius in metres (max 3000).\n", "inputSchema": { "properties": { "kind": { "default": "ecoponto", "title": "Kind", "type": "string" }, "lat": { "title": "Lat", "type": "number" }, "limit": { "default": 5, "title": "Limit", "type": "integer" }, "lon": { "title": "Lon", "type": "number" }, "radius_m": { "default": 500, "title": "Radius M", "type": "integer" } }, "required": [ "lat", "lon" ], "title": "lisbon_recyclingArguments", "type": "object" }, "name": "lisbon_recycling", "outputSchema": { "additionalProperties": true, "title": "lisbon_recyclingDictOutput", "type": "object" } }, { "description": "Street works and public-space occupations in Lisbon: what is (or will be) blocking a street.\n\nTwo official sources: licensed temporary occupations of public space (filming, events,\nscaffolding, containers...) and the city's road and pavement works in progress or planned.\nArgs:\n parish: freguesia, e.g. \"Arroios\", \"Santa Maria Maior\", \"Belém\".\n street: part of a street name (works only), e.g. \"Avenida da República\".\n lat, lon: within radius_m metres of a point (max 3000).\n day: ISO date the occupation must cover; default today.\n", "inputSchema": { "properties": { "day": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Day" }, "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "limit": { "default": 20, "title": "Limit", "type": "integer" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "parish": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Parish" }, "radius_m": { "default": 400, "title": "Radius M", "type": "integer" }, "street": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Street" } }, "title": "lisbon_street_worksArguments", "type": "object" }, "name": "lisbon_street_works", "outputSchema": { "additionalProperties": true, "title": "lisbon_street_worksDictOutput", "type": "object" } }, { "description": "Look up the national register of local accommodation (Alojamento Local, RNAL).\n\nAnswers \"is this flat/guesthouse registered?\" and \"how many AL are on my street?\".\nArgs:\n registration: the RNAL number, e.g. \"12345/AL\" or \"12345\".\n name: part of the registered name, e.g. \"InSuites\".\n address: part of the street address, e.g. \"Rua de Santa Catarina\".\n postal_code: \"1200-290\", or \"1200\" for the whole area.\n municipality: e.g. \"Lisboa\", \"Porto\", \"Albufeira\".\n lat, lon: registered accommodation within radius_m metres (max 2000) of a point.\n", "inputSchema": { "properties": { "address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Address" }, "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "limit": { "default": 20, "title": "Limit", "type": "integer" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "municipality": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Municipality" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Name" }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Postal Code" }, "radius_m": { "default": 200, "title": "Radius M", "type": "integer" }, "registration": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Registration" } }, "title": "local_accommodationArguments", "type": "object" }, "name": "local_accommodation", "outputSchema": { "additionalProperties": true, "title": "local_accommodationDictOutput", "type": "object" } }, { "description": "Is a medicine in shortage in Portugal? Checks Infarmed's published availability information.\n\nUse when someone can't find a medicine, or asks whether X is in shortage (\"rutura\",\n\"esgotado\", \"falta\"). Searches by brand or active substance (Portuguese names work best,\ne.g. \"quetiapina\", \"Ozempic\", \"ácido acetilsalicílico\"; dose and form narrow it,\ne.g. \"quetiapina 300 mg libertação prolongada\").\n\nChecks, all from www.infarmed.pt (latest versions are found automatically):\n - shortages Infarmed is actively monitoring (with its circulars and advice);\n - the monthly list of medicines whose export is temporarily suspended because of\n shortage / supply risk in Portugal;\n - the quarterly prior-notification list (LNP) of medicines with availability concerns.\n\nstatus is one or more of: monitored_shortage, export_suspended, prior_notification,\nno_issue_in_published_lists. \"No issue\" does not prove the medicine is available:\nInfarmed's full shortage search is not queried (see not_checked).\n\nArgs:\n medicine: Brand name or active substance, optionally with strength/form.\n limit: Max rows returned per list (default 15).\n", "inputSchema": { "properties": { "limit": { "default": 15, "title": "Limit", "type": "integer" }, "medicine": { "title": "Medicine", "type": "string" } }, "required": [ "medicine" ], "title": "availabilityArguments", "type": "object" }, "name": "medicine_availability", "outputSchema": { "additionalProperties": true, "title": "availabilityDictOutput", "type": "object" } }, { "description": "Verified help lines in Portugal for medicine problems: 112, SNS 24, Linha 1400, Infarmed.\n\nUse when someone can't find a medicine, needs urgent advice, or asks who to call. Each\nline has its number, what it is for, hours where published, and the page it was checked on.\n", "inputSchema": { "properties": {}, "title": "where_to_get_helpArguments", "type": "object" }, "name": "medicine_help", "outputSchema": { "additionalProperties": true, "title": "where_to_get_helpDictOutput", "type": "object" } }, { "description": "A municipality (concelho): district, INE code, area, parishes, 2021 census, town-hall contacts.", "inputSchema": { "properties": { "name": { "title": "Name", "type": "string" } }, "required": [ "name" ], "title": "municipalityArguments", "type": "object" }, "name": "municipality", "outputSchema": { "additionalProperties": true, "title": "municipalityDictOutput", "type": "object" } }, { "description": "Classified trees of public interest (arvoredo de interesse público, ICNF): species, size, age.\n\nArgs:\n municipality: list a municipality's trees (e.g. \"Sintra\"), or\n near / lat / lon: the trees around a place, closest first, within radius_km (max 50).\n", "inputSchema": { "properties": { "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "limit": { "default": 15, "title": "Limit", "type": "integer" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "municipality": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Municipality" }, "near": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Near" }, "radius_km": { "default": 5, "title": "Radius Km", "type": "number" } }, "title": "notable_treesArguments", "type": "object" }, "name": "notable_trees", "outputSchema": { "additionalProperties": true, "title": "notable_treesDictOutput", "type": "object" } }, { "description": "Details and downloadable files of one dados.gov.pt dataset (id or slug from open_data_search).", "inputSchema": { "properties": { "dataset": { "title": "Dataset", "type": "string" } }, "required": [ "dataset" ], "title": "open_data_datasetArguments", "type": "object" }, "name": "open_data_dataset", "outputSchema": { "additionalProperties": true, "title": "open_data_datasetDictOutput", "type": "object" } }, { "description": "First rows of a CSV or JSON file hosted on dados.gov.pt (reads at most 512 KB).\n\nArgs:\n url: a resource url from open_data_dataset (must be on dados.gov.pt).\n rows: how many rows to return (1-100).\n", "inputSchema": { "properties": { "rows": { "default": 20, "title": "Rows", "type": "integer" }, "url": { "title": "Url", "type": "string" } }, "required": [ "url" ], "title": "open_data_previewArguments", "type": "object" }, "name": "open_data_preview", "outputSchema": { "additionalProperties": true, "title": "open_data_previewDictOutput", "type": "object" } }, { "description": "Search the datasets of Portugal's national open-data portal (dados.gov.pt).\n\nArgs:\n query: e.g. \"acidentes rodoviários\", \"escolas\", \"qualidade do ar\", \"alojamento local\".\n organization: optional publisher to filter by, e.g. \"INE\", \"Lisboa\" or \"Câmara Municipal de\n Cascais\" (a town name finds its town hall's datasets: Lisboa, Porto, Cascais, Oeiras...).\n limit: max results (1-50).\n", "inputSchema": { "properties": { "limit": { "default": 10, "title": "Limit", "type": "integer" }, "organization": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Organization" }, "query": { "title": "Query", "type": "string" } }, "required": [ "query" ], "title": "open_data_searchArguments", "type": "object" }, "name": "open_data_search", "outputSchema": { "additionalProperties": true, "title": "open_data_searchDictOutput", "type": "object" } }, { "description": "Members of Parliament (deputados): party, constituency (círculo), status. Seats per party included.\n\nArgs:\n name: part of the parliamentary or full name.\n party: group acronym, e.g. \"PSD\", \"PS\", \"CH\".\n constituency: e.g. \"Lisboa\", \"Porto\", \"Açores\", \"Europa\".\n include_inactive: also list deputies who left or were replaced. Default false.\n", "inputSchema": { "properties": { "constituency": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Constituency" }, "include_inactive": { "default": false, "title": "Include Inactive", "type": "boolean" }, "legislature": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Legislature" }, "limit": { "default": 50, "title": "Limit", "type": "integer" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Name" }, "party": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Party" } }, "title": "parliament_deputiesArguments", "type": "object" }, "name": "parliament_deputies", "outputSchema": { "additionalProperties": true, "title": "parliament_deputiesDictOutput", "type": "object" } }, { "description": "Full record of one initiative: every phase with dates, every vote with each group's position, text link.\n\nArgs:\n initiative_id: the `id` from parliament_search (e.g. \"356403\"), or a reference like \"Proposta de Lei 3\".\n", "inputSchema": { "properties": { "initiative_id": { "title": "Initiative Id", "type": "string" }, "legislature": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Legislature" } }, "required": [ "initiative_id" ], "title": "parliament_initiativeArguments", "type": "object" }, "name": "parliament_initiative", "outputSchema": { "additionalProperties": true, "title": "parliament_initiativeDictOutput", "type": "object" } }, { "description": "Search initiatives in the Portuguese Parliament: bills, resolutions, inquiries.\n\nArgs:\n query: words in the title, e.g. \"habitação\", \"IRS\", \"imigração\".\n type: e.g. \"Projeto de Lei\", \"Proposta de Lei\" (Government bills), \"Projeto de Resolução\".\n author: party acronym (\"PS\", \"PSD\", \"CH\", \"IL\", \"L\", \"PCP\", \"BE\", \"CDS-PP\", \"PAN\", \"JPP\") or \"Governo\".\n result: \"aprovado\" or \"rejeitado\" — keeps initiatives whose latest vote had this result.\n since: \"YYYY-MM-DD\" — submitted on or after this date.\n legislature: Roman numeral, default the current one (XVII).\n limit: max results, newest first.\n", "inputSchema": { "properties": { "author": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Author" }, "legislature": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Legislature" }, "limit": { "default": 10, "title": "Limit", "type": "integer" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Query" }, "result": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Result" }, "since": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Since" }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Type" } }, "title": "parliament_searchArguments", "type": "object" }, "name": "parliament_search", "outputSchema": { "additionalProperties": true, "title": "parliament_searchDictOutput", "type": "object" } }, { "description": "Recent plenary votes, with how each parliamentary group voted.\n\nArgs:\n party: show this group's position on each vote (e.g. \"PS\", \"CH\"); only votes where it is recorded.\n query: words in the initiative title.\n since: \"YYYY-MM-DD\".\n result: \"aprovado\" or \"rejeitado\".\n limit: max votes, newest first.\n", "inputSchema": { "properties": { "legislature": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Legislature" }, "limit": { "default": 20, "title": "Limit", "type": "integer" }, "party": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Party" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Query" }, "result": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Result" }, "since": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Since" } }, "title": "parliament_votesArguments", "type": "object" }, "name": "parliament_votes", "outputSchema": { "additionalProperties": true, "title": "parliament_votesDictOutput", "type": "object" } }, { "description": "Pharmacies in a Portuguese municipality, with which ones are on duty today and open now.\n\nUse for \"farmácia de serviço em X\", \"pharmacy open now near me\", or to list pharmacies\nto call. Each pharmacy has name, address, phone, coordinates, today's hours, open_now,\non_duty (official duty roster for the duty day 09:00-09:00) and the duty type\n(e.g. \"Permanente - Aberta 24h\"). Results are sorted: on duty first, then open now,\nthen distance (when lat/lon are given). Stock is not public: never say a pharmacy has a\nmedicine.\n\nArgs:\n city: Municipality or town/parish, e.g. \"Lisboa\", \"Porto\", \"Cascais\",\n \"Alvalade, Lisboa\" (add \", <municipality>\" to disambiguate a town).\n lat, lon: Optional user position: adds distance_km and allows radius_km. With\n no city, the municipality is found from the coordinate.\n radius_km: Keep only pharmacies within this distance of lat/lon.\n on_duty_only: Only pharmacies on the duty roster today.\n open_now_only: Only pharmacies open right now.\n limit: Max pharmacies returned (default 20, max 100).\n", "inputSchema": { "properties": { "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "City" }, "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "limit": { "default": 20, "title": "Limit", "type": "integer" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "on_duty_only": { "default": false, "title": "On Duty Only", "type": "boolean" }, "open_now_only": { "default": false, "title": "Open Now Only", "type": "boolean" }, "radius_km": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Radius Km" } }, "title": "pharmaciesArguments", "type": "object" }, "name": "pharmacies", "outputSchema": { "additionalProperties": true, "title": "pharmaciesDictOutput", "type": "object" } }, { "description": "Streets in Porto with traffic or parking restrictions active on a day (default today).\n\nArgs:\n near: a street name (\"Rua de Santa Catarina\", matches part of it) or a Porto postal code\n (\"4000-457\"); or pass lat/lon.\n radius_km: around a postal code or point (default 0.5, max 5).\n day: \"YYYY-MM-DD\" (default today); planned restrictions are known weeks ahead.\n kind: \"all\", \"planned\" (works, events, loading, scaffolding) or \"unplanned\" (accidents,\n burst pipes, fallen trees...).\nWith no place, returns a city summary by reason plus the restrictions on the main streets.\n", "inputSchema": { "properties": { "day": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Day" }, "kind": { "default": "all", "title": "Kind", "type": "string" }, "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "limit": { "default": 25, "title": "Limit", "type": "integer" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "near": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Near" }, "radius_km": { "default": 0.5, "title": "Radius Km", "type": "number" } }, "title": "porto_road_closuresArguments", "type": "object" }, "name": "porto_road_closures", "outputSchema": { "additionalProperties": true, "title": "porto_road_closuresDictOutput", "type": "object" } }, { "description": "Latest readings of Porto's street sensors: air quality, noise and weather.\n\nArgs:\n kind: \"air\" (PM2.5, PM10, NO2, O3, CO in µg/m³), \"noise\" (LAeq in dB(A)), \"weather\"\n (temperature, humidity, rain, wind) or \"all\".\n near: a Porto postal code, or pass lat/lon, to sort sensors by distance.\nOnly readings from the last 3 hours are returned; sensors that stopped reporting are counted.\n", "inputSchema": { "properties": { "kind": { "default": "all", "title": "Kind", "type": "string" }, "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "near": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Near" } }, "title": "porto_sensorsArguments", "type": "object" }, "name": "porto_sensors", "outputSchema": { "additionalProperties": true, "title": "porto_sensorsDictOutput", "type": "object" } }, { "description": "CTT post offices, postal agents and post boxes near a place, closest first (ANACOM register).\n\nArgs:\n near: a postal code or municipality; or pass lat/lon.\n kind: \"stations\" (post offices, with hours and services), \"agents\" (postos de correios in\n shops and parish councils), \"boxes\" (post boxes, with last collection times) or \"all\".\n radius_km: search radius (default 1, max 10).\n", "inputSchema": { "properties": { "kind": { "default": "all", "title": "Kind", "type": "string" }, "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "limit": { "default": 8, "title": "Limit", "type": "integer" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "near": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Near" }, "radius_km": { "default": 1, "title": "Radius Km", "type": "number" } }, "title": "post_officesArguments", "type": "object" }, "name": "post_offices", "outputSchema": { "additionalProperties": true, "title": "post_officesDictOutput", "type": "object" } }, { "description": "Look up a Portuguese postal code (código postal, 'XXXX-XXX' or 'XXXX').\n\nReturns district, municipality, locality and the streets the code covers, plus a central point.\n", "inputSchema": { "properties": { "code": { "title": "Code", "type": "string" } }, "required": [ "code" ], "title": "postal_codeArguments", "type": "object" }, "name": "postal_code", "outputSchema": { "additionalProperties": true, "title": "postal_codeDictOutput", "type": "object" } }, { "description": "Planned power cuts (E-REDES maintenance works) for a postal code, municipality or parish.\n\nArgs:\n postal_code: \"2795-082\" for that street, or \"2795\" for the whole postal area.\n municipality: e.g. \"Sintra\", \"Vila Nova de Gaia\".\n parish: e.g. \"Algés\" (matches part of the parish name).\n days: how far ahead to look (max 60).\nWith nothing given, returns a national summary by municipality.\n", "inputSchema": { "properties": { "days": { "default": 14, "title": "Days", "type": "integer" }, "limit": { "default": 30, "title": "Limit", "type": "integer" }, "municipality": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Municipality" }, "parish": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Parish" }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Postal Code" } }, "title": "power_cutsArguments", "type": "object" }, "name": "power_cuts", "outputSchema": { "additionalProperties": true, "title": "power_cutsDictOutput", "type": "object" } }, { "description": "Is this place in a protected area or Natura 2000 site? (mainland Portugal, ICNF)\n\nArgs:\n near: a postal code or municipality (its centre is used); for a precise answer pass lat/lon.\nChecks the National Network of Protected Areas (natural parks, reserves, protected landscapes),\nNatura 2000 (SIC/ZEC for habitats, ZPE for birds), Ramsar wetlands and biosphere reserves,\nand returns each designation that covers the point, with its classifying act and area.\n", "inputSchema": { "properties": { "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "near": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Near" } }, "title": "protected_areasArguments", "type": "object" }, "name": "protected_areas", "outputSchema": { "additionalProperties": true, "title": "protected_areasDictOutput", "type": "object" } }, { "description": "Search Portuguese public contracts (Portal BASE) for one year.\n\nArgs:\n query: words in the contract object, e.g. \"software\", \"limpeza\", \"ambulâncias\".\n buyer: public body name or 9-digit NIF, e.g. \"Município de Lisboa\", \"SPMS\".\n supplier: company name or NIF.\n procedure: e.g. \"Ajuste Direto\", \"Concurso público\", \"Consulta Prévia\".\n min_value, max_value: contract price range in euros.\n year: contract-file year (default: this year; 2012 onwards).\n sort: \"value\" (largest first) or \"date\" (newest first).\n limit: max rows.\n", "inputSchema": { "properties": { "buyer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Buyer" }, "limit": { "default": 15, "title": "Limit", "type": "integer" }, "max_value": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Max Value" }, "min_value": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Min Value" }, "procedure": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Procedure" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Query" }, "sort": { "default": "value", "title": "Sort", "type": "string" }, "supplier": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Supplier" }, "year": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Year" } }, "title": "public_contractsArguments", "type": "object" }, "name": "public_contracts", "outputSchema": { "additionalProperties": true, "title": "public_contractsDictOutput", "type": "object" } }, { "description": "Totals for one buyer or supplier in a year: number of contracts, total value, by procedure, top partners.\n\nArgs:\n entity: name or 9-digit NIF of a public body or a company.\n role: \"buyer\", \"supplier\" or \"any\".\n year: default this year.\n top: how many top counterparties to list.\n", "inputSchema": { "properties": { "entity": { "title": "Entity", "type": "string" }, "role": { "default": "any", "title": "Role", "type": "string" }, "top": { "default": 10, "title": "Top", "type": "integer" }, "year": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Year" } }, "required": [ "entity" ], "title": "public_contracts_summaryArguments", "type": "object" }, "name": "public_contracts_summary", "outputSchema": { "additionalProperties": true, "title": "public_contracts_summaryDictOutput", "type": "object" } }, { "description": "Portugal's public holidays for a year (default: this year), with weekday.\n\nAlways lists the national holidays. Pass `municipality` (a concelho, e.g. \"Braga\", \"Lisboa\",\n\"Funchal\") to add its own municipal holiday and, in the Azores or Madeira, the regional ones:\nthat answers \"is tomorrow a holiday in Braga?\". Carnival is listed as optional: it is usually\na day off by government decision, not by law.\n", "inputSchema": { "properties": { "municipality": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Municipality" }, "upcoming_only": { "default": false, "title": "Upcoming Only", "type": "boolean" }, "year": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Year" } }, "title": "public_holidaysArguments", "type": "object" }, "name": "public_holidays", "outputSchema": { "additionalProperties": true, "title": "public_holidaysDictOutput", "type": "object" } }, { "description": "How full mainland Portugal's reservoirs are, per river basin, in the latest month published.\n\nArgs:\n basin: optional, e.g. \"Tejo\", \"Douro\", \"Guadiana\", \"Sado\", \"Ribeiras do Algarve\", \"Arade\".\nEach basin has its % of capacity, the historical average for that month, the same month a\nyear before and the capacity in hm³; plus the capacity-weighted mainland total.\n", "inputSchema": { "properties": { "basin": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Basin" } }, "title": "reservoir_levelsArguments", "type": "object" }, "name": "reservoir_levels", "outputSchema": { "additionalProperties": true, "title": "reservoir_levelsDictOutput", "type": "object" } }, { "description": "Statistics for schools in mainland Portugal (InfoEscolas, Ministry of Education).\n\nArgs:\n school: part of a school's name (\"Pedro Nunes\", \"Marquês de Pombal\") or its DGEEC code.\n municipality: list that municipality's schools (e.g. \"Braga\").\n level: \"1ciclo\", \"2ciclo\", \"3ciclo\", \"secundario\" (science-humanities, default) or\n \"profissional\" (vocational).\nEach school has its students, retention or dropout rate per grade, the share finishing the\ncycle on time next to the national figure for students with a similar profile, and (3rd\ncycle) direct-success paths. The national totals come with every answer.\n", "inputSchema": { "properties": { "level": { "default": "secundario", "title": "Level", "type": "string" }, "limit": { "default": 10, "title": "Limit", "type": "integer" }, "municipality": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Municipality" }, "school": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "School" } }, "title": "school_statsArguments", "type": "object" }, "name": "school_stats", "outputSchema": { "additionalProperties": true, "title": "school_statsDictOutput", "type": "object" } }, { "description": "Coastal sea forecast: wave height and period, wave direction, sea temperature (IPMA).\n\nArgs:\n place: coastal spot, e.g. \"Nazaré\", \"Peniche\", \"Faro\", \"Funchal\". Or pass lat/lon for the nearest one.\n day: 0 = today, 1 = tomorrow, 2 = the day after.\n", "inputSchema": { "properties": { "day": { "default": 0, "title": "Day", "type": "integer" }, "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "place": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Place" } }, "title": "sea_forecastArguments", "type": "object" }, "name": "sea_forecast", "outputSchema": { "additionalProperties": true, "title": "sea_forecastDictOutput", "type": "object" } }, { "description": "Hospital outpatient consultations per month and the % of FIRST specialist consultations\n(referred by a family doctor via CTH/SIGA) held within the guaranteed maximum time (TMRG).\n\nUse for \"how long is the wait for a first hospital appointment at X?\", \"is hospital Y on\ntime with first consultations?\", \"how many consultations did the Centro region do?\".\nOfficial monthly statistics (latest month usually 2-3 months back, provisional); there is no\nbreakdown by specialty in the open data.\n\nPer period (latest first): consultations_in_month / _year_to_date (total, first,\nsubsequent) and first_consultations_within_max_time_pct for the month and year-to-date.\n\nArgs:\n institution: Hospital or ULS name; mapped to its ULS.\n region: Norte | Centro | LVT (Lisboa) | Alentejo | Algarve. Ignored if institution is given.\n period: Latest month to include, \"YYYY-MM\" (default: newest available).\n months: How many months back (default 6, max 24).\n", "inputSchema": { "properties": { "institution": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Institution" }, "months": { "default": 6, "title": "Months", "type": "integer" }, "period": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Period" }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Region" } }, "title": "consultation_wait_statsArguments", "type": "object" }, "name": "sns_consultation_wait_stats", "outputSchema": { "additionalProperties": true, "title": "consultation_wait_statsDictOutput", "type": "object" } }, { "description": "Emergency-department (urgência) visits per month: by type and by Manchester triage colour.\n\nUse for \"how busy is the ER at X?\", \"how many emergency visits in the Algarve last month?\",\n\"what share of ER visits are green/blue (non-urgent)?\". OFFICIAL MONTHLY STATISTICS ONLY —\nnot the live queue (the latest month is usually 2-3 months back and provisional). For live\nwaiting times send the user to https://tempos.min-saude.pt. Not medical advice: in an\nemergency call 112; SNS 24 (808 24 24 24) for advice.\n\nScope: one institution, one region, or (neither) all of mainland Portugal's SNS hospitals.\n\nPer period (latest first): visits_in_month and visits_year_to_date by type (general,\npaediatric, obstetric, psychiatric, total), triage_in_month by colour (red = immediate,\norange = very urgent, yellow = urgent, green = less urgent, blue = non-urgent, white = not\nclinical / other) and triage_share_in_month_pct.\n\nArgs:\n institution: Hospital or ULS name, accent-insensitive (\"Santa Maria\", \"São João\",\n \"Hospital de Faro\"). A hospital is mapped to its ULS; check `scope`.\n region: Norte | Centro | LVT (Lisboa) | Alentejo | Algarve. Ignored if institution is given.\n period: Latest month to include, \"YYYY-MM\" (default: newest available).\n months: How many months back to return (default 6, max 24).\n", "inputSchema": { "properties": { "institution": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Institution" }, "months": { "default": 6, "title": "Months", "type": "integer" }, "period": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Period" }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Region" } }, "title": "emergency_statsArguments", "type": "object" }, "name": "sns_emergency_stats", "outputSchema": { "additionalProperties": true, "title": "emergency_statsDictOutput", "type": "object" } }, { "description": "Find SNS hospitals / local health units (ULS) by name, or the nearest ones to a coordinate.\n\nUse this first when the user names a hospital or a place (\"hospitals near Lisbon\",\n\"is there an emergency department near 38.72,-9.14?\"), then pass `stats_entity` to\nsns_emergency_stats / sns_surgery_wait_stats / sns_consultation_wait_stats.\n\nEach result: name, its parent ULS, coordinates, distance_km (when lat/lon given), whether\nit reports emergency / consultation / surgery data on tempos.min-saude.pt, and\n`stats_entity` — the name under which the official statistics report it (statistics are\nper ULS / hospital group, not per building). This list does NOT contain live waiting times;\nfor live emergency waits send the user to https://tempos.min-saude.pt.\n\nArgs:\n query: Part of the name, accent-insensitive, e.g. \"Santa Maria\", \"Faro\", \"ULS Algarve\".\n lat, lon: Sort by distance from this point (WGS84), e.g. Lisbon 38.7223, -9.1393.\n Without `query`, umbrella ULS entries are skipped (they duplicate a hospital's location).\n emergency_only: Only places that report emergency-department data.\n limit: Max results (default 10, max 50).\n", "inputSchema": { "properties": { "emergency_only": { "default": false, "title": "Emergency Only", "type": "boolean" }, "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "limit": { "default": 10, "title": "Limit", "type": "integer" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Query" } }, "title": "find_institutionsArguments", "type": "object" }, "name": "sns_find_institutions", "outputSchema": { "additionalProperties": true, "title": "find_institutionsDictOutput", "type": "object" } }, { "description": "Run an ODSQL query on any SNS Transparency portal dataset (Opendatasoft Explore API v2.1).\n\nUse after sns_search_datasets for anything the curated tools don't cover. Clauses are ODSQL:\n - where: `instituicao like \"santa maria\" and tempo >= date'2026-01-01'`\n (`like` is a case- and accent-insensitive \"contains\"; dates use date'YYYY-MM-DD')\n - select: `tempo, instituicao, total_urgencias` or aggregates `sum(total_urgencias) as total`\n - group_by: `regiao` or `tempo` (combine with aggregates in select)\n - order_by: `tempo desc`\nMost hospital-activity datasets (field `tempo`, monthly) store YEAR-TO-DATE CUMULATIVE\nvalues: December is the annual total; a single month = this month minus the previous one.\nMany datasets have a `regiao` and an `instituicao` (or `entidade`) field. Official statistics,\nnot live data.\n\nArgs:\n dataset_id: e.g. \"ocupacao-do-internamento\" (from sns_search_datasets).\n where, select, group_by, order_by: ODSQL clauses (optional).\n limit: Rows to return (default 20, max 100).\n offset: Skip rows, for paging.\n", "inputSchema": { "properties": { "dataset_id": { "title": "Dataset Id", "type": "string" }, "group_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Group By" }, "limit": { "default": 20, "title": "Limit", "type": "integer" }, "offset": { "default": 0, "title": "Offset", "type": "integer" }, "order_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Order By" }, "select": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Select" }, "where": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Where" } }, "required": [ "dataset_id" ], "title": "query_datasetArguments", "type": "object" }, "name": "sns_query_dataset", "outputSchema": { "additionalProperties": true, "title": "query_datasetDictOutput", "type": "object" } }, { "description": "Search the ~150 datasets of the SNS Transparency portal (titles and descriptions are in Portuguese).\n\nUse when the curated tools don't cover the question — e.g. hospital bed occupancy\n(\"ocupação\"), births/caesareans (\"partos\"), INEM pre-hospital calls, SNS 24 calls, family\ndoctor coverage (\"médico de família\", \"inscritos\"), medicines spending, staff (\"trabalhadores\"),\ncancer screening (\"rastreios\"). Then call sns_query_dataset with the dataset_id and the field names\nreturned here. Portuguese keywords work best; matching is accent-insensitive.\n\nArgs:\n query: Keywords, e.g. \"ocupação internamento\", \"partos\", \"urgência\". Empty = list all (id + title).\n limit: Max results (default 10, max 50; ignored when listing all).\n", "inputSchema": { "properties": { "limit": { "default": 10, "title": "Limit", "type": "integer" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Query" } }, "title": "search_datasetsArguments", "type": "object" }, "name": "sns_search_datasets", "outputSchema": { "additionalProperties": true, "title": "search_datasetsDictOutput", "type": "object" } }, { "description": "Surgery access indicators per month: surgical waiting list, % within the guaranteed\nmaximum time, mean days from admission to surgery, and surgeries performed.\n\nUse for \"how long is the wait for surgery at X?\", \"how many people are on the surgery list\nin the Norte region?\", \"how many operations did hospital Y do?\". Official monthly statistics\n(latest month usually 2-3 months back, provisional). The open data has NO breakdown by\nspecialty or procedure — say so if asked for one.\n\nPer period (latest first):\n - waiting_list: patients on the surgical waiting list (LIC) at month end, how many are\n still within the legal maximum guaranteed response time (TMRG, 180 days for normal\n priority since 2018) and the % within it.\n - mean_days_before_surgery_in_month / _year_to_date: average days between hospital\n admission and the operation for scheduled inpatient surgery (this is NOT the time on\n the waiting list).\n - surgeries_in_month / surgeries_year_to_date: scheduled (= inpatient + day surgery) and urgent.\n\nArgs:\n institution: Hospital or ULS name (\"Santa Maria\", \"Coimbra\", \"IPO Porto\"); mapped to its ULS.\n region: Norte | Centro | LVT (Lisboa) | Alentejo | Algarve. Ignored if institution is given.\n period: Latest month to include, \"YYYY-MM\" (default: newest available).\n months: How many months back (default 6, max 24).\n", "inputSchema": { "properties": { "institution": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Institution" }, "months": { "default": 6, "title": "Months", "type": "integer" }, "period": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Period" }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Region" } }, "title": "surgery_wait_statsArguments", "type": "object" }, "name": "sns_surgery_wait_stats", "outputSchema": { "additionalProperties": true, "title": "surgery_wait_statsDictOutput", "type": "object" } }, { "description": "Official tourism places in Portugal, near a point or in a municipality/region.\n\nArgs:\n kind: one of blue_flag_beaches, surf_spots, golf, spas, unesco, historic_villages,\n schist_villages, wine_villages, mountain_villages, marinas, walking_routes,\n santiago_ways, hotels.\n place: municipality, parish, district or region name, e.g. \"Cascais\", \"Algarve\", \"Peniche\".\n name: part of the name, e.g. \"Nazaré\", \"Pestana\".\n lat, lon: closest first, within radius_km (max 200).\n", "inputSchema": { "properties": { "kind": { "title": "Kind", "type": "string" }, "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "limit": { "default": 20, "title": "Limit", "type": "integer" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Name" }, "place": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Place" }, "radius_km": { "default": 25, "title": "Radius Km", "type": "number" } }, "required": [ "kind" ], "title": "tourism_placesArguments", "type": "object" }, "name": "tourism_places", "outputSchema": { "additionalProperties": true, "title": "tourism_placesDictOutput", "type": "object" } }, { "description": "Scheduled departures from a station or stop (official timetable, not live).\n\nArgs:\n stop: station or stop name, e.g. \"Lisboa Oriente\", \"Cais do Sodré\", \"Baixa-Chiado\", \"Prazeres\".\n operator: an operator id (see transit_operators) or a city/region: \"porto\", \"coimbra\", \"braga\",\n \"aveiro\", \"cascais\", \"barreiro\", \"algarve\", \"faro\", \"madeira\", or \"intercity\" (FlixBus coaches\n and CP). Default: CP and the Lisbon operators.\n when: ISO date-time in Lisbon time, e.g. \"2026-11-03T08:00\". Default: now.\n window_minutes: how far ahead to look (max 720).\n line: keep only a line or destination, e.g. \"28E\", \"Sintra\", \"Azul\".\n", "inputSchema": { "properties": { "limit": { "default": 12, "title": "Limit", "type": "integer" }, "line": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Line" }, "operator": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Operator" }, "stop": { "title": "Stop", "type": "string" }, "when": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "When" }, "window_minutes": { "default": 90, "title": "Window Minutes", "type": "integer" } }, "required": [ "stop" ], "title": "transit_departuresArguments", "type": "object" }, "name": "transit_departures", "outputSchema": { "additionalProperties": true, "title": "transit_departuresDictOutput", "type": "object" } }, { "description": "Find train stations, metro stations or bus/tram stops by name, or the nearest to a point.\n\nArgs:\n query: e.g. \"Oriente\", \"Porto Campanhã\", \"Marquês de Pombal\", \"Prazeres\".\n operator: an operator id (see transit_operators) or a city/region: \"porto\", \"coimbra\", \"braga\",\n \"aveiro\", \"cascais\", \"barreiro\", \"algarve\", \"faro\", \"madeira\", or \"intercity\" (FlixBus coaches\n and CP). Default: CP and the Lisbon operators.\n lat, lon: find the nearest instead of (or as well as) by name.\n", "inputSchema": { "properties": { "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "limit": { "default": 8, "title": "Limit", "type": "integer" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "operator": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Operator" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Query" } }, "title": "transit_find_stopsArguments", "type": "object" }, "name": "transit_find_stops", "outputSchema": { "additionalProperties": true, "title": "transit_find_stopsDictOutput", "type": "object" } }, { "description": "Which transport operators have timetables here, and what each one covers.", "inputSchema": { "properties": {}, "title": "transit_operatorsArguments", "type": "object" }, "name": "transit_operators", "outputSchema": { "additionalProperties": true, "title": "transit_operatorsDictOutput", "type": "object" } }, { "description": "Direct services between two stations (no changes), with departure, arrival and duration.\n\nExamples: CP \"Lisboa Oriente\" → \"Porto Campanhã\"; Fertagus \"Roma-Areeiro\" → \"Setúbal\";\nMetro \"Alameda\" → \"Aeroporto\" (same line only). Scheduled times, not live.\nArgs:\n operator: an operator id (see transit_operators) or a city/region: \"porto\", \"coimbra\", \"braga\",\n \"aveiro\", \"cascais\", \"barreiro\", \"algarve\", \"faro\", \"madeira\", or \"intercity\" (FlixBus coaches\n and CP). Default: CP and the Lisbon operators.\n when: ISO date-time in Lisbon time; default now.\n window_minutes: departures within this window (max 1440).\n", "inputSchema": { "properties": { "destination": { "title": "Destination", "type": "string" }, "limit": { "default": 6, "title": "Limit", "type": "integer" }, "operator": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Operator" }, "origin": { "title": "Origin", "type": "string" }, "when": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "When" }, "window_minutes": { "default": 240, "title": "Window Minutes", "type": "integer" } }, "required": [ "origin", "destination" ], "title": "transit_trips_betweenArguments", "type": "object" }, "name": "transit_trips_between", "outputSchema": { "additionalProperties": true, "title": "transit_trips_betweenDictOutput", "type": "object" } }, { "description": "Where the buses (and Lisbon trams) are right now: live positions reported by the vehicles.\n\nArgs:\n operator: \"stcp\" (Porto buses), \"smtuc\" (Coimbra buses) or \"carris\" (Lisbon buses and\n trams). City names work too: \"porto\", \"coimbra\", \"lisboa\".\n line: keep one line, e.g. \"500\", \"205\", \"28E\", \"103\".\n lat, lon: keep the vehicles near this point (within radius_km), closest first.\nFor Greater-Lisbon buses use bus_vehicle_positions / bus_next_arrivals (Carris Metropolitana).\n", "inputSchema": { "properties": { "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "limit": { "default": 20, "title": "Limit", "type": "integer" }, "line": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Line" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "operator": { "title": "Operator", "type": "string" }, "radius_km": { "default": 1, "title": "Radius Km", "type": "number" } }, "required": [ "operator" ], "title": "transit_vehiclesArguments", "type": "object" }, "name": "transit_vehicles", "outputSchema": { "additionalProperties": true, "title": "transit_vehiclesDictOutput", "type": "object" } }, { "description": "5-day weather forecast for a place in Portugal (IPMA, official).\n\nArgs:\n place: district capital or island town, e.g. \"Lisboa\", \"Porto\", \"Faro\", \"Funchal\", \"Ponta Delgada\".\n lat, lon: use instead of place for anywhere else; the nearest IPMA forecast location is used.\nReturns daily min/max temperature, rain probability, weather type, wind, and today's UV index.\n", "inputSchema": { "properties": { "lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lat" }, "lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Lon" }, "place": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Place" } }, "title": "weather_forecastArguments", "type": "object" }, "name": "weather_forecast", "outputSchema": { "additionalProperties": true, "title": "weather_forecastDictOutput", "type": "object" } }, { "description": "Active IPMA weather warnings (rain, wind, heat, cold, snow, fog, sea, thunderstorms).\n\nArgs:\n area: optional district or island group, e.g. \"Lisboa\", \"Madeira\", \"Açores\". Omit for the whole country.\n include_green: also list green (no-warning) entries. Default false.\n", "inputSchema": { "properties": { "area": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Area" }, "include_green": { "default": false, "title": "Include Green", "type": "boolean" } }, "title": "weather_warningsArguments", "type": "object" }, "name": "weather_warnings", "outputSchema": { "additionalProperties": true, "title": "weather_warningsDictOutput", "type": "object" } }, { "description": "When was a web address captured by Arquivo.pt, and how often did its content change?\n\nReturns the first and last capture, captures per year and up to `max_versions` versions where\nthe content changed (spread over the period), each with a link to the archived copy.\n", "inputSchema": { "properties": { "from_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "From Date" }, "max_versions": { "default": 12, "title": "Max Versions", "type": "integer" }, "to_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "To Date" }, "url": { "title": "Url", "type": "string" } }, "required": [ "url" ], "title": "web_archive_historyArguments", "type": "object" }, "name": "web_archive_history", "outputSchema": { "additionalProperties": true, "title": "web_archive_historyDictOutput", "type": "object" } }, { "description": "The text of a web page as Arquivo.pt saved it closest to a date.\n\n`when` takes a year, \"YYYY-MM\" or \"YYYY-MM-DD\" (default: the latest copy). Returns the capture\ndate, the page title, its readable text (cut at `max_chars`, up to 8000) and the archive link.\nQuote it briefly; the archive link shows the full page.\n", "inputSchema": { "properties": { "max_chars": { "default": 3000, "title": "Max Chars", "type": "integer" }, "url": { "title": "Url", "type": "string" }, "when": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "When" } }, "required": [ "url" ], "title": "web_archive_pageArguments", "type": "object" }, "name": "web_archive_page", "outputSchema": { "additionalProperties": true, "title": "web_archive_pageDictOutput", "type": "object" } }, { "description": "Search old versions of Portuguese websites in Arquivo.pt (full text, since 1996).\n\n`site` limits to one domain (e.g. \"publico.pt\", \"cm-porto.pt\"). `from_date`/`to_date` take a\nyear, \"YYYY-MM\" or \"YYYY-MM-DD\". Each result has the capture date, title, a short snippet and a\nlink to the archived copy. Good for \"what did the news say about X in 2010?\".\n", "inputSchema": { "properties": { "from_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "From Date" }, "limit": { "default": 10, "title": "Limit", "type": "integer" }, "query": { "title": "Query", "type": "string" }, "site": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Site" }, "to_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "To Date" } }, "required": [ "query" ], "title": "web_archive_searchArguments", "type": "object" }, "name": "web_archive_search", "outputSchema": { "additionalProperties": true, "title": "web_archive_searchDictOutput", "type": "object" } }, { "description": "Which parish, municipality and district a coordinate is in, plus altitude, land use and hazard maps.", "inputSchema": { "properties": { "lat": { "title": "Lat", "type": "number" }, "lon": { "title": "Lon", "type": "number" } }, "required": [ "lat", "lon" ], "title": "where_isArguments", "type": "object" }, "name": "where_is", "outputSchema": { "additionalProperties": true, "title": "where_isDictOutput", "type": "object" } }, { "description": "Burnt areas from wildfires in Portugal, mapped by satellite (EFFIS / Copernicus).\n\nNot a live list of fires in progress: EFFIS maps burnt areas from satellite a day or more later,\nand small fires can be missing.\nArgs:\n period: \"today\", \"week\", \"month\" or \"season\" (this year so far). Ignored when `year` is given.\n year: a past year from 2016, for the whole year.\n place: keep fires whose region or parish contains this, e.g. \"Algarve\", \"Monchique\", \"Viseu\".\n min_hectares: only fires at least this large.\n sort: \"area\" (largest first) or \"date\" (newest first).\n limit: max fires listed (totals always cover every match).\n", "inputSchema": { "properties": { "limit": { "default": 15, "title": "Limit", "type": "integer" }, "min_hectares": { "default": 0, "title": "Min Hectares", "type": "number" }, "period": { "default": "season", "title": "Period", "type": "string" }, "place": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Place" }, "sort": { "default": "area", "title": "Sort", "type": "string" }, "year": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Year" } }, "title": "wildfiresArguments", "type": "object" }, "name": "wildfires", "outputSchema": { "additionalProperties": true, "title": "wildfiresDictOutput", "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:30815d9932a6e6bb20b31e432b29d5bb2b6d329e6f486ff7cd77ab131b69dbcf | sha256sum