metto.ir

{
  "name": "get_route",
  "kind": "answer",
  "impl": "imperative",
  "description": "Plan a metro route between two stations. Returns stops, transfers, travel time, and path. Departure is an absolute instant: metto automatically derives the correct Iran (Asia/Tehran) weekday, Thursday, or Friday/official-holiday timetable from it — never pass a day type. Pass arrive_by instead of depart_at to get the latest feasible journey arriving at or before a deadline. Each leg also reports per-stop arrival times (Tehran HH:MM) from the timetable when available.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "from": {
        "type": "string",
        "description": "Origin station ID (stable slug, e.g. 'tajrish'; legacy English names accepted)"
      },
      "to": {
        "type": "string",
        "description": "Destination station ID (stable slug, e.g. 'tehran-sadeghiyeh'; legacy English names accepted)"
      },
      "depart_at": {
        "type": "string",
        "description": "ISO-8601 departure datetime with explicit timezone offset or Z (e.g. '2026-09-07T14:00:00+03:30'). Defaults to now. metto derives the Iran (Asia/Tehran) weekday/Thursday/Friday-or-official-holiday timetable automatically from this instant."
      },
      "arrive_by": {
        "type": "string",
        "description": "ISO-8601 arrival deadline with explicit timezone offset or Z (e.g. '2026-09-07T14:00:00+03:30'). metto returns the latest feasible journey reaching the destination at or before this instant, derived from the real timetable (never duration subtraction). Mutually exclusive with depart_at."
      }
    },
    "required": [
      "from",
      "to"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "list_stations",
  "kind": "answer",
  "impl": "imperative",
  "description": "List all metro stations. Optionally filter by line number or search query.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "line": {
        "type": "number",
        "description": "Filter by line number (1-7)"
      },
      "search": {
        "type": "string",
        "description": "Search by name (English or Farsi)"
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_station",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get full details for a single station.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "Station ID (stable slug, e.g. 'tajrish'; legacy English names accepted)"
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "find_nearby",
  "kind": "answer",
  "impl": "imperative",
  "description": "Find the closest metro stations to a GPS coordinate.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "lat": {
        "type": "number",
        "description": "Latitude"
      },
      "lng": {
        "type": "number",
        "description": "Longitude"
      },
      "limit": {
        "type": "number",
        "description": "Max results (default 5, max 20)"
      }
    },
    "required": [
      "lat",
      "lng"
    ],
    "additionalProperties": false
  },
  "page": "/"
}