Skip to content
Andiamo
Integration guide

Plug Andiamo into your assistant

A single connector, two ways to use it: connect your account when you plug it in to unlock the personal tools (profile, watches, flights) and keep your history, or stay on the public URL to search rail, coach and places without an account.

01

Claude · custom connector

#

SettingsConnectors Add custom connector, then paste the main URL. Streamable HTTP transport. On connect, Claude opens an Andiamo sign-in page: you sign in with Google or your password, you authorize once, and your agent's calls are linked to your account (history, watches, profile applied automatically). In ChatGPT the same connector goes through developer mode (Plus or Pro subscription).

https://getandiamo.app/api/mcp
claude mcp add --transport http andiamo https://getandiamo.app/api/mcp

No account yet? The public URL exposes the same search tools (rail, coach, places), without history, watches or profile.

https://getandiamo.app/api/mcp/public
02

Rail · TGV Max

#

Several departure stations, one destination, a date or a range. Direct trips and one-connection trips, with the price: €0 on a TGV Max seat, otherwise the official price range for the line.

The rail search: several departure stations, direct trips and connections, time windows. TGV Max seats at €0, or every train with the official SNCF price range.

origins · destination · date · depart_after · arrive_before · tgvmax_only

The next TGV Max seat on a route, sweeping the ~30 days of the dataset. For “when can I get to Bordeaux?”.

origin · destination

Train cancelled or missed? What is left today (from now on) and tomorrow morning, across every departure station.

origins · destination · arrive_before
Limit

Seats move fast: an availability seen right now can be gone by the time you book. The dataset only covers a rolling ~30 days.

SNCF Open Data, tgvmax dataset, rolling ~30 days

03

Rail · all fares

#

No TGV Max pass? Andiamo widens the search to every train and shows the price range published by SNCF, either standard fare or with an Avantage card.

The rail search: several departure stations, direct trips and connections, time windows. TGV Max seats at €0, or every train with the official SNCF price range.

origins · destination · date · depart_after · arrive_before · tgvmax_only
list_stationsAnonymous

Resolves a city or station name into the exact labels used by the SNCF dataset: essential to disambiguate “Paris” or “Lyon”.

query · limit
Limit

The range covers the line in second class, all trains taken together: it is not the price of one specific train. The firm price stays the one on the retailer's site.

SNCF Open Data, TGV inOui / Ouigo fare dataset

04

Long-distance coach

#

Direct FlixBus and BlaBlaCar Bus links between two cities, night services included (next-day arrivals flagged by arrival_day_offset). Official GTFS timetables, no prices.

Long-distance FlixBus and BlaBlaCar Bus coaches (official GTFS timetables), night services included. Cheaper, slower: fares are not published as open data.

from_city · to_city · date · depart_after · arrive_before · max_results
Limit

These networks only serve about 200 French cities and do not run every pair. Outside their coverage the tool returns an explanation rather than an empty answer. Fares are not published as open data.

GTFS from transport.data.gouv.fr, rolling ~35 days

05

Places and first mile

#

“Fréjus”, “12 rue des Lilas, Bordeaux”, “Chamonix” become usable stations plus the time needed to reach them. In the 15 covered metro areas the first mile comes from real urban timetables (named line and stop); elsewhere it is estimated. Call it before any search when the traveller names a place rather than a station.

Turns a city, an address or a hamlet into usable stations, with the distance and the estimated access time (walking or local transit).

query · max_stations · max_km

Metro, tram and city bus to reach a station from an address, on real timetables: 15 metro areas covered, direct connections. Outside that coverage the first mile stays estimated.

from · station · date · arrive_before
plan_journeyAnonymous

Combined strategies: rail plus coach plus local access in one scored door-to-door plan, instead of a mode-by-mode comparison. The tool to call first.

from · to · date · arrive_before · tgvmax_only
Limit

Urban timetables only cover 15 metro areas, direct connections only, with no real-time data; elsewhere the first mile stays a straight-line estimate. The last mile out of the station is always estimated.

French national address base, station reference, urban GTFS feeds

06

Flights

#

Prices in euros, times, stops and CO₂ emissions through Google Flights, so you can decide honestly when the train ride is long.

