Fair Fare

Official8 tools

by GoodTurnStudio · JavaScript

What a taxi, Uber or Lyft should cost, airport pickup rules, and overcharge checks.

MCP Server: io.github.GoodTurnStudio/fairfare

The MCP server io.github.GoodTurnStudio/fairfare provides functionality related to ride-hailing pricing and airport pickup rules. It focuses on determining what a taxi, Uber, or Lyft should cost, and includes logic for overcharge checks. The server is described as addressing expected costs and rule-based pickup behavior.

🛠️ Key Features

Taxi/ride-hailing cost expectations (taxi, Uber, Lyft)
Airport pickup rules
Overcharge checks

🚀 Use Cases

Verifying whether a requested fare aligns with expected pricing
Applying airport pickup rules to rides
Checking potential overcharges for taxi or ride-hailing services

⚡ Developer Benefits

Clear scope around cost expectation, pickup rules, and overcharge detection
Lends itself to integrations that validate fares for rides

⚠️ Limitations

Limited publicly provided detail beyond pricing, airport pickup rules, and overcharge checks

Captured live from the server via tools/list.

estimate_fare

What a trip should cost by taxi, Uber or Lyft. Distance and time by road between two places, the licensed taxi meter fare with the extras that apply at that hour, any airport flat fare, typical Uber and Lyft prices in New York, airport pickup rules, a pre-booked transfer option for airport trips, and links that open Uber, Lyft or public transport directions with the trip filled in.

Parameters4

from	string	required	Where the trip starts: an address, landmark, postcode, airport code (JFK, LHR) or lat,lon.
to	string	required	Where the trip ends, in the same forms as from.
when	string	optional	When the trip starts, in local time: now (the default), a time like 18:30 or 6pm, or a date and time like 2026-10-09T18:30.
city	string	optional	Optional tariff city id from list_cities, when the place names are ambiguous.

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Where the trip starts: an address, landmark, postcode, airport code (JFK, LHR) or lat,lon."
    },
    "to": {
      "type": "string",
      "description": "Where the trip ends, in the same forms as from."
    },
    "when": {
      "type": "string",
      "description": "When the trip starts, in local time: now (the default), a time like 18:30 or 6pm, or a date and time like 2026-10-09T18:30."
    },
    "city": {
      "type": "string",
      "description": "Optional tariff city id from list_cities, when the place names are ambiguous."
    }
  },
  "required": [
    "from",
    "to"
  ],
  "additionalProperties": false
}

check_fare

Was I overcharged? Check a fare that was paid. Compares what was paid with the official meter tariff, the airport flat fare or New York's typical Uber and Lyft prices for the same trip and hour, gives a verdict (fair, high or overcharged), the next steps for that company or city regulator, and a short message to send asking for a refund.

Parameters8

paid	string	required	What was paid, without the tip, for example 48.50.
kind	string	optional	Kind: taxi, uber, lyft, bolt or minicab. Defaults to taxi.
from	string	optional	Where the trip started.
to	string	optional	Where it ended.
city	string	optional	Tariff city id, when giving miles instead of from and to.
miles	number	optional	Trip length in miles, instead of from and to.
minutes	number	optional	Trip time in minutes, if known.
when	string	optional	When the trip starts, in local time: now (the default), a time like 18:30 or 6pm, or a date and time like 2026-10-09T18:30.

Raw schema

{
  "type": "object",
  "properties": {
    "paid": {
      "type": "string",
      "description": "What was paid, without the tip, for example 48.50."
    },
    "kind": {
      "type": "string",
      "enum": [
        "taxi",
        "uber",
        "lyft",
        "bolt",
        "minicab",
        "private_hire"
      ],
      "description": "Kind: taxi, uber, lyft, bolt or minicab. Defaults to taxi."
    },
    "from": {
      "type": "string",
      "description": "Where the trip started."
    },
    "to": {
      "type": "string",
      "description": "Where it ended."
    },
    "city": {
      "type": "string",
      "description": "Tariff city id, when giving miles instead of from and to."
    },
    "miles": {
      "type": "number",
      "description": "Trip length in miles, instead of from and to."
    },
    "minutes": {
      "type": "number",
      "description": "Trip time in minutes, if known."
    },
    "when": {
      "type": "string",
      "description": "When the trip starts, in local time: now (the default), a time like 18:30 or 6pm, or a date and time like 2026-10-09T18:30."
    }
  },
  "required": [
    "paid"
  ],
  "additionalProperties": false
}

