madeira.fun Hiking Permits
Server Details
Madeira hiking permit trails: availability for 120 days, fees, booking links and reservations.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 8 tools
Each tool has a clearly stated role, and the two-step reservation flow (start_reservation → confirm_reservation) is explicitly labeled, which reduces misselection risk. The one soft overlap is check_trail_availability vs get_start_times (both report permits left for a trail), but the descriptions explicitly cross-reference when to use each, and build_booking_link vs the per-time book_url is only a mild source of confusion.
All eight tools follow a strict snake_case verb_noun pattern (list_, get_, check_, build_, start_, confirm_). The verbs are semantically meaningful and consistent within families (get_permit_fees, get_reservation_status, get_start_times; start_/confirm_ pairing).
Eight tools cover discovery, availability, fees, link building, reservation, and status tracking without padding. Each tool maps to a distinct step in the visitor workflow, so every tool earns its place.
The surface covers the full reserve-and-pay lifecycle: find trail, check availability/start times, check fees, build a link, start/confirm reservation, and poll status. The notable gap is that status can report a reservation as cancelled but no tool allows cancelling or modifying a reservation, so an agent hits a dead end there.
Available Tools
8 toolsbuild_booking_linkBuild Booking LinkARead-onlyIdempotentInspect
Build the link a visitor opens to book a permit: https://madeira.fun/hiking/<seo_slug>?date=YYYY-MM-DD opens that date's start times on the trail page. Optional adults (visitors aged 13 or over who are not Madeira residents) and children (aged 12 or under, no fee) preset the party; lang sets the page language. The link books and stores nothing. On the page the visitor picks a start time and presses Reserve: madeira.fun submits the government reservation for them and emails a PayPay link to pay the government fee.
Inputs: date (required), trail (required), lang, adults, +1 more.
check_trail_availabilityCheck Trail AvailabilityARead-onlyIdempotentInspect
Day-by-day permit availability for one trail, from today up to 119 days ahead (Madeira dates). Each day is open (start times left for visitors), full (sold out for visitors), started (today only: every start time has already begun, nothing is left to book today; not sold out), closed, no_times (no start times listed) or unknown (not checked yet), with permits left for visitors and when it was last checked. Use date for one day, or from and to for a range; the default is the next 7 days. For the start times of a day, use get_start_times.
Inputs: trail (required), to, date, from.
confirm_reservationConfirm a Permit ReservationADestructiveInspect
Step 2 of 2: with the code the visitor got by email, madeira.fun signs them in, checks the start time live and submits the government reservation for exactly what start_reservation described. The answer gives order_id and status_token. The reservation is not paid: madeira.fun then emails the government's PayPay link, and the visitor must pay the permit fee to the government within 24 hours, or before the start time if that is sooner, or it lapses. Safe to retry: calling it again with the same reservation_token returns the same order and never books twice (also after a lost answer). At most 5 reservations per email per day through apps.
Inputs: code (required), reservation_token (required).
get_permit_feesGet Permit FeesARead-onlyIdempotentInspect
The government hiking permit fee records in force today (format MF-PRC-1.0, the same records as https://madeira.fun/hiking/permit-data), with legal references and exemptions. Give trail to get the fee that applies to that trail. The fee is paid to the government, never to madeira.fun.
Inputs: trail.
get_reservation_statusGet Reservation StatusARead-onlyIdempotentInspect
Where a reservation made with confirm_reservation stands: being reserved, waiting for payment (with the government's PayPay link, the amount and the deadline), paid, not taken, cancelled or lapsed. Needs order_id and status_token from confirm_reservation.
Inputs: order_id (required), status_token (required).
get_start_timesGet Start TimesARead-onlyIdempotentInspect
Give trail (required without a partner key). The start times of a trail with the permits left for visitors at each one (as the trail page shows them: a number from 6 up, "few" at 1 to 5, "full" at 0), and a book_url per open start time that opens Reserve on madeira.fun at that time. Today up to 119 days ahead: give trail and date, or from and to (up to 14 days per call). Further ahead, up to 365 days: one trail and one date per call. Start times that have already begun today are never listed. Rate limited; a partner key (Authorization: Bearer mfk_...) gives higher limits, longer ranges and every trail at once (omit trail).
Inputs: to, date, from, trail.
list_permit_trailsList Permit TrailsARead-onlyIdempotentInspect
List the Madeira trails that need a government hiking permit for a set start time and can be reserved on madeira.fun. Returns each trail's seo_slug (use it in the other tools), code (such as PR 18 or PS PR 1), name, island, official trail status, trail page and day feed links. Optional query filters by code or name, accents ignored.
Inputs: query.
start_reservationStart a Permit ReservationAInspect
Step 1 of 2 to reserve a Madeira hiking permit for a visitor through madeira.fun. Before calling, tell the visitor these three points in your own words and get their yes: (1) madeira.fun creates a madeira.fun account with the visitor's email address (or signs in the one they already have). (2) madeira.fun sends that email address and the party size to the Madeira government's Simplifica system (IFCN), which issues the permit. The name stays with madeira.fun. (3) Reserving is not paying: the government's PayPay payment link arrives by email, and the visitor must pay the permit fee to the government within 24 hours, or before the start time if that is sooner, or the reservation lapses. madeira.fun charges nothing and never collects the permit fee. This step checks the start time and emails the visitor a 6-digit code from madeira.fun; nothing is reserved yet. Then ask the visitor for the code and call confirm_reservation. Standard visitor reservations only (no Madeira residents, no Verified Permit): for those use build_booking_link. Today up to 119 days ahead. At most 3 codes per email per hour. For apps calling from a server: a call from a web page is refused.
Inputs: date (required), name (required), email (required), trail (required), +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Permits and campgrounds in the US, Canada, NZ and Australia: rules, dates, openings and alerts.
Hut-to-hut hiking tours in the Alps with live availability from multiple booking systems.
Unlimited-data eSIM for Portugal, Madeira and the Azores: live price for your dates, booking link.
Hiking routes in the Polish and Slovak Tatras: walking times, trail closures, route planning
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables AI assistants to answer questions about Portugal from official open-data sources — weather and warnings, postal codes, INE/BPstat statistics, parliamentary votes, public contracts, SNS health statistics, medicine shortages and duty pharmacies, fuel and EV charging prices, and Lisbon bus arrivals — all read-only with no API keys, citing the source and date of every answer.421MIT
- AlicenseAqualityDmaintenanceProvides comprehensive access to Portuguese weather data from IPMA, including forecasts, warnings, sea state, fire risk, UV index, seismic activity, and weather station observations for all Portuguese cities and islands.10MIT
- AlicenseAqualityDmaintenanceProvides access to Portuguese weather data from IPMA (Instituto Português do Mar e da Atmosfera), including weather forecasts, meteorological warnings, seismic data, UV index, and real-time observations from weather stations across Portugal.6MIT

@openar/mcpofficial
AlicenseAqualityDmaintenanceMCP server for Portuguese Parliament open data, enabling AI agents to access legislative initiatives, deputies, plenary votes, petitions, and parliamentary committees.1210 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.