plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "trainsfyi",
  "version": "0.3.1",
  "description": "Find rail stations, networks, train positions, trip stops and current departures using the TrainsFYI API.",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Trains.fyi",
        "shortDescription": "Live trains and departures",
        "longDescription": "Find rail stations and operators, look up a train\u2019s currently available position, view its trip stops, and check up to five current station departures. Search can include a city, province, country or operator. Use Trains.fyi to explore railway services and answer questions about available train information. Coverage and freshness vary by network. Positions may be vehicle-sourced or estimated, and estimates are identified accordingly. Timetables do not confirm service on a particular date; a missing position does not mean a train is cancelled. Ticket booking, future-date last-train journey planning and historical train positions are not supported.",
        "defaultPrompt": [
          "Find the St Marys Ontario station.",
          "Where is VIA train 641?",
          "What are the next five GO Transit departures from Toronto Union Station?"
        ],
        "websiteURL": "https://trains.fyi/mcp/",
        "supportURL": "https://trains.fyi/support/contact/",
        "privacyPolicyURL": "https://trains.fyi/privacy/",
        "termsOfServiceURL": "https://trains.fyi/terms/",
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png",
        "developerName": "Radical Sloth Inc.",
        "category": "Travel"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Resolve a station with province context",
              "prompt": "Find the St Marys Ontario station.",
              "tools_triggered": "find_station",
              "expected_behavior": "The returned station is St. Marys on VIA Rail in Ontario, Canada. Preserve the Ontario constraint; do not substitute Sydney, Australia."
            },
            {
              "description": "Resolve an operator alias",
              "prompt": "Find the GO Transit rail network.",
              "tools_triggered": "find_network",
              "expected_behavior": "Identify GO Transit and its returned network slug. Do not guess a slug or confuse it with another operator."
            },
            {
              "description": "Locate a named train with honest freshness",
              "prompt": "Where is VIA train 641?",
              "tools_triggered": "find_network, find_train",
              "expected_behavior": "Resolve VIA Rail, then look up train 641. Report an available position with source and freshness, identifying estimates. If no position is available, say so without claiming cancellation; timetable candidates do not prove service today."
            },
            {
              "description": "Get the selected train timetable",
              "prompt": "Find VIA train 641 and show its stops.",
              "tools_triggered": "find_network, find_train, get_train_stops",
              "expected_behavior": "Use a trip_id returned by find_train, never the train number as a trip_id. Preserve the selected service_date when available. Show stop names and local railway times; distinguish schedule, realtime and estimated progress. If no trip is returned, state that stops are unavailable."
            },
            {
              "description": "Get current departures for a particular operator",
              "prompt": "What are the next five GO Transit departures from Toronto Union Station?",
              "tools_triggered": "find_station, get_station_departures",
              "expected_behavior": "Resolve Toronto Union with GO Transit context, then use the returned GO member station_id. Show up to five current departures with destination, local time and available platform/status. Report missing data honestly; never use the TTC member or invent departures."
            }
          ],
          "negative": [
            {
              "description": "Ticket purchase is outside this connector",
              "prompt": "Using Trains.fyi, buy me a VIA ticket from Toronto to Ottawa.",
              "expected_behavior": "Explain that ticket purchase is not supported. Do not claim to reserve, buy or charge anything."
            },
            {
              "description": "Future last-train planning is not exposed",
              "prompt": "Using Trains.fyi, when is the last GO train from Toronto to Barrie tomorrow?",
              "expected_behavior": "Explain that this connector cannot answer a future-date last-train planning query. Do not present the current departure board as tomorrow\u2019s service."
            },
            {
              "description": "Historical movement is not exposed",
              "prompt": "Using Trains.fyi, where exactly was VIA train 641 yesterday at noon?",
              "expected_behavior": "Explain that historical train positions are unavailable through this connector. Do not substitute the current position or timetable for historical observation."
            }
          ]
        },
        "demo_recording_url": "https://storage.googleapis.com/trainsfyi-station-images/review/trainsfyi-chatgpt-demo-2026-10-09.mp4"
      },
      "publication": {
        "release_notes": "Clarify the train-information listing description and its supported capabilities.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  },
  "author": {
    "name": "Radical Sloth Inc."
  }
}