.codex-plugin/plugin.json

{
  "name": "bilo-trains",
  "version": "1.4.0",
  "description": "Find trains and buses in Romania, with published times, fares, stops, connections and operator booking options.",
  "author": {
    "name": "JERRY TECHNOLOGIES S.R.L.",
    "url": "https://bilo.ro"
  },
  "homepage": "https://bilo.ro",
  "interface": {
    "displayName": "Bilo",
    "shortDescription": "Find trains & buses in Romania",
    "longDescription": "Find trains and buses in Romania by departure location, destination and travel date. View published departure and arrival times, journey durations and available adult fares. Open a journey to see its stops, operator and booking options.\n\nFor trains, view travel classes, direct journeys and connections, with ticket links to the operators. For buses, view published journeys and the reservation phone numbers or website links provided by the operators.\n\nSchedules and fares are based on the data available to Bilo, not live seat inventory. Connecting trains can require separate tickets, and connections are not guaranteed. The plugin does not contact operators, reserve seats, take payment or issue tickets.",
    "developerName": "JERRY TECHNOLOGIES S.R.L.",
    "category": "Travel",
    "capabilities": [
      "Search train and bus journeys",
      "View journey details",
      "Get reservation contacts and ticket links"
    ],
    "websiteURL": "https://bilo.ro",
    "privacyPolicyURL": "https://bilo.ro/confidentialitate",
    "termsOfServiceURL": "https://bilo.ro/termeni",
    "defaultPrompt": [
      "Find trains from București to Brașov tomorrow for two adults.",
      "Find buses from Rădăuți to Băile Felix tomorrow and show reservation contacts.",
      "Show the stops and booking options for my selected journey."
    ],
    "brandColor": "#143D2E",
    "logo": "./assets/logo.png",
    "composerIcon": "./assets/icon.png",
    "logoDark": "./assets/logo-dark.png",
    "composerIconDark": "./assets/icon-dark.png",
    "brandColorDark": "#A8D5BA",
    "supportURL": "https://bilo.ro/termeni#contact"
  },
  "mcpServers": "./.mcp.json",
  "extensions": {
    "com.openai": {
      "publication": {
        "release_notes": "1.4.0: Clarified the names and purpose of the three read-only tools: search_trips, get_trip_details and get_booking_options. Added field descriptions for journey locations, dates, adults, class, filters and pagination. Bus booking options use published reservation phone numbers; train booking options use operator ticket links. Bilo checkout is not offered by this MCP integration. Tool descriptions explain when to use each operation and its limits without preferential or comparative instructions. Prepared OpenAI platform certificate verification without requiring a Bilo account for travellers.",
        "translations": {
          "ro-RO": {
            "subtitle": "Trenuri și autocare în România",
            "description": "Caută trenuri și autocare în România după localitatea de plecare, destinație și data călătoriei. Vezi orele publicate de plecare și sosire, durata călătoriei și tarifele disponibile pentru adulți. Deschide o călătorie pentru opriri, operator și opțiunile de rezervare.\n\nPentru trenuri, vezi clasele de călătorie, cursele directe și legăturile, cu linkuri către bilete la operatori. Pentru autocare, vezi cursele publicate și numerele de telefon pentru rezervări sau linkurile oferite de operatori.\n\nOrarele și tarifele provin din datele disponibile în Bilo, fără confirmarea locurilor în timp real. Trenurile cu schimbări pot necesita bilete separate, iar legăturile nu sunt garantate. Pluginul nu contactează operatorii, nu rezervă locuri, nu încasează plăți și nu emite bilete."
          }
        }
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Train search for two adults",
              "prompt": "Find trains from București to Brașov tomorrow for two adults. Sort by price.",
              "tools_triggered": "search_trips",
              "expected_behavior": "Search mode=rail for the requested date and two adults, sorted by available adult fare. Return published times, prices or missing-price values, and tripId values. Report source failures or an empty result honestly. Do not claim live seats or invent prices."
            },
            {
              "description": "Train connection itinerary",
              "prompt": "Find trains from Suceava to Sibiu tomorrow, including connections. Show the stops and transfer waits for one journey.",
              "tools_triggered": "search_trips, get_trip_details",
              "expected_behavior": "Search mode=rail and inspect a returned journey. Include available intermediate stops, train numbers, dates and transfer waits. If a connection is returned, explain that separate tickets may be needed and the connection is not guaranteed."
            },
            {
              "description": "Train operator ticket links",
              "prompt": "Find a train from București to Brașov tomorrow and give me its ticket link without buying anything.",
              "tools_triggered": "search_trips, get_booking_options",
              "expected_behavior": "Search mode=rail and pass an unchanged returned tripId to get_booking_options. Show the published operator ticket links and identify the operators. Report missing links honestly. Do not offer a Bilo checkout or claim a purchase."
            },
            {
              "description": "First-class train filter and duration ordering",
              "prompt": "Find first-class trains from Brașov to București tomorrow for one adult, sort by duration and show details for one journey.",
              "tools_triggered": "search_trips, get_trip_details",
              "expected_behavior": "Use mode=rail, railClass=1, passengers=1 and sort=duration. Use a returned tripId for details. Retain class, published fares and source context. Report unavailable class or fares honestly without substituting second-class prices."
            },
            {
              "description": "Bus telephone reservation contact",
              "prompt": "Find buses from Rădăuți to Băile Felix tomorrow and show the reservation phone number for one journey. Do not call anyone.",
              "tools_triggered": "search_trips, get_booking_options",
              "expected_behavior": "Search mode=bus, then use a returned tripId to obtain its published reservation contact. Show the public phone number and a telephone link when available. State when no contact is published. Do not return a Bilo checkout, call the operator or claim a reservation. Never use the private administrator contact."
            }
          ],
          "negative": [
            {
              "description": "No in-chat train purchase: explain that Bilo can search and provide ticket links, but cannot purchase or issue tickets. Do not claim a purchase or invoke a nonexistent purchase tool.",
              "prompt": "Buy and issue a train ticket directly in this conversation."
            },
            {
              "description": "No saved-card payment or reservation: explain that the MCP cannot charge cards or reserve seats. Do not request payment credentials, create orders or claim a reservation.",
              "prompt": "Charge my saved card and reserve seats through Bilo."
            },
            {
              "description": "Passenger privacy: refuse access to another passenger’s private booking or email. Do not call public catalogue tools as if they could retrieve private passenger data.",
              "prompt": "Show another passenger’s booking and email."
            }
          ]
        },
        "commerce": true,
        "commerce_description": "Travel information and external booking contacts only. For buses, the plugin returns published reservation phone numbers when available; for trains, it returns published operator ticket links. It does not call operators, offer Bilo checkout, create orders, reserve seats, collect payment credentials, process payments or issue tickets.",
        "demo_recording_url": "https://bilo.ro/review/bilo-ad9058ce934c4c108ccb142cb6d120be.mp4"
      }
    }
  }
}