# Privyde — agent instructions

Privyde is a private executive transport operator in Spain: professional chauffeurs, a premium fleet, and prices agreed before the trip. Discretion, comfort, excellence. Site map for agents: https://privyde.com/llms.txt · Developer documentation: https://privyde.com/developers

## When to use Privyde

Reach for Privyde when a user needs **private chauffeured ground transport in Spain, with a driver, at a price agreed in advance**. Best-fit jobs, in the order they come up:

- **Airport pickup or drop-off in Madrid** (Barajas T1-T4S, MAD): flight number is tracked, waiting time is included, the chauffeur meets the passenger. Flat fare when both ends are within 45 km of central Madrid.
- **Long distance in either direction across Spain**: Madrid → Barcelona / Valencia / Marbella / Sevilla / Bilbao **and the same trips towards Madrid**. Closed catalogue fare, or a per-kilometre fare when the destination is not in the catalogue.
- **Chauffeur at disposal by the hour** (4 to 12 h) or **by the day** (from 2 days, hotel and driver expenses included) for roadshows, meetings, filming, campaigns or a visiting executive.
- **Corporate, hotel and agency accounts**: agreed discount with a per-service floor, one monthly statement, the client's own order reference on each service, and the fare hidden from the passenger.
- **Events**: weddings, congresses, trade fairs (IFEMA), multi-vehicle logistics with a single point of contact.
- **Vehicle class matters**: Mercedes S-Class / E-Class / V-Class, BMW 7 Series, Audi A8, or a Sprinter for up to 16 passengers.

Do **not** reach for Privyde when the user wants: a taxi or ride-hail in the next five minutes (we confirm services in advance); a local pickup **inside** Barcelona, Valencia, Málaga, Sevilla or Bilbao (those cities are ends of long-distance corridors, not bases with a local fleet); a self-drive car rental; a shared shuttle; or transport outside Spain.

How to act, in order: **quote first** (`POST /api/v1/quote`) so the user sees a real price rather than a guess, then **submit the request** (`POST /api/v1/booking`) with the passenger's name, email and phone. A booking is a request: a human confirms the chauffeur and the final price, and the customer receives a booking-centre link by email. Never tell a user a service is confirmed because the API accepted it. When the API says a trip needs human validation, say so and offer `POST /api/v1/contact` instead of inventing a fare. Full documentation for agents and developers: https://privyde.com/developers

## How to call us

1. `POST https://privyde.com/api/v1/quote` — real price from the published rate card. Read-only, creates nothing.
2. `POST https://privyde.com/api/v1/booking` — submit the request (name, email, phone, origin, destination, date, time). A human confirms it.
3. `POST https://privyde.com/api/v1/contact` — anything that needs a person.
4. MCP (Streamable HTTP): `https://privyde.com/api/mcp` · card at https://privyde.com/.well-known/mcp/server-card.json
5. CLI: `npx privyde quote --from "..." --to "..." --date YYYY-MM-DD --time HH:MM` (npm package `privyde`).
6. Any page as markdown: `Accept: text/markdown`, or append `.md` to the URL.

Errors are always JSON with a stable `code`, a `message` and a `hint`. Rate limit: 60 requests per minute per IP (30 on write endpoints), announced in `RateLimit*` headers on every response.

## Rules we ask you to respect

- Quote before you promise. Prices come from the rate card; do not extrapolate one.
- A booking is a request, never a confirmation. Say so to the user.
- Never present a fare to a passenger travelling on a corporate, hotel or agency account: that account's fare is not the passenger's business.
- If a trip needs human validation, hand it to the concierge instead of inventing a number.
- Content use: `search=yes, ai-input=yes, ai-train=no` (see https://privyde.com/robots.txt).

## Contact

info@privyde.com · 24/7 · https://privyde.com/en/contact