Fare Deals

Official3 tools

by GoodTurnStudio · JavaScript

Cheap flights from any city, to one place or anywhere, with the cheapest days to fly.

io.github.GoodTurnStudio/faredeals (MCP Server)

The io.github.GoodTurnStudio/faredeals MCP server provides flight deal discovery focused on cheap flights. It describes options for traveling from any city to a specific destination or anywhere, and it includes the cheapest days to fly.

🛠️ Key Features

Cheap flights from any city
Destinations: one place or anywhere
Highlights the cheapest days to fly

🚀 Use Cases

Finding affordable flights departing from a current/selected city
Comparing travel plans for a specific place versus flexible “anywhere” travel
Planning departure dates using the cheapest-day guidance

⚡ Developer Benefits

Straightforward deal-oriented description (cheap flights, flexible destination, cheapest days)

⚠️ Limitations

No additional capabilities, tools, or configuration details were provided in the available server data

Captured live from the server via tools/list.

find_deals

Cheapest recent fares from a city, to a place or anywhere. The say field is a ready-made answer.

Parameters9

from	string	required	City or airport, for example New York or JFK. Add a state or country when a name is shared: Birmingham, UK; Birmingham, AL; Portland, Maine.
to	string	optional	City or airport, or anywhere (default). Same state or country hints as from.
month	string	optional	Departure month 2026-11 or date 2026-11-14.
return	string	optional	Return month or date.
one_way	boolean	optional	True for one-way fares only.
nonstop	boolean	optional	True for direct flights only.
max_price	number	optional	Budget in US dollars.
limit	integer	optional	How many deals to return, 1 to 20.
country	string	optional	Two-letter country for the currency, for example US, GB, CA, AU, DE. Leave out to use the traveller's location.

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "City or airport, for example New York or JFK. Add a state or country when a name is shared: Birmingham, UK; Birmingham, AL; Portland, Maine."
    },
    "to": {
      "type": "string",
      "description": "City or airport, or anywhere (default). Same state or country hints as from."
    },
    "month": {
      "type": "string",
      "description": "Departure month 2026-11 or date 2026-11-14."
    },
    "return": {
      "type": "string",
      "description": "Return month or date."
    },
    "one_way": {
      "type": "boolean",
      "description": "True for one-way fares only."
    },
    "nonstop": {
      "type": "boolean",
      "description": "True for direct flights only."
    },
    "max_price": {
      "type": "number",
      "description": "Budget in US dollars."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "How many deals to return, 1 to 20."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country for the currency, for example US, GB, CA, AU, DE. Leave out to use the traveller's location."
    }
  },
  "required": [
    "from"
  ],
  "additionalProperties": false
}

cheapest_dates

Cheapest departure days for a route in a month. Cheap flights from any city, to one place or anywhere, with the cheapest days to fly. Fares are the cheapest Aviasales travellers found in the last 48 hours. The live price is on the booking page.

Parameters4

from	string	required	Add a state or country when a name is shared, for example Portland, Maine.
to	string	required	Add a state or country when a name is shared, for example Portland, Maine.
month	string	required	2026-11.
country	string	optional	Two-letter country for the currency, for example US, GB, CA, AU, DE. Leave out to use the traveller's location.

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Add a state or country when a name is shared, for example Portland, Maine."
    },
    "to": {
      "type": "string",
      "description": "Add a state or country when a name is shared, for example Portland, Maine."
    },
    "month": {
      "type": "string",
      "description": "2026-11."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country for the currency, for example US, GB, CA, AU, DE. Leave out to use the traveller's location."
    }
  },
  "required": [
    "from",
    "to",
    "month"
  ],
  "additionalProperties": false
}

look_up_place

Look up a city or airport code. Cheap flights from any city, to one place or anywhere, with the cheapest days to fly. Fares are the cheapest Aviasales travellers found in the last 48 hours. The live price is on the booking page.

Parameters1

string

required

A city or airport name or code, for example Lisbon or LIS.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "A city or airport name or code, for example Lisbon or LIS."
    }
  },
  "required": [
    "q"
  ],
  "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 (3)

find_dealscheapest_dateslook_up_place

Remote endpoint

Streamable HTTP

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

url

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

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

io.github.GoodTurnStudio/faredeals (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

find_deals

cheapest_dates

look_up_place

goodturn-mcp

Products

How it works

Build and test

Licence

Install

Remote endpoint

Related servers