best_time_to_ride

Cheapest time of day to take a ride. For New York, typical Uber and Lyft prices for a trip of a given length at every hour of the week, from the city's trip records, with the cheapest and most expensive hours today and whether waiting saves money. For other cities, how the taxi meter rates change by time of day.

Parameters3

city	string	optional	Tariff city id, for example nyc, london or chicago. Defaults to nyc.
miles	number	optional	Trip length in miles (New York only). Defaults to 3.
when	string	optional	When the trip starts, in local time: now (the default), a time like 18:30 or 6pm, or a date and time like 2026-10-09T18:30.

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "Tariff city id, for example nyc, london or chicago. Defaults to nyc."
    },
    "miles": {
      "type": "number",
      "description": "Trip length in miles (New York only). Defaults to 3."
    },
    "when": {
      "type": "string",
      "description": "When the trip starts, in local time: now (the default), a time like 18:30 or 6pm, or a date and time like 2026-10-09T18:30."
    }
  },
  "required": [],
  "additionalProperties": false
}

get_airport

Getting a ride at an airport. Where Uber and Lyft pick up, how the taxi rank works, flat taxi fares, drop-off and pickup charges for cars, meet and greet rules, public transport into the city with prices, and tips, from each airport's own pages.

Parameters1

code

string

required

Airport code or name, for example JFK, LAX, LHR or Heathrow.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Airport code or name, for example JFK, LAX, LHR or Heathrow."
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

get_taxi_tariff

A city's official taxi meter tariff. The starting charge, the rate per mile or kilometre, the waiting rate, time-of-day tariffs, extras and surcharges, flat fares, tipping custom and the official source.

Parameters1

city

string

required

Tariff city id from list_cities, for example nyc, chicago, london or birmingham.

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "Tariff city id from list_cities, for example nyc, chicago, london or birmingham."
    }
  },
  "required": [
    "city"
  ],
  "additionalProperties": false
}

check_driver_licence

Check a New York taxi or ride-app driver's licence. Whether a TLC licence number is active on New York City's daily open data for for-hire (Uber, Lyft, car service) and taxi drivers, its expiry date, and, if a name is given, whether it matches (the name on the licence is never returned). Other cities get the official way to check.

Parameters3

number	string	optional	The TLC licence number shown in the app or on the partition card.
name	string	optional	Optional name the driver gave, to check it matches.
city	string	optional	City: nyc (live check) or another city id for guidance. Defaults to nyc.

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "type": "string",
      "description": "The TLC licence number shown in the app or on the partition card."
    },
    "name": {
      "type": "string",
      "description": "Optional name the driver gave, to check it matches."
    },
    "city": {
      "type": "string",
      "description": "City: nyc (live check) or another city id for guidance. Defaults to nyc."
    }
  },
  "required": [],
  "additionalProperties": false
}

list_cities

Cities and airports covered. Every city whose official taxi tariff is on file and every airport with ground transport facts.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

check_fleet_file

Check a cab firm's fleet.json. Reads a taxi or minicab firm's fleet.json (the open format at fairfare.pages.dev/fleet that lets assistants find and book local firms directly) and lists anything to fix.

Parameters1

url

string

required

The https address of the fleet.json file.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The https address of the fleet.json file."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

README.md4 KBView on GitHub

goodturn-mcp

Remote MCP servers for 25 free, read-only everyday helpers by Good Turn Studio: money, health, jobs, travel, shopping, halal checks, football and scripture reading. One Cloudflare Worker turns each product's public OpenAPI spec into an MCP server, so any assistant that speaks MCP (Claude, ChatGPT, Alexa+, Cursor, VS Code and others) can use them.

