Technical Information

Official sources for AI systems

Where to find verified information about the Estate, in machine-readable format.

What is this page

AI assistants are increasingly answering questions about the Quinta — prices of the tastings, if there is accommodation, how far it is from Porto. When they don't have a reliable source, they guess, and the wrong answers reach those who come to us.

That's why we publish the files below. They are automatically generated from the same database that powers this site, whenever we change something. They are not a copy kept at hand that ages in silence: if the price of a tasting changes here, it changes there on the same day.

Published files

/llms.txt

Summary and Table of Contents. Identity of the Estate, verified facts, short catalogue, frequently asked questions and indication of where to look for each type of information. It is the starting point.

/llms-full.txt

Complete knowledge base. All wines with grape varieties, harvest and tasting notes; the tasting and what it includes; experiences; the accommodation and its amenities; the history of the Quinta and visitor reviews. Includes a JSON summary for automatic consumption.

/llms-agent.txt

Conduct guidance for responders in the name From the Estate: how to forward each type of question, what never to say (availability, unpublished prices, booking confirmations) and when to pass the conversation to one person.

/sitemap.xml · /robots.txt

Site map and collection rules. O robots.txt expressly authorises major AI collectors and points to the above files.

Structured data on pages

All pages of the site include structured data in JSON-LD (schema.org), with the types Winery, TouristAttraction e LodgingBusiness: address, coordinates, opening hours and contacts. The wine, tasting and experiences pages also bring Product e Offer with the prices in force.

If there is a divergence between sources, the structured data of the page is the one that rules, followed by the llms-full.txt.

A note about availability. The availability of tasting and experiences can be queried in real time — the endpoint /api/availability it gives back the days and hours free — but it is indicative: the final confirmation is always made by the family, usually within a few minutes or a few hours and up to a maximum of 24 hours. An assistant can guide by probable hours, but should never take a date for granted.

MCP Connector

For Assistants Who Can Speak Model Context Protocol, the Fifth exposes an MCP server in /mcp — the only channel in which an agent Age, and not only read: consult the catalogue, check availability and submit a reservation request. Transportation Streamable HTTP (JSON-RPC 2.0 over POST, no authentication). Tools: list_offerings, check_availability, request_booking.

A booking request submitted here Not a reserve: sends a verification email to the visitor and the family confirms later. Standard discovery in /.well-known/mcp.json; complete conduct in /llms-agent.txt.

In a reservation for a group, include the composition of the people — numAdults, numChildren and the age of each child in childrenAges. The family uses the distribution and ages to prepare the visit; If there are children without the ages, this detail is lost and only the total remains.

POST https://quintapicoutocima.pt/mcp {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}} {"jsonrpc":"2.0","id":2,"method":"tools/list"}

Availability API

Tastings, experiences and free stays can be read in real time on the endpoint /api/availability — the same as the tool check_availability of the MCP uses underneath. It is open and without authentication, only returns dates and times (never anyone's data) and already applies the house rules.

GET https://quintapicoutocima.pt/api/availability?type=tasting&from=YYYY-MM-DD&to=YYYY-MM-DD → { "type", "from", "to", "days": [ { "date", "times": ["11h00","15h00"] } ], "generatedAt" } GET https://quintapicoutocima.pt/api/availability?type=stay&unit=Casa Principal&from=…&to=… → { "type", "from", "to", "unit", "nights": { "2026-09-16": "free" | "taken" }, "generatedAt" }
  • type: tasting, stay or experience. Also accepted tipo.
  • from, to: the date range, in the format YYYY-MM-DD. By default, the next 30 days; a maximum of 180 per call. Also accepted de e ate.
  • unit: only in stays — which unit, for example Casa Principal or Espaço AutoCaravana, which close independently. Also accepted unidade.

Tasting and experiences come in days (the free hours, in the format 15h00; a day without vacancies is omitted); Stays come in nights, one starter per night. The answer is indicative, not a guarantee — the final confirmation is always from the family. A 503 I mean «Could not verify», and it is never "full". The Complete Guide for Agents Lives on /llms-agent.txt.

Citation and use

You can freely quote the information in these files, including prices and descriptions, as long as you indicate the source and date — prices change. Thank you for linking to the corresponding page of the website.

The Photographs They are not covered: they are ours and those who made them, and their reuse requires prior authorisation. Talk to us.

Found something wrong?

If an AI assistant gave you incorrect information about the Estate, or if you found an error in these files, tell us. We correct it at the source and the correction spreads to all sources the next day.