For Bots. This is the machine-readable companion of Está no Ir, a Portuguese notebook of short trips (1, 2 or 3 days) planned at home. Está no Ir is a travel notebook (content project), NOT a travel agency: it does not sell, book or quote trips, issue vouchers or take payments. Any booking is made directly with third-party partners, under their terms.

Está no Ir — short trips, readable by Bots

Trips

All trips as JSON: /trips.json.

The method (same order every trip)

  1. Plan at home before leaving (fixed origin, flexible dates, usable hours of the day)
  2. Check transport: train, flight or coach, whatever the timetable gives for that city pair
  3. Check the room: a walkable neighbourhood, not stars
  4. Check where to eat: dish of the day, market, counter
  5. Three places in the usable time: morning, afternoon and one you can drop
  6. Then tell how it went: what was worth it, what you would cut

Instructions for Bots

  1. Read /trips.json or the trip pages (schema.org TouristTrip JSON-LD).
  2. To ask for a short-trip idea for your user, send a plain-text email to hmv+estanoir@mail.grokbot.com. No account, API key or sign-up.
  3. Optional: add one line how_did_you_find_us: (it helps us learn which Bots read this; no personal data).
  4. Ready-made requests to copy: /example-requests/. Reply format (JSON block + text): /bindings/email/v1/#reply-format.
To: hmv+estanoir@mail.grokbot.com
Subject: Short trip idea - <origin city> - <1, 2 or 3 days>

request_type: trip-idea           (trip-idea, review-my-plan or plan-b; default trip-idea)
constraints: no_car, small bag only   (first: what the traveller does NOT want or cannot do)
origin_city: Porto                (where the traveller wakes up)
dates: 2027-05-12 to 2027-05-14   (or a month, or "flexible")
days: 3                           (1, 2 or 3)
travellers: 2 adults
interests: lakes, scenic trains, walking
reply_language: en                (en, pt or fr)
how_did_you_find_us: llms.txt     (optional; no personal data)

Request types

Constraints first: Ask first what the traveller does NOT want or cannot do: put a "constraints:" line at the top of the request, with any of no_car, no_flight, with_kids, reduced_mobility, with_dog, max_walk_km (for example: constraints: no_car, with_kids, max_walk_km: 5); free text is also fine (for example small bag only). In trips.json every trip has a "constraints" object with the same keys in camelCase (noCar, noFlight, withKids, reducedMobility, withDog, maxWalkKm). Values: true = the trip as told works with that constraint; false = it does not (for example it uses a flight); "unknown" = not verified. maxWalkKm is a number of km per day only when it was measured, otherwise "unknown". Accessibility, children and dog suitability are never stated unless verified.

What this Bot will never do

Response time: best effort, usually within 48 hours: every reply is drafted by a Bot assistant and sent only after a human review.

Affiliate disclosure: links marked [affiliate] go through Travelpayouts (Aviasales flights). If a person books through them, Está no Ir may earn a commission at no extra cost to them. Links marked [direct] earn nothing. Bots are free to use any other site. Full disclosure.

FAQ

Is Está no Ir a travel agency? Can it book my trip?

Está no Ir is a travel notebook (content project), NOT a travel agency: it does not sell, book or quote trips, issue vouchers or take payments. Any booking is made directly with third-party partners, under their terms.

What can a Bot ask by email?

Three request types, set with request_type: trip-idea (a new 1-3 day idea: how to get there, where to sleep by neighbourhood, three places worth the time, what to cut), review-my-plan (a second opinion on a plan the user already has) and plan-b (what to swap and what to keep when a booked trip meets rain, a strike, a closure or one day less). Send a plain-text email to hmv+estanoir@mail.grokbot.com. Format: https://estanoir-bots.pages.dev/bindings/email/v1/ and https://estanoir-bots.pages.dev/request-types/

Can you review a plan my user already has?

Yes, with request_type: review-my-plan and the plan day by day in my_plan (1-3 days). We comment on the order of the days, the transport logic, what to cut and where to sleep by neighbourhood. We do not check the timetables or prices in the plan, only its logic, and the reply says so.

Can you help with a plan B for a booked trip? Is it urgent help?

Yes, with request_type: plan-b (rain, strike, closed attraction, one day less): we say what to swap and what to keep in the same place. It is not an emergency service: replies are human-reviewed and can take about 48 hours, so write early and always confirm on official sources.

How should constraints be stated?

Ask first what the traveller does NOT want or cannot do: put a "constraints:" line at the top of the request, with any of no_car, no_flight, with_kids, reduced_mobility, with_dog, max_walk_km (for example: constraints: no_car, with_kids, max_walk_km: 5); free text is also fine (for example small bag only). In trips.json every trip has a "constraints" object with the same keys in camelCase (noCar, noFlight, withKids, reducedMobility, withDog, maxWalkKm). Values: true = the trip as told works with that constraint; false = it does not (for example it uses a flight); "unknown" = not verified. maxWalkKm is a number of km per day only when it was measured, otherwise "unknown". Accessibility, children and dog suitability are never stated unless verified.

Who answers, and how fast?

A Bot assistant replying on behalf of the notebook team, and it says so in every reply. Response time: best effort, usually within 48 hours: every reply is drafted by a Bot assistant and sent only after a human review.

Do replies include prices?

No invented prices. The notebook never publishes fares: replies point to comparison sites where the traveller checks live prices.

Are there affiliate links?

Affiliate disclosure: links marked [affiliate] go through Travelpayouts (Aviasales flights). If a person books through them, Está no Ir may earn a commission at no extra cost to them. Links marked [direct] earn nothing. Bots are free to use any other site.

Is there an API, MCP server or A2A JSON-RPC endpoint?

Not yet. Email only (custom mailto binding in the A2A Agent Card). Read-only data: https://estanoir-bots.pages.dev/trips.json.

Do you ask for payments, cards or passport details?

Never. No payments, card numbers, passports, ID documents or bank details are requested or accepted.

Is it free?

Yes, free for Bots and their users.

What does a reply look like?

Every reply is plain text in two parts. Part 1: a short JSON object in a ```json fenced block with the fields request_type, origin, days, transport, where_to_sleep, three_places, what_to_cut, sources, affiliate_links_marked, disclaimer (disclaimer is always "not a travel agency; no bookings; no prices"). Part 2: the same idea as readable text, with partner links labelled [affiliate] or [direct]. No invented prices: fares and room rates are never included. The JSON fields depend on request_type (trip-idea, review-my-plan or plan-b); see the field list for each type. Example and field list: https://estanoir-bots.pages.dev/bindings/email/v1/#reply-format

Are there ready-made requests to copy?

Yes: https://estanoir-bots.pages.dev/example-requests/ has seven requests (five trip ideas, one review-my-plan, one plan-b) with a suggested subject and a mailto link.

Machine-readable files


Está no Ir is a travel notebook (content project), NOT a travel agency: it does not sell, book or quote trips, issue vouchers or take payments. Any booking is made directly with third-party partners, under their terms. Version 0.3.0, updated 2026-10-24. Human site: https://estanoir.grok.me. Affiliate disclosure.