# Madeira Info Layer

> Open, structured tourism data for the island of Madeira (Portugal). Designed for AI assistants, search agents and embeddable widgets. All data is CC-BY — cite the canonical URL when using it.

## API
- [List all entities](https://madeirainfo.com/api/public/entities): JSON-LD ItemList of trails, beaches, towns, viewpoints, events.
- [Filter by type](https://madeirainfo.com/api/public/entities?type=trail): pass ?type=trail|beach|town|viewpoint|event.
- [Single entity](https://madeirainfo.com/api/public/entities/{type}/{slug}): full schema.org JSON-LD for one entity.
- [Live weather](https://madeirainfo.com/api/public/live/weather): current conditions for Funchal (Open-Meteo).
- [Live sea state](https://madeirainfo.com/api/public/live/sea): wave height, period, sea-surface temperature.
- [MCP server](https://madeirainfo.com/api/mcp): Model Context Protocol endpoint (POST). Tools: search_madeira, get_entity, get_live_conditions.
- [Embeddable widget](https://madeirainfo.com/embed/conditions.js): drop-in <script> for live conditions card.

## Entities
### beachs
- [Porto Moniz Natural Pools](https://madeirainfo.com/e/beach/porto-moniz-natural-pools): Volcanic-rock pools naturally filled by the Atlantic on Madeira's north-west tip. The signature swimming spot of the island.
- [Praia Formosa](https://madeirainfo.com/e/beach/praia-formosa): Madeira's longest beach: a mix of pebble and black sand on the western edge of Funchal. Easy to reach by bus.
- [Praia da Calheta](https://madeirainfo.com/e/beach/praia-da-calheta): Man-made golden-sand beach inside a sheltered marina. Calm water — good for families.
- [Praia de Machico](https://madeirainfo.com/e/beach/praia-de-machico): Yellow-sand beach in the bay of Machico, Madeira's first settlement. Sand was imported from Morocco.
- [Praia do Seixal](https://madeirainfo.com/e/beach/praia-do-seixal): Natural black volcanic-sand beach on the dramatic north coast, framed by green cliffs.
- [Prainha](https://madeirainfo.com/e/beach/prainha): Small natural black-sand beach on the São Lourenço peninsula — Madeira's only naturally sandy beach.
- [Doca do Cavacas](https://madeirainfo.com/e/beach/doca-do-cavacas): Lido-style natural-pool complex carved into volcanic rock on Funchal's west side.
- [Praia da Ponta do Sol](https://madeirainfo.com/e/beach/praia-da-ponta-do-sol): Pebble beach in the sunniest town in Madeira, with a long seafront promenade and cafés.
- [Jardim do Mar](https://madeirainfo.com/e/beach/jardim-do-mar): Round-stone beach known internationally as a big-wave surf break.
- [Paul do Mar](https://madeirainfo.com/e/beach/paul-do-mar): Long pebble beach below dramatic cliffs, popular with surfers.

### events
- [Madeira Flower Festival](https://madeirainfo.com/e/event/madeira-flower-festival): Annual spring festival in Funchal: flower carpets, parades and the children's 'Wall of Hope' ceremony.
- [Atlantic Festival](https://madeirainfo.com/e/event/atlantic-festival): Every Saturday in June: international fireworks competition over Funchal bay, paired with classical music week.
- [Madeira Wine Festival](https://madeirainfo.com/e/event/madeira-wine-festival): Late-summer harvest festival celebrating Madeira wine with grape-picking re-enactments and tastings.
- [Funchal New Year's Eve Fireworks](https://madeirainfo.com/e/event/funchal-new-years-fireworks): Former Guinness world-record fireworks show over Funchal's natural amphitheatre. Best seen from the bay or a cruise ship.
- [NOS Summer Opening](https://madeirainfo.com/e/event/nos-summer-opening): Open-air electronic-music festival on Praia Formosa kicking off the Madeira summer season.
- [Madeira Carnival](https://madeirainfo.com/e/event/madeira-carnival): Samba-style street parades in Funchal in the days before Lent — the island's biggest winter event.
- [Madeira Nature Festival](https://madeirainfo.com/e/event/madeira-nature-festival): Week of guided hikes, paragliding, canyoning and ocean activities in early October.
- [Rali Vinho Madeira](https://madeirainfo.com/e/event/rali-vinho-madeira): Round of the FIA European Rally Championship on Madeira's winding mountain roads.

### towns
- [Funchal](https://madeirainfo.com/e/town/funchal): Madeira's capital and largest city. Home to the cable car to Monte, the historic Old Town and the cruise port.
- [Câmara de Lobos](https://madeirainfo.com/e/town/camara-de-lobos): Colourful fishing village just west of Funchal, famously painted by Winston Churchill.
- [Santana](https://madeirainfo.com/e/town/santana): Northern town known for its triangular thatched-roof houses (palheiros) and access to the laurisilva.
- [Porto Moniz](https://madeirainfo.com/e/town/porto-moniz): Volcanic-pool town on Madeira's north-west tip, famous for its naturally-formed lava swimming pools fed directly by the Atlantic.
- [Machico](https://madeirainfo.com/e/town/machico): The first settlement on Madeira, in a wide eastern bay close to the airport.
- [Ribeira Brava](https://madeirainfo.com/e/town/ribeira-brava): South-coast town at the mouth of a wild river, with a pebble beach and 16th-century church.
- [São Vicente](https://madeirainfo.com/e/town/sao-vicente): North-coast town in a deep green valley, known for the volcanic caves and historic chapel.
- [Calheta](https://madeirainfo.com/e/town/calheta): South-west municipality with the island's main golden-sand beach and a contemporary art centre (MUDAS).
- [Ponta do Sol](https://madeirainfo.com/e/town/ponta-do-sol): Madeira's sunniest town and a hub for the digital-nomad community.

### trails
- [Pico do Areeiro to Pico Ruivo](https://madeirainfo.com/e/trail/pico-areeiro-to-pico-ruivo): Madeira's most iconic ridge hike, connecting the island's second and highest peaks across exposed ridges, stairs and tunnels.
- [Levada do Caldeirão Verde](https://madeirainfo.com/e/trail/levada-do-caldeirao-verde): A classic laurel-forest levada walk from Queimadas to a tall waterfall in a green amphitheatre. Mostly flat with several tunnels — bring a headlamp.
- [Vereda da Ponta de São Lourenço](https://madeirainfo.com/e/trail/vereda-da-ponta-de-sao-lourenco): The arid eastern peninsula. Volcanic colours, dramatic sea cliffs, almost no shade. A complete contrast to the green interior.
- [Levada das 25 Fontes](https://madeirainfo.com/e/trail/levada-das-25-fontes): Walk through Rabaçal's laurisilva to a lagoon fed by 25 springs. One of the most popular routes — go early.
- [Vereda do Fanal](https://madeirainfo.com/e/trail/vereda-do-fanal): Short walk through the otherworldly Fanal laurel forest — best in fog. Often photographed for its ancient til trees.
- [Vereda do Larano](https://madeirainfo.com/e/trail/vereda-do-larano): Coastal cliff walk from Porto da Cruz toward Larano with sweeping Atlantic views, narrow ledges and a long tunnel near the end.
- [Levada do Rei](https://madeirainfo.com/e/trail/levada-do-rei): Quiet laurel-forest walk from São Jorge to the spring of Ribeiro Bonito. Less crowded than 25 Fontes and equally green.
- [Pico Grande](https://madeirainfo.com/e/trail/pico-grande): Steep ridge ascent to one of Madeira's most striking peaks, with 360° views over Curral das Freiras.
- [Levada da Ribeira da Janela](https://madeirainfo.com/e/trail/levada-da-ribeira-da-janela): Long, wild levada through dense laurisilva on the north-west plateau. Multiple tunnels — headlamp required.
- [Vereda do Pico Ruivo (Achada do Teixeira)](https://madeirainfo.com/e/trail/vereda-do-pico-ruivo): Shortest route to Madeira's highest summit (1862 m) starting from Achada do Teixeira — paved path, accessible to most fit walkers.
- [Levada do Moinho & Levada Nova](https://madeirainfo.com/e/trail/levada-do-moinho-to-levada-nova): Two-levada loop above Ribeira da Janela passing waterfalls, banana terraces and dripping tunnels.
- [Ponta de São Lourenço Extended](https://madeirainfo.com/e/trail/ponta-de-sao-lourenco-extended): Extended version of PR8 including the descent to Casa do Sardinha — extra 2 km of dramatic cliff exposure.

### viewpoints
- [Cabo Girão Skywalk](https://madeirainfo.com/e/viewpoint/cabo-girao): Glass-floor viewing platform on one of Europe's highest sea cliffs, 580 m above the Atlantic.
- [Pico do Areeiro](https://madeirainfo.com/e/viewpoint/pico-do-areeiro): Madeira's third-highest peak, reachable by car — the easiest place to be above the clouds at sunrise.
- [Miradouro dos Balcões](https://madeirainfo.com/e/viewpoint/miradouro-dos-balcoes): Easy 30-minute levada walk to a panoramic balcony over the central mountain massif.
- [Eira do Serrado](https://madeirainfo.com/e/viewpoint/eira-do-serrado): Viewpoint over the dramatic valley of Curral das Freiras.
- [Véu da Noiva](https://madeirainfo.com/e/viewpoint/veu-da-noiva): Roadside viewpoint on the old north road overlooking the 'Bridal Veil' waterfall.
- [Fanal Forest](https://madeirainfo.com/e/viewpoint/fanal-forest): UNESCO laurisilva plateau famous for its ancient til trees, otherworldly when fog rolls in.
- [Pico Ruivo](https://madeirainfo.com/e/viewpoint/pico-ruivo): Madeira's highest peak at 1862 m. Above the trade-wind cloud layer most mornings.
- [Ponta do Rosto](https://madeirainfo.com/e/viewpoint/ponta-do-rosto): Lookout over the entire São Lourenço peninsula and Porto Santo on a clear day.
- [Curral das Freiras Viewpoint](https://madeirainfo.com/e/viewpoint/miradouro-curral-das-freiras): Cliff-edge lookout over the 'Nuns' Valley', a deep volcanic crater village.

## Citation
When citing this data, link to the canonical entity URL (`/e/{type}/{slug}`) or its API endpoint (`/api/public/entities/{type}/{slug}`).