One server per product: https://goodturn-mcp.pages.dev/<slug>/mcp
All products in one: https://goodturn-mcp.pages.dev/all/mcp (tool names start with the product slug)
Streamable HTTP, stateless JSON, MCP 2025-11-25 (and 2025-06-18, 2025-03-26), no sign-in
Every tool is read-only, with a title and annotations (readOnlyHint: true, destructiveHint: false, idempotentHint: true)
Nothing about the user is stored. Privacy: https://goodturn-mcp.pages.dev/privacy

Products

Product	Slug	What it does
Mizan	`mizan`	Shariah screening of US stocks under four standards, halal alternatives, purification, zakat
Halal or Not	`halalornot`	Halal checks for food, ingredients, medicines, stocks, funds and crypto
Fare Deals	`faredeals`	Cheap flights from any city, and the cheapest days to fly
Cheapest Price	`cheapestprice`	The lowest current price for a product, checked live
Spin My Day	`spinmyday`	A whole day out in any city, matched to weather, mood and diet
Cancel My Sub	`cancelmysub`	How to cancel US and UK subscriptions, and what a card charge is
Lower My Bill	`lowermybill`	Call scripts and low-cost plans to lower household bills
Price Drop Back	`pricedropback`	Store price-adjustment rules, deadlines and a claim message
Find My Money	`findmymoney`	Official unclaimed money searches in the US and UK
Supplement Check	`supplementcheck`	Supplement labels and doses against official upper limits
Plate Pal	`platepal`	Calories and nutrition for foods, chain meals and barcodes
Plan My Workout	`planmyworkout`	Workout plans and how to do any exercise
Med Bill Check	`medbillcheck`	US medical bills against Medicare rates, with dispute letters
Appeal My Claim	`appealmyclaim`	US health insurance denials, rights, deadlines and appeal letters
Job Spotter	`jobspotter`	Current US and UK job listings
Sync My Cycle	`syncmycycle`	Likely cycle phase today, with food and workout ideas
Wardrobe Connect	`wardrobeconnect`	Clothes that match a description or a picture
Form Guide	`formguide`	Football form, fixtures, results and tables
Books Like This	`bookslikethis`	Books like one you enjoyed, and screen adaptations
Talmud Scroller	`talmud`	Daily Talmud with Daf Yomi, and tractates in English
Scroll the Gurbani	`gurbani`	Daily Gurbani with English, any Ang or shabad
Gita Scroller	`gita`	Daily Bhagavad Gita verses with English
Scroll the Lore	`lore`	Greek and Norse myth, Homer, Hesiod and the Poetic Edda
Stoic Scroller	`stoics`	Marcus Aurelius, Epictetus and Seneca
Bible Swipe	`bible`	Daily Bible readings and any passage

How it works

build.py reads each product's live openapi.json and writes products.js: one tool per GET operation, named from its operationId, with inputs from its parameters. Descriptions are tidied into plain tool descriptions.
worker.mjs is the MCP server: initialize, tools/list and tools/call, which calls the product's own API and returns its answer. Answers with a say field carry a ready-made summary.
servers.json lists every server for the official MCP Registry (as io.github.GoodTurnStudio/<slug>). The Publish to the MCP Registry workflow logs in with GitHub OIDC and runs publish.py; publish.ps1 does the same from Windows.

Build and test

code

npm install
npm run build          # python3 build.py, then bundle to deploy/_worker.js
npm test               # every product through the worker, against the live APIs
npm run test:live      # every tool through the deployed servers with the MCP SDK client

Deploy deploy/ as a Cloudflare Pages project in advanced mode (_worker.js).

Licence

MIT for this code. Each product's API, data and answers belong to that product and are served under its own terms, linked from its page at https://goodturn-mcp.pages.dev/<slug>.

Install

Tools (8)

estimate_farecheck_farebest_time_to_rideget_airportget_taxi_tariffcheck_driver_licencelist_citiescheck_fleet_file

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://goodturn-mcp.pages.dev/fairfare/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "fairfare": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://goodturn-mcp.pages.dev/fairfare/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: io.github.GoodTurnStudio/fairfare

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

estimate_fare

check_fare

best_time_to_ride

get_airport

get_taxi_tariff

check_driver_licence

list_cities

check_fleet_file

goodturn-mcp

Products

How it works

Build and test

Licence

Install

Remote endpoint

Related servers