search_flightsPersonal URL

Flights through Google Flights: prices in euros, times, stops, CO₂ emissions. Compare against the train without forgetting airport access.

origin · destination · date
Limit

Paid API: 15 searches per account per rolling 24 hours, one-way only. Time to reach the airport is on top.

Google Flights, personal MCP URL required

07

Traveller profile

#

What the agent remembers about you between conversations. Applied by default to every search run from your personal MCP URL.

get_my_profilePersonal URL

Reads your traveller profile (TGV Max pass, discount cards, usual stations, preference) before searching.

update_my_profilePersonal URL

Records your constraints as the conversation goes: no need to repeat them on every search.

has_tgvmax · discount_cards · home_city · favorite_stations · preference
08

Watches and alerts

#

Journey sold out? Andiamo checks again every 15 minutes and records an alert as soon as a seat opens up. Alerts are deduplicated.

create_watchPersonal URL

Watches a route over a period: Andiamo checks every 15 minutes and records an alert as soon as a seat shows up.

origin · destination · date_from · date_to · notify_email
list_watchesPersonal URL

Your active watches: route, period, status, last check.

delete_watchPersonal URL

Stops a watch and deletes its alerts.

watch_id
list_alertsPersonal URL

The availabilities your watches picked up, also readable on the dashboard.

limit · unseen_only
09

Strategy map

#

Every search returns a map_url field. The link carries the journeys in its fragment: nothing is sent or stored server-side, and the page stays readable offline once loaded. Open it to see the strategies on the map. Colour carries the rank there: solid copper for the best strategy, a pale rule for the third. A dashed line marks a walking or local leg.

10

Prompts to try

#

Once the connector is in place, these sentences are enough: the agent picks which tools to chain on its own.

  • I need to be in Chamonix on 20 August before 6 pm, leaving from Bordeaux. What are my options?

  • Find a TGV Max Paris → Marseille on Saturday, departing after 9 am.

  • I can leave from Lille or from Paris: best plan for Bordeaux on Friday?

  • Is there an overnight coach Lyon → Toulouse this week?

  • Which stations can I use from 12 rue des Lilas, Bordeaux?

  • Watch Paris → Nice from 10 to 15 September and tell me as soon as a TGV Max seat opens up.

11

Data sources

#
Trains, seats and fares
SNCF Open Data: tgvmax dataset and TGV inOui / Ouigo fares (ODbL)
Long-distance coaches
FlixBus and BlaBlaCar Bus GTFS via transport.data.gouv.fr
Flights
Google Flights
Addresses and stations
French national address base + built-in set of 342 stations

Andiamo is free and is not affiliated with any carrier. Coach networks only serve about 200 French cities, and flights are capped at 15 searches per account per 24 hours. No connector yet? Try a search in the playground.

12

Frequently asked questions

#
Where does the data come from?

From official datasets: SNCF Open Data for trains and price ranges, the FlixBus and BlaBlaCar Bus GTFS published on transport.data.gouv.fr for coaches, the French national address base for places, Google Flights for flights. Andiamo queries them on every search, with a very short cache.

Do you need an account?

Not to search: the public connector URL is enough. For the traveller profile, watches, alerts and flight search, connect your account when you add the main connector, one click via Google or password. A personal MCP URL, to keep secret, is still available for clients that cannot do OAuth.

Does Andiamo book the tickets?

No. It searches, compares and ranks strategies; you buy from the carrier: SNCF Connect, FlixBus, BlaBlaCar Bus or the airline.

Are the prices shown firm?

No. €0 applies to a TGV Max seat; otherwise Andiamo shows the official range published for the line in second class, all trains taken together, not the price of one specific train. An estimate is prefixed with . The firm price stays the one on the retailer's site.

What are the current limits?

The TGV Max dataset only covers a rolling 30 days or so, and seats move fast. Coach networks serve about 200 French cities and do not run every pair. First-mile distances are straight-line and the times are estimates. Flights are capped at 15 searches per account per 24 hours.

Are my searches stored?

From the public URL, nothing is tied to you. From your personal URL, tool calls are logged to feed the dashboard history. The map link itself never travels: everything sits in the URL fragment.