Developers

MCP tools reference

The Trident Taxis site exposes an MCP (Model Context Protocol) server at https://tridenttaxis.online/mcp. Any MCP-compatible client (Claude, ChatGPT, Codex, Cursor…) can discover and call the two tools below with no authentication.

Transport

Streamable HTTP per the MCP spec. POST JSON-RPC 2.0 requests to /mcp with headers Content-Type: application/json and Accept: application/json, text/event-stream.

estimate_fare

Estimate a taxi fare between two UK addresses using the live Argyll & Bute council tariff, vehicle rate mapping, and surcharges (airport, meet & greet, 8-seater local, pre-booking).

Inputs

Field	Type	Required	Notes
pickup	string (3–200)	yes	Pickup address or place name.
dropoff	string (3–200)	yes	Dropoff address or place name.
vehicleType	"saloon" \| "estate" \| "executive" \| "6seater" \| "mpv" \| "wav"	no	Defaults to saloon. mpv = 8-seater; wav = TX4 wheelchair-accessible.
departAt	string (ISO 8601, UTC)	no	Planned departure time — picks day / night / holiday tariff.
meetAndGreet	boolean	no	Airport meet & greet (+£25).

Example request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "estimate_fare",
    "arguments": {
      "pickup": "Helensburgh Central Station",
      "dropoff": "Glasgow Airport",
      "vehicleType": "saloon",
      "meetAndGreet": false
    }
  }
}

Example response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "£68.40 · 24.1 miles · 34 min · T1 tariff"
      }
    ],
    "structuredContent": {
      "fareGBP": 68.4,
      "distanceMiles": 24.1,
      "durationSeconds": 2040,
      "rate": "T1",
      "vehicleType": "saloon",
      "tariffVersion": "argyll-bute-2024",
      "appliedRules": [
        "council_metered_scale",
        "airport_pickup_surcharge:10",
        "pre_booking_surcharge:0.40"
      ]
    }
  }
}

get_service_info

Return an overview of the taxi service: coverage area, vehicle fleet with passenger capacity, tariff and surcharge summary, and booking channels. Takes no arguments.

Example request

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_service_info",
    "arguments": {}
  }
}

Example response

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Trident Taxis — Helensburgh, Lomond, Argyll & Bute private hire and licensed taxis.\n\nVehicles: saloon (≤4), estate (≤4), executive (≤4), 6-seater (≤6), 8-seater MPV (≤7), TX4 WAV (≤4 saloon rate, ≤7 mini-bus rate).\n\nTariffs: Argyll & Bute council metered scale — T1 day, T2 night/evening, T3 Christmas & New Year.\n\nSurcharges: £0.40 pre-booking, £10 airport pickup/drop, £25 airport meet & greet, +100% for 8-seater on local Helensburgh hires only.\n\nBook: https://tridenttaxis.online — call the numbers listed on the site."
      }
    ],
    "structuredContent": {
      "brand": "Trident Taxis",
      "area": "Helensburgh, Lomond, Argyll & Bute (UK)",
      "vehicles": [
        {
          "id": "saloon",
          "maxPassengers": 4
        },
        {
          "id": "estate",
          "maxPassengers": 4
        },
        {
          "id": "executive",
          "maxPassengers": 4
        },
        {
          "id": "6seater",
          "maxPassengers": 6
        },
        {
          "id": "mpv",
          "maxPassengers": 7,
          "note": "8-seater; +100% on local hires"
        },
        {
          "id": "wav",
          "maxPassengers": 7,
          "note": "TX4 WAV; saloon rate ≤4, mini-bus rate >4"
        }
      ],
      "surcharges": {
        "preBookingGBP": 0.4,
        "airportPickupOrDropGBP": 10,
        "airportMeetAndGreetGBP": 25,
        "eightSeaterLocalMultiplier": 2
      },
      "tariffs": [
        "T1 day",
        "T2 night/evening",
        "T3 Christmas & New Year"
      ],
      "bookingUrl": "https://tridenttaxis.online"
    }
  }
}

Try it from a terminal

Copy-paste this into a shell. No API key required.

curl

curl -sS https://tridenttaxis.online/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "estimate_fare",
      "arguments": {
        "pickup": "Helensburgh Central Station",
        "dropoff": "Glasgow Airport"
      }
    }
  }'