For AI agents: how to book a ride

What you can read

• Prices, seats, timetable and departure points as JSON: /api/config (always current — read it before each booking).
• The same facts as plain text: /llms.txt.
• Any page of this site as Markdown: request it with Accept: text/markdown.
• The API description: /openapi.json; the API catalog: /.well-known/api-catalog.

Booking through the form

Open geoarmtaxi.com/#book. Choose the direction, the departure point, the date, the departure time and the car type; type the number of passengers; enter the passenger's name and phone; press “Send”. Leave the field marked “Leave this field empty (anti-spam)” empty. The page then shows “Booking #… received. It is not confirmed yet”.

Booking through the API

Send one JSON request. Take point, time, car and currency from /api/config; the server computes the price.

POST https://geoarmtaxi.com/api/bookings
Content-Type: application/json

{
  "dir": "tbs-evn",
  "point": "avl",
  "date": "2026-11-05",
  "time": "11:00",
  "car": "sprinter",
  "pax": 2,
  "name": "Anna Smith",
  "phone": "+44 7700 900123",
  "currency": "GEL",
  "lang": "en",
  "notes": "Two suitcases",
  "agent": "ChatGPT"
}

The answer:

HTTP/1.1 201 Created

{
  "number": 123,
  "status": "received",
  "confirmed": false,
  "message": "✓ Booking #123 received. It is not confirmed yet — we will contact you shortly to confirm it.",
  "booking": {
    "dir": "tbs-evn", "date": "2026-11-05", "time": "11:00",
    "point": "(the departure point's name)", "car": "sprinter", "pax": 2,
    "total": "(pax × the current price)", "currency": "GEL",
    "price_confirmed_by_dispatcher": false
  },
  "status_token": "…",
  "status_url": "https://geoarmtaxi.com/api/bookings/status?token=…",
  "telegram": "https://t.me/GeoArmTaxiBot?start=…"
}

A wrong or missing field is answered with 422 and the name of the field; correct it and send again.

MCP server

An MCP server (streamable HTTP, no key) is at https://geoarmtaxi.com/mcp. Tools: get_prices_and_schedule, create_booking, get_booking_status. Server card: /.well-known/mcp/server-card.json. A skill for agents: /.well-known/agent-skills/index.json. In a browser that supports WebMCP, the same tools are registered on this site's pages.

What happens next

A booking is a request. Our dispatcher contacts the passenger by phone or Telegram and confirms it; until then it is not confirmed — please tell your user so. You can check with status_url. Payment is in cash to the driver during the ride; nothing is paid online. Cancelling is free: the passenger writes or calls us.

Rules

• Book only when a person asked you to, with that person's real name and phone number.
• One booking per trip. Do not repeat a request that was answered with 201.
• Never fill the anti-spam field (website).
• Requests are rate-limited; a 429 means try again later. If its field is phone, that phone already has 3 bookings in 24 hours — the passenger should call or write to us.

Frequently asked questions

Other routes and guides