Good Turn Studio (all tools)

Official162 tools

by GoodTurnStudio · JavaScript

All 27 Good Turn Studio helpers in one server: money, health, jobs, travel, art, halal, scripture.

io.github.GoodTurnStudio/all — Model Context Protocol (MCP) Server

The MCP server io.github.GoodTurnStudio/all bundles all 25 Good Turn Studio helpers into a single server. Its scope is described as covering money, health, jobs, travel, halal, and scripture, with the server providing these helper capabilities together.

🛠️ Key Features

Aggregates 25 Good Turn Studio helpers in one MCP server
Helper areas include money, health, jobs, and travel
Includes coverage for halal and scripture

🚀 Use Cases

Use when you need helper coverage across multiple domains (money, health, jobs, travel)
Use when you specifically need halal and scripture support

⚡ Developer Benefits

Single server surface for all 25 helpers
Centralized access to the listed helper areas: money, health, jobs, travel, halal, scripture

⚠️ Limitations

Provided information lists domains only; no additional tooling, interfaces, or tool counts are included in the source data

Captured live from the server via tools/list.

mizan_screen_company

Mizan. Screen one company against all four standards. Returns a 'say' sentence, the live price, the consolidated share count, the filing figures used, the business screen per standard ('business': main_business, by_standard pass/fail/review, excluded_under), and each standard's ratio, threshold and verdict. In each screens entry, 'compliant' is the overall verdict (false when that standard excludes the company's business, null when the business needs a closer look) and 'debt_compliant' is the debt test alone. Verdicts within one percent of a threshold are flagged borderline. A company name (for example nvidia) also works.

Parameters1

ticker

string

required

US listing symbol (a common company name also works).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "US listing symbol (a common company name also works)."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

mizan_list_standards

Mizan. The four standards, their denominators and thresholds. Screens a US-listed company against four published Shariah equity standards (AAOIFI, Dow Jones Islamic Market, S&P Shariah, MSCI Islamic), first on its business (prohibited industries each standard excludes) and then on its debt, using live...

Parameters

No parameters.

Raw schema

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

mizan_purify_dividend

Mizan. How much of a dividend to give to charity. Returns the company's purification ratio (interest income over total revenue, from its latest 10-K that reports interest income; 'latest_annual_filing' and 'note' say when that is older than the latest 10-K) and, if a dividend amount is given, the amount to give to charity. For a company whose main business every standard excludes, 'business_screen' explains that purification does not make it permissible.

Parameters2

ticker	string	required	US listing symbol.
dividend	number	optional	The dividend received, in any currency.

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "US listing symbol."
    },
    "dividend": {
      "type": "number",
      "description": "The dividend received, in any currency."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

mizan_find_halal_alternatives

Mizan. Halal alternatives to a holding. Companies Mizan covers in the same industry (or the nearest related one) whose business is permitted and whose debt passes all four standards at the last quarter-end, largest first, plus Shariah index funds for US and UK investors. Screen a pick live with screen_company before buying.

Parameters1

ticker

string

required

The holding to replace: a US listing symbol or company name.

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "The holding to replace: a US listing symbol or company name."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

mizan_screen_portfolio

Mizan. Screen a whole portfolio. Screens up to 15 holdings under all four standards and returns the share of the portfolio that is compliant under each, the holdings that fail, and a combined dividend purification ratio.

Parameters1

holdings

string

required

Comma-separated tickers, each optionally followed by a colon and the value held, for weighting.

Raw schema

{
  "type": "object",
  "properties": {
    "holdings": {
      "type": "string",
      "description": "Comma-separated tickers, each optionally followed by a colon and the value held, for weighting."
    }
  },
  "required": [
    "holdings"
  ],
  "additionalProperties": false
}

mizan_calculate_zakat

Mizan. Zakat owed on cash, gold, silver, shares and business stock, using live gold and silver prices.

Parameters13

currency	string	optional	Defaults to USD.
cash	number	optional	Cash and bank balances.
gold_grams	number	optional	Gold held, in grams.
gold_value	number	optional	Or the value of gold held.
silver_grams	number	optional	Silver held, in grams.
silver_value	number	optional	Or the value of silver held.
shares_trading	number	optional	Market value of shares held for trading (counted in full)
shares_longterm	number	optional	Market value of shares held long term.
share_zakatable_pct	number	optional	Share of long-term holdings treated as zakatable, default 25.
business_stock	number	optional	Value of business stock for sale.
owed_to_you	number	optional	Money owed to you that you expect to be repaid.
debts_due_now	number	optional	Debts due now, deducted.
nisab	string	optional	Which nisab to use. Defaults to silver.

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "enum": [
        "USD",
        "GBP",
        "EUR",
        "CAD",
        "AUD"
      ],
      "description": "Defaults to USD."
    },
    "cash": {
      "type": "number",
      "minimum": 0,
      "description": "Cash and bank balances."
    },
    "gold_grams": {
      "type": "number",
      "minimum": 0,
      "description": "Gold held, in grams."
    },
    "gold_value": {
      "type": "number",
      "minimum": 0,
      "description": "Or the value of gold held."
    },
    "silver_grams": {
      "type": "number",
      "minimum": 0,
      "description": "Silver held, in grams."
    },
    "silver_value": {
      "type": "number",
      "minimum": 0,
      "description": "Or the value of silver held."
    },
    "shares_trading": {
      "type": "number",
      "minimum": 0,
      "description": "Market value of shares held for trading (counted in full)"
    },
    "shares_longterm": {
      "type": "number",
      "minimum": 0,
      "description": "Market value of shares held long term."
    },
    "share_zakatable_pct": {
      "type": "number",
      "minimum": 0,
      "description": "Share of long-term holdings treated as zakatable, default 25."
    },
    "business_stock": {
      "type": "number",
      "minimum": 0,
      "description": "Value of business stock for sale."
    },
    "owed_to_you": {
      "type": "number",
      "minimum": 0,
      "description": "Money owed to you that you expect to be repaid."
    },
    "debts_due_now": {
      "type": "number",
      "minimum": 0,
      "description": "Debts due now, deducted."
    },
    "nisab": {
      "type": "string",
      "enum": [
        "silver",
        "gold"
      ],
      "description": "Which nisab to use. Defaults to silver."
    }
  },
  "required": [],
  "additionalProperties": false
}

halalornot_check_ingredients

Halal or Not. Check an ingredients list. Takes the ingredients exactly as printed on the pack. Returns an overall verdict, a verdict for each school, and every flagged ingredient with the reason.

Parameters2

ingredients	string	required	Ingredients list as printed, comma separated.
context	string	optional	'cosmetic' for products used on the skin, 'medicine' for medicines and supplements; these change how alcohol, carmine and necessity are treated.

Raw schema

{
  "type": "object",
  "properties": {
    "ingredients": {
      "type": "string",
      "description": "Ingredients list as printed, comma separated."
    },
    "context": {
      "type": "string",
      "enum": [
        "food",
        "cosmetic",
        "medicine"
      ],
      "default": "food",
      "description": "'cosmetic' for products used on the skin, 'medicine' for medicines and supplements; these change how alcohol, carmine and necessity are treated."
    }
  },
  "required": [
    "ingredients"
  ],
  "additionalProperties": false
}

halalornot_check_product_by_barcode

Halal or Not. Check a product by barcode. Looks the barcode up in Open Food Facts, then Open Beauty Facts, and checks its ingredients.

Parameters1

barcode

string

required

EAN-13, EAN-8 or UPC barcode digits.

Raw schema

{
  "type": "object",
  "properties": {
    "barcode": {
      "type": "string",
      "description": "EAN-13, EAN-8 or UPC barcode digits."
    }
  },
  "required": [
    "barcode"
  ],
  "additionalProperties": false
}

halalornot_search_products

Halal or Not. Find products by name and check them. Searches Open Food Facts by name or brand (for example 'Haribo Starmix') and returns up to five matches, each with a verdict, plus a 'say' line for the best match. Where a brand states the source of an ingredient its label leaves unnamed (Haribo: pork gelatine in its standard UK range), that statement decides it and is quoted in brand_statement.

Parameters2

q	string	required	A product, brand or barcode to look up, for example Haribo Starmix or 5000159484695.
country	string	optional	Open Food Facts country slug, for example united-kingdom, united-states, france. 'world' means no filter. Also picks the Amazon store for halal versions (amazon.co.uk for the UK and Ireland).

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "A product, brand or barcode to look up, for example Haribo Starmix or 5000159484695."
    },
    "country": {
      "type": "string",
      "default": "united-kingdom",
      "description": "Open Food Facts country slug, for example united-kingdom, united-states, france. 'world' means no filter. Also picks the Amazon store for halal versions (amazon.co.uk for the UK and Ireland)."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

halalornot_explain_ingredient

Halal or Not. Explain one ingredient or E-number. For example 'E471', 'carmine', 'prawns', 'whey' or 'alcohol denat'. Returns the verdict for each school and the reasoning.

Parameters2

name	string	required	The ingredient or E-number, for example E471, carmine, gelatin or alcohol denat.
context	string	optional	Whether the ingredient is in food or a cosmetic. Defaults to food.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The ingredient or E-number, for example E471, carmine, gelatin or alcohol denat."
    },
    "context": {
      "type": "string",
      "enum": [
        "food",
        "cosmetic"
      ],
      "description": "Whether the ingredient is in food or a cosmetic. Defaults to food."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

halalornot_screen_stock

Halal or Not. Is this stock halal? Screens a US-listed stock via Mizan: first the business (each standard's excluded industries), then the AAOIFI, Dow Jones Islamic, S&P Shariah and MSCI Islamic debt screens. A company name also works (nvidia, philip morris). Links to halal alternatives in the same industry.

Parameters1

ticker

string

required

A US stock ticker, for example AAPL or TSLA.

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "A US stock ticker, for example AAPL or TSLA."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

halalornot_ask_is_it_halal

Halal or Not. Ask any 'is it halal' question. Covers money (savings, credit cards, mortgages, BNPL, insurance, pensions, trading), crypto, medicine, food and drink, and everyday life (music, dogs, tattoos, nail polish, smoking, games, photos, jobs). Returns the verdict, the main scholarly views and halal alternatives. Also recognises single ingredients and E-numbers.

Parameters1

string

required

The question in plain words, for example 'Is a credit card halal?'

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "The question in plain words, for example 'Is a credit card halal?'"
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

halalornot_check_fund

Halal or Not. Is this fund, ETF or pension fund halal? Recognises Shariah funds by name or ticker. For other US-registered funds and ETFs, reads the latest SEC holdings report and screens every holding by industry and debt. UK-listed ETFs (VUSA, CSPX, VWRL, SWDA, EQQQ, ISF and others) and fund names (Vanguard S&P 500, FTSE 100 tracker, LifeStrategy) are answered through a US fund tracking the same index, or from what the index holds, with UK Shariah options.

Parameters1

ticker

string

required

Fund or ETF ticker (VOO, QQQ, SPUS) or a Shariah fund name.

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Fund or ETF ticker (VOO, QQQ, SPUS) or a Shariah fund name."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

halalornot_check_crypto

Halal or Not. Is this cryptocurrency halal? Classifies a coin by what it does (lending, gambling, meme, stablecoin, staking, general-purpose) and gives the scholarly views on crypto and on how it's used.

Parameters1

coin

string

required

Coin name or symbol, for example bitcoin, ETH, AAVE.

Raw schema

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Coin name or symbol, for example bitcoin, ETH, AAVE."
    }
  },
  "required": [
    "coin"
  ],
  "additionalProperties": false
}

halalornot_check_medicine

Halal or Not. Is this medicine halal? Reads a medicine's active and inactive ingredients from its US label (openFDA) and flags gelatine, alcohol, pig-derived enzymes and heparin. The headline and say line lead with the ruling on necessity, so nobody stops a prescribed medicine; the ingredient reading follows (ingredient_headline, verdict)

Parameters1

name

string

required

Brand or generic name.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Brand or generic name."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

halalornot_get_prayer_times

Halal or Not. Today's prayer times for a place, with both Asr times and Ramadan suhoor and iftar. Answers 'is it halal?' for food, cosmetics, medicines, stocks, funds, crypto, money products and everyday life, showing where the four Sunni schools and the main scholarly bodies agree and where they differ, with the reasoning and halal alt...

Parameters5

city	string	optional	City name, for example London or Chicago, IL.
lat	number	optional	Latitude of the place, in decimal degrees. Goes with lon instead of city.
lon	number	optional	Longitude of the place, in decimal degrees. Goes with lat instead of city.
date	string	optional	The day, YYYY-MM-DD. Defaults to today.
method	string	optional	Calculation method: isna (North America), mwl (Muslim World League), umm_al_qura, egypt, karachi or moonsighting.

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name, for example London or Chicago, IL."
    },
    "lat": {
      "type": "number",
      "description": "Latitude of the place, in decimal degrees. Goes with lon instead of city."
    },
    "lon": {
      "type": "number",
      "description": "Longitude of the place, in decimal degrees. Goes with lat instead of city."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "The day, YYYY-MM-DD. Defaults to today."
    },
    "method": {
      "type": "string",
      "enum": [
        "isna",
        "mwl",
        "umm_al_qura",
        "egypt",
        "karachi",
        "moonsighting"
      ],
      "description": "Calculation method: isna (North America), mwl (Muslim World League), umm_al_qura, egypt, karachi or moonsighting."
    }
  },
  "required": [],
  "additionalProperties": false
}

halalornot_list_topics

Halal or Not. Every question the rulebook covers. Answers 'is it halal?' for food, cosmetics, medicines, stocks, funds, crypto, money products and everyday life, showing where the four Sunni schools and the main scholarly bodies agree and where they differ, with the reasoning and halal alt...

Parameters1

halalornot_explain_schools

Halal or Not. How the four schools differ on food. Answers 'is it halal?' for food, cosmetics, medicines, stocks, funds, crypto, money products and everyday life, showing where the four Sunni schools and the main scholarly bodies agree and where they differ, with the reasoning and halal alt...

Parameters

No parameters.

Raw schema

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

halalornot_list_rules

Halal or Not. The full rulebook. Answers 'is it halal?' for food, cosmetics, medicines, stocks, funds, crypto, money products and everyday life, showing where the four Sunni schools and the main scholarly bodies agree and where they differ, with the reasoning and halal alt...

Parameters

No parameters.

Raw schema

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

faredeals_find_deals

Fare 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
}

faredeals_cheapest_dates

Fare Deals. 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
}

faredeals_look_up_place

Fare Deals. 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
}

cheapestprice_check_price

Cheapest Price. Lowest current price for a product, with compare links. The lowest current price for a product on eBay (and Best Buy in the US), checked live in the shopper's own country and currency, plus Amazon and local shop links to compare.

Parameters3

q	string	required	The product, as specific as possible, for example AirPods Pro 2.
used	boolean	optional	Include used items on eBay.
country	string	optional	Two-letter country for prices and shops. Leave out to use the shopper's location.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "The product, as specific as possible, for example AirPods Pro 2."
    },
    "used": {
      "type": "boolean",
      "description": "Include used items on eBay."
    },
    "country": {
      "type": "string",
      "enum": [
        "US",
        "GB",
        "IE",
        "CA",
        "AU",
        "DE",
        "FR",
        "IT",
        "ES"
      ],
      "description": "Two-letter country for prices and shops. Leave out to use the shopper's location."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

spinmyday_spin_my_day

Spin My Day. Build a day out. Leave out city and location to spin for a random city. Spin up a full day out (morning, lunch, afternoon, dinner, evening) around the weather and what is open, in a city, near a location, or in a random city.

Parameters8

city	string	optional	The city to plan the day in, for example Manchester or Austin, TX. Leave out with lat and lon for a random city.
lat	number	optional	Latitude, in decimal degrees, instead of city.
lon	number	optional	Longitude, in decimal degrees, instead of city.
vibe	string	optional	The feel of the day: chill, adventure, date, family, culture or foodie.
budget	string	optional	Budget: any, or free for free things only.
diet	string	optional	Food needs, comma separated: halal, kosher, vegetarian, vegan, pescatarian, gluten_free, dairy_free, jain. Lunch and dinner then name real places that OpenStreetMap lists for all of them (each meal says which in diet and diet_note). halal=true still works.
date	string	optional	The day to plan, YYYY-MM-DD. Leave it out for today, or tomorrow when it is already past 5pm there (the answer then says tomorrow: true).
seed	integer	optional	Repeat a spin exactly; each answer includes a spin_again link with a new seed.

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "The city to plan the day in, for example Manchester or Austin, TX. Leave out with lat and lon for a random city."
    },
    "lat": {
      "type": "number",
      "description": "Latitude, in decimal degrees, instead of city."
    },
    "lon": {
      "type": "number",
      "description": "Longitude, in decimal degrees, instead of city."
    },
    "vibe": {
      "type": "string",
      "enum": [
        "chill",
        "adventure",
        "date",
        "family",
        "culture",
        "foodie"
      ],
      "description": "The feel of the day: chill, adventure, date, family, culture or foodie."
    },
    "budget": {
      "type": "string",
      "enum": [
        "any",
        "free"
      ],
      "description": "Budget: any, or free for free things only."
    },
    "diet": {
      "type": "string",
      "description": "Food needs, comma separated: halal, kosher, vegetarian, vegan, pescatarian, gluten_free, dairy_free, jain. Lunch and dinner then name real places that OpenStreetMap lists for all of them (each meal says which in diet and diet_note). halal=true still works."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "The day to plan, YYYY-MM-DD. Leave it out for today, or tomorrow when it is already past 5pm there (the answer then says tomorrow: true)."
    },
    "seed": {
      "type": "integer",
      "description": "Repeat a spin exactly; each answer includes a spin_again link with a new seed."
    }
  },
  "required": [],
  "additionalProperties": false
}

spinmyday_list_vibes

Spin My Day. The vibes you can ask for. Spin up a full day out (morning, lunch, afternoon, dinner, evening) around the weather and what is open, in a city, near a location, or in a random city.

Parameters

No parameters.

Raw schema

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

cancelmysub_get_cancel_steps

Cancel My Sub. How to cancel one subscription. For requests like "how do I cancel Netflix?", "cancel my Planet Fitness membership", "how do I leave Sky?", "cancel my PureGym", "what's the cheapest way to keep Spotify?", "stop my Audible". Returns the official page, steps, catches and a cheaper option. UK answers add region ("UK") and uk_rules; a US-only service asked about from the UK has region "US only".

Parameters3

service	string	required	The subscription's name in everyday words, up to 80 characters.
renews_on	string	optional	Next renewal or billing date (or next delivery for meal kits), YYYY-MM-DD. Adds cancel_by: the last safe day to cancel using the service's own notice rule, or a day early where it has none, and add_to_calendar: a link to a calendar reminder for that day.
country	string	optional	Two-letter country code. GB (or UK) gives UK pages, UK notice rules and uk_rules; defaults to the caller's country, else US.

Raw schema

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string",
      "description": "The subscription's name in everyday words, up to 80 characters."
    },
    "renews_on": {
      "type": "string",
      "format": "date",
      "description": "Next renewal or billing date (or next delivery for meal kits), YYYY-MM-DD. Adds cancel_by: the last safe day to cancel using the service's own notice rule, or a day early where it has none, and add_to_calendar: a link to a calendar reminder for that day."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) gives UK pages, UK notice rules and uk_rules; defaults to the caller's country, else US."
    }
  },
  "required": [
    "service"
  ],
  "additionalProperties": false
}

cancelmysub_identify_charge

Cancel My Sub. Which subscription is this charge? For requests like "what is this APPLE.COM/BILL charge?", "I see AMZN Digital on my statement", "what is DD *DOORDASH DASHPASS?". Returns the likely service, or for Apple, Amazon, Google and Microsoft the few it could be and where to check, or match: purchase when it looks like a one-off order (marketplace, a ride, a restaurant through a delivery app). Then call get_cancel_steps.

Parameters1

text

string

required

The charge as it appears on the statement, up to 120 characters.

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The charge as it appears on the statement, up to 120 characters."
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false
}

cancelmysub_get_cancel_reminder

Cancel My Sub. Calendar reminder for the last safe day to cancel. Returns a calendar file (.ics) with an all-day event on the cancel-by day, the steps and the official link, with alerts at 9am the day before and 9am on the day. Nothing is stored. get_cancel_steps gives this link as add_to_calendar whenever renews_on is given and the day hasn't passed.

Parameters3

service	string	required	The subscription, as for get_cancel_steps.
renews_on	string	required	Next renewal or billing date, YYYY-MM-DD.
country	string	optional	Two-letter country code. GB (or UK) gives UK pages, UK notice rules and uk_rules; defaults to the caller's country, else US.

Raw schema

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string",
      "description": "The subscription, as for get_cancel_steps."
    },
    "renews_on": {
      "type": "string",
      "format": "date",
      "description": "Next renewal or billing date, YYYY-MM-DD."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) gives UK pages, UK notice rules and uk_rules; defaults to the caller's country, else US."
    }
  },
  "required": [
    "service",
    "renews_on"
  ],
  "additionalProperties": false
}

cancelmysub_list_services

Cancel My Sub. Every subscription Cancel My Sub covers. For requests like "which subscriptions can you help me cancel?" or "what gyms do you know?". Also returns the current status of the FTC click-to-cancel rule and the UK rules (uk_rules)

Parameters2

category	string	optional	Category: streaming, music, membership, gym, news, meal kit, software, app store, dating, wellness, home security, phone and internet, tv and broadband.
country	string	optional	Two-letter country code. GB (or UK) leaves out US-only services; defaults to the caller's country, else US.

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Category: streaming, music, membership, gym, news, meal kit, software, app store, dating, wellness, home security, phone and internet, tv and broadband."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) leaves out US-only services; defaults to the caller's country, else US."
    }
  },
  "required": [],
  "additionalProperties": false
}

lowermybill_get_bill_script

Lower My Bill. A call script to lower a bill. For requests like "help me lower my Comcast bill", "get my BT broadband cheaper", "lower my Council Tax", "script to get a better phone plan", "how do I negotiate my car insurance?", "lower my credit card interest", "I pay for too many streaming services". Give the bill type, the provider, or both. If the provider doesn't sell that bill, provider_note says so and the general script is returned.

Parameters5

bill	string	optional	Bill: internet (or broadband), mobile, tv, streaming, car insurance, home insurance, electricity (or energy, gas), water, credit card, gym or council tax (UK). Up to 60 characters.
provider	string	optional	Company name, for example Comcast, Xfinity, Spectrum, AT&T, Verizon, Frontier, T-Mobile, Cox, Optimum, Mediacom, Astound, DIRECTV, DISH, GEICO, Progressive, State Farm, Allstate, USAA; UK: BT, Sky, Virgin Media, TalkTalk, Vodafone, EE, O2, Three, Plusnet, NOW Broadband, Hyperoptic, British Gas, Octopus, EDF, E.ON Next, OVO, ScottishPower. Up to 60 characters.
state	string	optional	US state name or two-letter code. For electricity, adds the state's energy discount programme where there is one. England, Scotland, Wales, Northern Ireland or UK gives the UK answer.
deal_ends	string	optional	The date the current promotional price, contract or insurance policy ends, YYYY-MM-DD. Adds call_by (about 30 days earlier, on a weekday, or today if that has passed) and add_to_calendar, a link to a calendar reminder with the script.
country	string	optional	Two-letter country code. GB (or UK) gives UK scripts, schemes and complaint routes; otherwise it picks the Amazon store in own_modem (US by default; IE uses amazon.co.uk). Defaults to the caller's country.

Raw schema

{
  "type": "object",
  "properties": {
    "bill": {
      "type": "string",
      "description": "Bill: internet (or broadband), mobile, tv, streaming, car insurance, home insurance, electricity (or energy, gas), water, credit card, gym or council tax (UK). Up to 60 characters."
    },
    "provider": {
      "type": "string",
      "description": "Company name, for example Comcast, Xfinity, Spectrum, AT&T, Verizon, Frontier, T-Mobile, Cox, Optimum, Mediacom, Astound, DIRECTV, DISH, GEICO, Progressive, State Farm, Allstate, USAA; UK: BT, Sky, Virgin Media, TalkTalk, Vodafone, EE, O2, Three, Plusnet, NOW Broadband, Hyperoptic, British Gas, Octopus, EDF, E.ON Next, OVO, ScottishPower. Up to 60 characters."
    },
    "state": {
      "type": "string",
      "description": "US state name or two-letter code. For electricity, adds the state's energy discount programme where there is one. England, Scotland, Wales, Northern Ireland or UK gives the UK answer."
    },
    "deal_ends": {
      "type": "string",
      "format": "date",
      "description": "The date the current promotional price, contract or insurance policy ends, YYYY-MM-DD. Adds call_by (about 30 days earlier, on a weekday, or today if that has passed) and add_to_calendar, a link to a calendar reminder with the script."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) gives UK scripts, schemes and complaint routes; otherwise it picks the Amazon store in own_modem (US by default; IE uses amazon.co.uk). Defaults to the caller's country."
    }
  },
  "required": [],
  "additionalProperties": false
}

lowermybill_get_call_reminder

Lower My Bill. Calendar reminder to call before a deal ends. Returns a calendar file (.ics) with an all-day event about 30 days before the deal ends, holding the full script, offers to ask for and a confirm-in-writing message, with alerts at 9am the day before and on the day. Nothing is stored. get_bill_script gives this link as add_to_calendar when deal_ends is given.

Parameters4

bill	string	optional	Bill type, as for get_bill_script. Give bill, provider or both.
provider	string	optional	Company name, as for get_bill_script.
deal_ends	string	required	The date the current price or policy ends, YYYY-MM-DD.
country	string	optional	Two-letter country code. GB (or UK) gives the UK script when no provider is named. Defaults to the caller's country, else US.

Raw schema

{
  "type": "object",
  "properties": {
    "bill": {
      "type": "string",
      "description": "Bill type, as for get_bill_script. Give bill, provider or both."
    },
    "provider": {
      "type": "string",
      "description": "Company name, as for get_bill_script."
    },
    "deal_ends": {
      "type": "string",
      "format": "date",
      "description": "The date the current price or policy ends, YYYY-MM-DD."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) gives the UK script when no provider is named. Defaults to the caller's country, else US."
    }
  },
  "required": [
    "deal_ends"
  ],
  "additionalProperties": false
}

lowermybill_get_bill_help

Lower My Bill. Official help programmes for a bill. For requests like "is there help paying my internet bill?", "is there a broadband social tariff?", "help with my energy bill in the UK", "help with my electric bill", "cheap internet for low income", "does Xfinity have a low-income plan?". Returns programmes with who qualifies and how to apply.

Parameters3

bill	string	required	Bill: internet, mobile, electricity (or heating, gas), water, tv, streaming, car insurance, home insurance, credit card, council tax (UK), or a provider name. Up to 60 characters.
state	string	optional	US state name or two-letter code. For electricity, adds the state's energy discount programme (California, New York, Ohio, New Jersey, Pennsylvania, Georgia). England, Scotland, Wales, Northern Ireland or UK gives the UK answer.
country	string	optional	Two-letter country code. GB (or UK) gives UK schemes (Ofcom social tariffs, Warm Home Discount, WaterSure, Council Tax Reduction). Defaults to the caller's country, else US.

Raw schema

{
  "type": "object",
  "properties": {
    "bill": {
      "type": "string",
      "description": "Bill: internet, mobile, electricity (or heating, gas), water, tv, streaming, car insurance, home insurance, credit card, council tax (UK), or a provider name. Up to 60 characters."
    },
    "state": {
      "type": "string",
      "description": "US state name or two-letter code. For electricity, adds the state's energy discount programme (California, New York, Ohio, New Jersey, Pennsylvania, Georgia). England, Scotland, Wales, Northern Ireland or UK gives the UK answer."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) gives UK schemes (Ofcom social tariffs, Warm Home Discount, WaterSure, Council Tax Reduction). Defaults to the caller's country, else US."
    }
  },
  "required": [
    "bill"
  ],
  "additionalProperties": false
}

pricedropback_get_store_policy

Price Drop Back. A store's price adjustment and price match policy. For requests like "does Target do price matching?", "does John Lewis refund if the price drops?", "Currys price promise", "what's Best Buy's price adjustment policy?", "will Costco refund the difference?". With an item name it adds links to check today's price.

Parameters3

store	string	required	Store name in everyday words, up to 60 characters.
item	string	optional	Optional item name, up to 100 characters, to link today's prices for it.
country	string	optional	Two-letter country code. GB (or UK) gives the UK policy where the store has one (Apple, Amazon, IKEA) and UK rules; it also picks the price links (US, GB and IE get local Amazon and eBay links). Default from the request.

Raw schema

{
  "type": "object",
  "properties": {
    "store": {
      "type": "string",
      "description": "Store name in everyday words, up to 60 characters."
    },
    "item": {
      "type": "string",
      "description": "Optional item name, up to 100 characters, to link today's prices for it."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) gives the UK policy where the store has one (Apple, Amazon, IKEA) and UK rules; it also picks the price links (US, GB and IE get local Amazon and eBay links). Default from the request."
    }
  },
  "required": [
    "store"
  ],
  "additionalProperties": false
}

pricedropback_check_price_drop_claim

Price Drop Back. Can I get the difference back? For requests like "I bought a TV at Best Buy 9 days ago for $499 and it's $449 now, can I get the difference?". Says whether a claim is likely (likely, likely_if_member, unlikely, check or no_drop), the amount, and the steps. With an item name it adds a Cheapest Price link and Amazon and eBay links to check today's price. Likely claims also get claim_message, ready to paste into the store's chat or email. policy.refund_paid_as flags stores that pay store credit (Newegg)

Parameters7

store	string	required	Store name, up to 60 characters.
days_since_purchase	integer	optional	Days since you bought it (or since delivery), 0 to 400. Give this or purchase_date.
purchase_date	string	optional	The date you bought it, YYYY-MM-DD, instead of days_since_purchase. Adds deadlines: the last day to claim with the store (and in a members' longer window) and Capital One card protection.
paid	number	optional	What you paid, 0 to 100000 (US dollars, or pounds for UK stores).
now	number	optional	Today's price, 0 to 100000 (US dollars, or pounds for UK stores).
item	string	optional	Optional item name, up to 100 characters, to link today's price on Cheapest Price, Amazon and eBay.
country	string	optional	Two-letter country code. GB (or UK) gives the UK policy where the store has one (Apple, Amazon, IKEA) and UK rules; it also picks the price links (US, GB and IE get local Amazon and eBay links). Default from the request.

Raw schema

{
  "type": "object",
  "properties": {
    "store": {
      "type": "string",
      "description": "Store name, up to 60 characters."
    },
    "days_since_purchase": {
      "type": "integer",
      "description": "Days since you bought it (or since delivery), 0 to 400. Give this or purchase_date."
    },
    "purchase_date": {
      "type": "string",
      "format": "date",
      "description": "The date you bought it, YYYY-MM-DD, instead of days_since_purchase. Adds deadlines: the last day to claim with the store (and in a members' longer window) and Capital One card protection."
    },
    "paid": {
      "type": "number",
      "description": "What you paid, 0 to 100000 (US dollars, or pounds for UK stores)."
    },
    "now": {
      "type": "number",
      "description": "Today's price, 0 to 100000 (US dollars, or pounds for UK stores)."
    },
    "item": {
      "type": "string",
      "description": "Optional item name, up to 100 characters, to link today's price on Cheapest Price, Amazon and eBay."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) gives the UK policy where the store has one (Apple, Amazon, IKEA) and UK rules; it also picks the price links (US, GB and IE get local Amazon and eBay links). Default from the request."
    }
  },
  "required": [
    "store"
  ],
  "additionalProperties": false
}

pricedropback_get_claim_reminder

Price Drop Back. Calendar reminder for the last day to claim a price drop. Returns a calendar file (.ics) with an all-day event on the store's last claim day, how to claim and the policy link, with alerts 3 days before and on the day. Nothing is stored. check_price_drop_claim gives this link as add_to_calendar when purchase_date is given and a claim is likely.

Parameters5

store	string	required	Store name.
purchase_date	string	required	The date you bought it, YYYY-MM-DD.
member	boolean	optional	Set to true to use the longer members' window where the store has one (for example My Best Buy Plus or Total).
item	string	optional	Optional item name for the event title, up to 100 characters.
country	string	optional	Two-letter country code. GB (or UK) uses the UK policy where the store has one. Default from the request.

Raw schema

{
  "type": "object",
  "properties": {
    "store": {
      "type": "string",
      "description": "Store name."
    },
    "purchase_date": {
      "type": "string",
      "format": "date",
      "description": "The date you bought it, YYYY-MM-DD."
    },
    "member": {
      "type": "boolean",
      "description": "Set to true to use the longer members' window where the store has one (for example My Best Buy Plus or Total)."
    },
    "item": {
      "type": "string",
      "description": "Optional item name for the event title, up to 100 characters."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) uses the UK policy where the store has one. Default from the request."
    }
  },
  "required": [
    "store",
    "purchase_date"
  ],
  "additionalProperties": false
}

pricedropback_list_stores

Price Drop Back. Every store covered, plus card price protection. For requests like "which stores give you money back if the price drops?" or "does my credit card have price protection?". With country=GB, lists the UK policies.

Parameters1

country

string

optional

Two-letter country code. GB (or UK) lists only stores with a UK policy. Default from the request.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) lists only stores with a UK policy. Default from the request."
    }
  },
  "required": [],
  "additionalProperties": false
}

findmymoney_get_state_search

Find My Money. A state's official unclaimed property search. For requests like "do I have unclaimed money in Ohio?", "how do I find money I'm owed in the UK?", "how do I find unclaimed property in Texas?", "I've lived in Ohio, Texas and California, where do I look?". Returns the official state search link (and a direct search_url), MissingMoney.com, tips, a claim checklist and a scam warning. With several states, the first is at the top level and the rest are in more_states.

Parameters2

state	string	required	State name or two-letter code, DC or Puerto Rico, or UK (England, Scotland, Wales, Northern Ireland, London). Several can be listed with commas or "and" (up to 8). Big city names like NYC also work. Up to 200 characters. Required unless country=GB.
country	string	optional	Two-letter country code. GB (or UK) gives the UK tracing services. Defaults to the caller's country, else US.

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "State name or two-letter code, DC or Puerto Rico, or UK (England, Scotland, Wales, Northern Ireland, London). Several can be listed with commas or \"and\" (up to 8). Big city names like NYC also work. Up to 200 characters. Required unless country=GB."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) gives the UK tracing services. Defaults to the caller's country, else US."
    }
  },
  "required": [
    "state"
  ],
  "additionalProperties": false
}

findmymoney_get_sources

Find My Money. Federal and other official places to look, by type. For requests like "how do I find an old 401k?", "unclaimed tax refund", "lost savings bonds", "money from a failed bank", "FTC refund", "my mum died, did she leave money or life insurance?", "find my old pension" (UK with country=GB), "find my Child Trust Fund". Without a type, returns every source.

Parameters2

type	string	optional	Type: tax, retirement, bonds, banks, investments, refunds, insurance, deceased, wages, courts, tribal or all. Everyday words like 401k, pension, stocks or "my dad died" also work; UK words like HMRC, Premium Bonds or Child Trust Fund give the UK answer.
country	string	optional	Two-letter country code. GB (or UK) gives the UK tracing services. Defaults to the caller's country, else US.

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Type: tax, retirement, bonds, banks, investments, refunds, insurance, deceased, wages, courts, tribal or all. Everyday words like 401k, pension, stocks or \"my dad died\" also work; UK words like HMRC, Premium Bonds or Child Trust Fund give the UK answer."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) gives the UK tracing services. Defaults to the caller's country, else US."
    }
  },
  "required": [],
  "additionalProperties": false
}

supplementcheck_get_supplement

Supplement Check. A supplement's label: amounts per serving, upper limit check, halal status and a buy link. For requests like "what's in Nature Made vitamin D3?", "is Centrum halal?", "how much melatonin is in OLLY Sleep?" or "is this supplement halal?" with a barcode. Give q (brand and product name) or barcode. Returns per-serving amounts, dose_check (each vitamin and mineral compared with the adult upper limit at the most the label suggests per day, with per_day_base amounts), other_checks (melatonin, caffeine, creatine, ashwagandha and similar, including when a blend hides the amount), halal (likely_halal, doubtful, not_halal or depends_on_school, with the ingredients that need a confirmed source), alternatives (other sizes or versions), an Amazon link, and halal_options (links to halal-certified or gelatine-free versions) when the halal answer is not likely_halal. For a general name like "creatine monohydrate" it reads one common label and says so. With country=GB, dose_check uses the NHS guidance where it sets one (upper_limit says NHS guidance). Salt forms such as magnesium glycinate are counted as the mineral they hold (estimated: true), and omega-3 is read from EPA and DHA, total omega-3, or estimated from the fish oil weight.

Parameters4

q	string	optional	Brand and product name, for example Nature Made vitamin D3 2000 IU.
barcode	string	optional	UPC or EAN barcode digits (8 to 14).
id	integer	optional	A label id from the NIH database, for example from alternatives.
country	string	optional	US, GB, IE, CA, AU. GB uses NHS guidance for the dose checks; also picks the buy link site. Default from the request.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Brand and product name, for example Nature Made vitamin D3 2000 IU."
    },
    "barcode": {
      "type": "string",
      "description": "UPC or EAN barcode digits (8 to 14)."
    },
    "id": {
      "type": "integer",
      "description": "A label id from the NIH database, for example from alternatives."
    },
    "country": {
      "type": "string",
      "description": "US, GB, IE, CA, AU. GB uses NHS guidance for the dose checks; also picks the buy link site. Default from the request."
    }
  },
  "required": [],
  "additionalProperties": false
}

supplementcheck_get_nutrient

Supplement Check. What a vitamin, mineral or popular supplement does, how much adults need or studies used, limits, cautions and food sources. For requests like "what does magnesium glycinate do?", "what is vitamin K for?", "how much vitamin D do I need?", "is ashwagandha safe?" or "what is creatine?". Covers vitamins A, B1, B2, B5, B6, B12, C, D, E and K, niacin, folate, biotin, choline, calcium, iron, zinc, magnesium, potassium, selenium, iodine, copper, chromium, manganese, molybdenum, phosphorus, boron and omega-3, and explains common forms. Also covers creatine, melatonin, caffeine, ashwagandha, turmeric, CoQ10, collagen, protein powder, probiotics, psyllium, glucosamine, St John's wort, green tea extract, berberine, L-theanine and elderberry: for these it returns supplement, what_studies_looked_at, studied_amounts, ceiling, cautions and source instead of rda and upper_limit. Links the NIH fact sheet. With country=GB the answer gives the UK amounts and NHS supplement guidance, also in the uk field.

Parameters2

name	string	required	A vitamin, mineral, form or supplement, for example magnesium glycinate or ashwagandha.
country	string	optional	US, GB, IE, CA, AU. GB gives UK (NHS) amounts; also picks the shop link site. Default from the request.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "A vitamin, mineral, form or supplement, for example magnesium glycinate or ashwagandha."
    },
    "country": {
      "type": "string",
      "description": "US, GB, IE, CA, AU. GB gives UK (NHS) amounts; also picks the shop link site. Default from the request."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

supplementcheck_check_dose

Supplement Check. Compare an amount of a vitamin or mineral with the adult RDA and upper limit. For requests like "is 5000 IU of vitamin D too much?", "is 500 mg of magnesium glycinate safe?", "is 10 mg of melatonin a lot?" or "is 300 mg of caffeine too much?". Handles IU, mcg, mg and g, including IU for vitamins A, D and E and DFE for folate. For vitamins and minerals, status is above, at, within or no_upper_limit; when the name is a compound (magnesium glycinate, ferrous sulfate, zinc gluconate) the `compound` field also gives how much of the mineral the compound holds, as US and UK labels list the mineral itself; when only one reading is over the limit, the say line gives both and compared_with.depends_on_label is true. Fish oil, cod liver oil and krill oil amounts are the oil weight, so EPA plus DHA is estimated (amount.epa_dha_estimate_mg). With country=GB the limit is the NHS guidance (compared_with.reference is UK (NHS), with us_upper_limit alongside). For other supplements the answer compares with an official ceiling where one exists (caffeine) or the amounts studies have used, with status above, at, within, above_studied_range, within_studied_range, below_studied_range or no_set_amount, plus cautions. Adult values only, with a note.

Parameters5

nutrient	string	optional	The vitamin, mineral or supplement, for example vitamin D, magnesium or melatonin.
amount	number	optional	The amount taken per day, in the unit given.
unit	string	optional	IU, mcg, mg, g, mcg DFE, or billion (CFU) for probiotics. Defaults to IU for vitamin D amounts of 200 or more, otherwise the usual unit.
q	string	optional	The whole question instead, for example 5000 IU vitamin D.
country	string	optional	Two-letter country code. GB compares with NHS guidance and gives UK amounts. Default from the request.

Raw schema

{
  "type": "object",
  "properties": {
    "nutrient": {
      "type": "string",
      "description": "The vitamin, mineral or supplement, for example vitamin D, magnesium or melatonin."
    },
    "amount": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000000,
      "description": "The amount taken per day, in the unit given."
    },
    "unit": {
      "type": "string",
      "description": "IU, mcg, mg, g, mcg DFE, or billion (CFU) for probiotics. Defaults to IU for vitamin D amounts of 200 or more, otherwise the usual unit."
    },
    "q": {
      "type": "string",
      "description": "The whole question instead, for example 5000 IU vitamin D."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB compares with NHS guidance and gives UK amounts. Default from the request."
    }
  },
  "required": [],
  "additionalProperties": false
}

supplementcheck_check_stack

Supplement Check. Add up everything someone takes and check the daily totals against adult upper limits. For requests like "I take Centrum, vitamin D 5000 IU and zinc 50 mg, is that too much?" or "is it OK to take OLLY Sleep with extra melatonin?". Takes up to 6 items separated by semicolons: product names, barcodes, or amounts like vitamin D 5000 IU. Products are counted at the most each label suggests per day. Returns totals (each vitamin and mineral added up, with the items it comes from, compared with the adult upper limit, or NHS guidance with country=GB), other_totals (caffeine, melatonin and similar added up, or marked when a label hides the amount), items (what each was matched to) and not_found. Fish oil amounts count the EPA and DHA they typically hold.

Parameters2

items	string	required	What the user takes, separated by semicolons, for example Centrum Silver Men; vitamin D 5000 IU; zinc 50 mg.
country	string	optional	Two-letter country code. GB compares totals with NHS guidance. Default from the request.

Raw schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "string",
      "description": "What the user takes, separated by semicolons, for example Centrum Silver Men; vitamin D 5000 IU; zinc 50 mg."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB compares totals with NHS guidance. Default from the request."
    }
  },
  "required": [
    "items"
  ],
  "additionalProperties": false
}

platepal_get_food_nutrition

Plate Pal. Calories and macros for a food, dish or product, for the amount the user says. For requests like "how many calories in a Big Mac?", "protein in 200g chicken breast", "calories in chicken biryani", "a slice of pepperoni pizza", "a large latte" or a whole meal like "2 eggs, 2 slices of toast and a coffee". Takes the whole amount and food in q, or grams or servings separately. Generic foods and dishes (thousands, including fast food and restaurant dishes) use USDA values with real portion weights (slice, cup, small, medium, large, one item); brands come from Open Food Facts. Chain items ("McDonald's large fries", "a Greggs sausage roll", "KFC Zinger burger", "grande latte from Starbucks", "6 inch Italian BMT from Subway", "20 piece McNuggets") use the chain's own published figures for that size, UK or US by country, and return a chain object (name, region, item, size, weight_published); when the chain doesn't publish a weight, amount.grams is null and per_100 values are null. For a chain item not in the table, a typical USDA version is used and the say line says so. A whole meal returns items (each food with its amount and nutrition) and total. Returns nutrition for the amount, per_100 values, portions, UK traffic lights (per 100 g, or per 100 ml for drinks) and caffeine_mg for drinks that have it.

Parameters4

q	string	required	The food or meal, optionally with amounts, for example 200g chicken breast, a large banana, or 2 eggs and a slice of toast.
grams	number	optional	Amount in grams (1 to 5000). Overrides any amount in q.
servings	number	optional	Number of servings or items (0.25 to 20).
country	string	optional	Two-letter country code. Picks UK or US chain figures (GB and IE get UK ones) and prefers local versions of branded products. Default from the request.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "The food or meal, optionally with amounts, for example 200g chicken breast, a large banana, or 2 eggs and a slice of toast."
    },
    "grams": {
      "type": "number",
      "minimum": 1,
      "maximum": 5000,
      "description": "Amount in grams (1 to 5000). Overrides any amount in q."
    },
    "servings": {
      "type": "number",
      "minimum": 0.25,
      "maximum": 20,
      "description": "Number of servings or items (0.25 to 20)."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. Picks UK or US chain figures (GB and IE get UK ones) and prefers local versions of branded products. Default from the request."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

platepal_get_barcode_nutrition

Plate Pal. Nutrition for a packaged product by barcode, with UK traffic lights. For requests like "is this barcode high in sugar?", "how many calories in this?" after a scan, or "what's the salt in 5000157024886?". Returns per 100 g (or 100 ml) and per serving values, traffic lights for fat, saturates, sugars and salt, Nutri-Score, allergens and a Halal or Not? link for checking the ingredients.

Parameters2

code	string	required	Barcode digits (8 to 14).
servings	number	optional	Number of servings to total up (0.25 to 20).

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Barcode digits (8 to 14)."
    },
    "servings": {
      "type": "number",
      "minimum": 0.25,
      "maximum": 20,
      "description": "Number of servings to total up (0.25 to 20)."
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

platepal_get_meal_ideas

Plate Pal. Simple meal ideas by goal, diet and meal, with rough macros. For requests like "give me a high protein halal dinner idea", "a quick vegan lunch", "cheap vegetarian breakfast ideas". Goals: high protein, low carb, budget, quick, high fibre. Diets: vegetarian, vegan, pescatarian, halal. Meals: breakfast, lunch, dinner, snack. The user's words can go in q instead. Ideas rotate daily. It does not set calorie or weight targets; a weight-loss request gets lighter, filling ideas (goal lighter, 450 calories or less) and a pointer to a doctor or dietitian, with no shop links.

Parameters6

goal	string	optional	Goal: high protein, low carb, budget, quick or high fibre.
diet	string	optional	Diet: vegetarian, vegan, pescatarian or halal.
meal	string	optional	Meal: breakfast, lunch, dinner or snack.
q	string	optional	Free text, for example high protein halal dinner.
n	integer	optional	How many ideas, 1 to 8. Default 3.
country	string	optional	Two-letter country code for the shop links (US, GB and IE get local Amazon links). Default from the request.

Raw schema

{
  "type": "object",
  "properties": {
    "goal": {
      "type": "string",
      "description": "Goal: high protein, low carb, budget, quick or high fibre."
    },
    "diet": {
      "type": "string",
      "description": "Diet: vegetarian, vegan, pescatarian or halal."
    },
    "meal": {
      "type": "string",
      "description": "Meal: breakfast, lunch, dinner or snack."
    },
    "q": {
      "type": "string",
      "description": "Free text, for example high protein halal dinner."
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "description": "How many ideas, 1 to 8. Default 3."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code for the shop links (US, GB and IE get local Amazon links). Default from the request."
    }
  },
  "required": [],
  "additionalProperties": false
}

planmyworkout_get_workout_plan

Plan My Workout. A weekly workout plan with sets, reps and rest. For requests like "make me a 3 day beginner gym plan", "home workout with just dumbbells, 30 minutes", "a 5 day muscle building split", "I have a pull-up bar and dumbbells", "a 20 minute workout" (days=1 gives a single session), "a workout plan to lose weight", "couch to 5K" or "a 10K running plan" (a 10K or longer goal gets the build-up plan unless the user says they are a beginner), or "give me another one" (the same inputs with seed plus one). Takes either the fields, or the user's words in q, from which the service reads days, minutes, level, goal and equipment from them. Fields win over q. Running plans also return weeks: every week's sessions (a 9-week walk-run build to 30 minutes of running for beginners; easy, interval, tempo and long runs for intermediates), with week 1 laid out in days.

Parameters8

q	string	optional	The user's request in their own words, for example "3 day beginner gym plan, 45 minutes".
goal	string	optional	Goal: strength, muscle, general (default), conditioning (covers fat loss or weight loss requests), running or mobility.
level	string	optional	Level: beginner (default) or intermediate. Advanced is treated as intermediate.
days	integer	optional	Days per week, 1 to 6 (1 gives a single session). More than 6 (or "every day") is planned as 6 with a rest day, and the answer says so in say and in plan.days_asked and plan.days_note. Default 3.
minutes	integer	optional	Minutes per session including warm-up, 15 to 120. Default 45.
equipment	string	optional	Comma separated: none (default), dumbbells, barbell, gym, bands, kettlebell, pullupbar (a pull-up bar), jumprope.
seed	integer	optional	0 to 9999. Change it for a different mix of exercises with the same setup. Default 0.
country	string	optional	Two-letter country code for kit links (US, GB, IE, CA, AU). Defaults to the visitor's country.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "The user's request in their own words, for example \"3 day beginner gym plan, 45 minutes\"."
    },
    "goal": {
      "type": "string",
      "description": "Goal: strength, muscle, general (default), conditioning (covers fat loss or weight loss requests), running or mobility."
    },
    "level": {
      "type": "string",
      "enum": [
        "beginner",
        "intermediate"
      ],
      "description": "Level: beginner (default) or intermediate. Advanced is treated as intermediate."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7,
      "description": "Days per week, 1 to 6 (1 gives a single session). More than 6 (or \"every day\") is planned as 6 with a rest day, and the answer says so in say and in plan.days_asked and plan.days_note. Default 3."
    },
    "minutes": {
      "type": "integer",
      "minimum": 15,
      "maximum": 120,
      "description": "Minutes per session including warm-up, 15 to 120. Default 45."
    },
    "equipment": {
      "type": "string",
      "description": "Comma separated: none (default), dumbbells, barbell, gym, bands, kettlebell, pullupbar (a pull-up bar), jumprope."
    },
    "seed": {
      "type": "integer",
      "description": "0 to 9999. Change it for a different mix of exercises with the same setup. Default 0."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code for kit links (US, GB, IE, CA, AU). Defaults to the visitor's country."
    }
  },
  "required": [],
  "additionalProperties": false
}

planmyworkout_get_exercise

Plan My Workout. How to do one exercise, the muscles it works and a picture. For requests like "how do I do a Romanian deadlift?", "what is a goblet squat?", "what muscles do face pulls work?". Understands everyday names like RDL, press-up and lat pulldown. muscles.main lists the muscles the move mainly works (hand-checked for the main lifts) and muscles.also the ones that help.

Parameters1

name

string

required

The exercise, for example Romanian deadlift or push-up.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The exercise, for example Romanian deadlift or push-up."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

planmyworkout_list_exercises

Plan My Workout. Exercises for a muscle and the equipment the user has. For requests like "what can I do for chest with no equipment?", "glute exercises with bands", "back exercises with dumbbells", "some mobility moves". Give a muscle, equipment or both.

Parameters4

muscle	string	optional	Muscle: chest, back, shoulders, arms, biceps, triceps, legs, quads, hamstrings, glutes, calves, core (or abs), cardio or mobility. Also forearms (grip) and traps.
equipment	string	optional	Equipment: none, dumbbells, barbell, gym, bands, kettlebell, pullupbar or jumprope.
level	string	optional	Level: beginner leaves out harder moves.
limit	integer	optional	1 to 10. Default 8.

Raw schema

{
  "type": "object",
  "properties": {
    "muscle": {
      "type": "string",
      "description": "Muscle: chest, back, shoulders, arms, biceps, triceps, legs, quads, hamstrings, glutes, calves, core (or abs), cardio or mobility. Also forearms (grip) and traps."
    },
    "equipment": {
      "type": "string",
      "description": "Equipment: none, dumbbells, barbell, gym, bands, kettlebell, pullupbar or jumprope."
    },
    "level": {
      "type": "string",
      "enum": [
        "beginner",
        "intermediate"
      ],
      "description": "Level: beginner leaves out harder moves."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "1 to 10. Default 8."
    }
  },
  "required": [],
  "additionalProperties": false
}

medbillcheck_check_price

Med Bill Check. Compare a charge with Medicare's rate for one service. For when someone asks whether a charge is high or what Medicare pays, for example "I was charged $450 for a 99213 office visit in Texas, is that too high?" or "what does Medicare pay for an MRI of the knee?". Takes the billing code if they have it, otherwise the service in plain words as q. Returns Medicare's 2026 rate for the state (or the city's own pricing area when city is given) in medicare_2026, the amount providers typically billed in 2024, and how many times the Medicare rate the charge is. For care in a hospital, hospital_facility_2026 gives Medicare's national rate for the hospital's own facility fee and comparison.compared_with says what the charge was set against. Dental work has no Medicare rate and returns 404 with a pointer to a free dental cost source.

Parameters7

code	string	optional	Five-character CPT or HCPCS code from the bill, like 99213, 73721 or G0121.
q	string	optional	The service in plain words, used when there is no code, like "knee MRI" or "ER visit".
state	string	optional	US state name or two-letter code, like Texas or TX. Med Bill Check is for US bills; a UK place gets a short answer pointing to UK sources.
charged	number	optional	The amount on the bill in US dollars, like 450.
setting	string	optional	Setting: office (clinic, office, imaging center) or facility (hospital or surgery center). Leave out to use the usual setting.
city	string	optional	City, for states where Medicare pays big cities differently, like Houston, Chicago, Miami or Los Angeles. Other places use the rest-of-state rate.
billed_by	string	optional	Whose bill the charge is on when the service was in a hospital: hospital (the hospital's own facility charge) or doctor (the doctor's or physician group's bill). Leave out if not known: the charge is then compared with both together.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Five-character CPT or HCPCS code from the bill, like 99213, 73721 or G0121."
    },
    "q": {
      "type": "string",
      "description": "The service in plain words, used when there is no code, like \"knee MRI\" or \"ER visit\"."
    },
    "state": {
      "type": "string",
      "description": "US state name or two-letter code, like Texas or TX. Med Bill Check is for US bills; a UK place gets a short answer pointing to UK sources."
    },
    "charged": {
      "type": "number",
      "minimum": 1,
      "maximum": 5000000,
      "description": "The amount on the bill in US dollars, like 450."
    },
    "setting": {
      "type": "string",
      "enum": [
        "office",
        "facility"
      ],
      "description": "Setting: office (clinic, office, imaging center) or facility (hospital or surgery center). Leave out to use the usual setting."
    },
    "city": {
      "type": "string",
      "description": "City, for states where Medicare pays big cities differently, like Houston, Chicago, Miami or Los Angeles. Other places use the rest-of-state rate."
    },
    "billed_by": {
      "type": "string",
      "enum": [
        "hospital",
        "doctor"
      ],
      "description": "Whose bill the charge is on when the service was in a hospital: hospital (the hospital's own facility charge) or doctor (the doctor's or physician group's bill). Leave out if not known: the charge is then compared with both together."
    }
  },
  "required": [],
  "additionalProperties": false
}

medbillcheck_search_services

Med Bill Check. Find billing codes and Medicare rates by plain words. For when someone describes a service but has no code, or asks what a code means, for example "what's the code for a colonoscopy?", "how much does Medicare pay for a chest x-ray in Ohio?" or "what is code 99214?". Returns up to eight matching codes with Medicare's typical allowed and billed amounts.

Parameters2

q	string	required	Plain words or a code, like "hernia repair" or 99214.
state	string	optional	US state name or two-letter code.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Plain words or a code, like \"hernia repair\" or 99214."
    },
    "state": {
      "type": "string",
      "description": "US state name or two-letter code."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

medbillcheck_check_whole_bill

Med Bill Check. Check several lines of an itemized bill at once. For when someone reads out or pastes several lines from an itemized bill, for example "my ER bill has 99284 for $2,500, 85025 twice for $120 and 36415 three times, does anything look off?". Takes the lines as code, optional x and units, then the amount. Returns each line against Medicare's rate, totals, and questions_to_ask: repeated codes, units above Medicare's automated daily limit, the highest visit levels, hospital clinic facility fees and charges far above what providers typically bill. Lines of a hospital bill (any bill with an ER visit on it, or setting=facility) are compared with Medicare's hospital outpatient rate plus the doctor's part; each such line says compared_with.

Parameters5

lines	string	required	Up to 15 bill lines separated by commas: code, then x and units if more than one, then the amount. Example: 99284:2500, 85025x2:120, 36415:45.
state	string	optional	US state name or two-letter code.
city	string	optional	City, for big cities with their own Medicare rates.
setting	string	optional	Setting: office or facility. Leave out if not known.
billed_by	string	optional	Whose bill the charge is on when the service was in a hospital: hospital (the hospital's own facility charge) or doctor (the doctor's or physician group's bill). Leave out if not known: the charge is then compared with both together.

Raw schema

{
  "type": "object",
  "properties": {
    "lines": {
      "type": "string",
      "description": "Up to 15 bill lines separated by commas: code, then x and units if more than one, then the amount. Example: 99284:2500, 85025x2:120, 36415:45."
    },
    "state": {
      "type": "string",
      "description": "US state name or two-letter code."
    },
    "city": {
      "type": "string",
      "description": "City, for big cities with their own Medicare rates."
    },
    "setting": {
      "type": "string",
      "enum": [
        "office",
        "facility"
      ],
      "description": "Setting: office or facility. Leave out if not known."
    },
    "billed_by": {
      "type": "string",
      "enum": [
        "hospital",
        "doctor"
      ],
      "description": "Whose bill the charge is on when the service was in a hospital: hospital (the hospital's own facility charge) or doctor (the doctor's or physician group's bill). Leave out if not known: the charge is then compared with both together."
    }
  },
  "required": [
    "lines"
  ],
  "additionalProperties": false
}

medbillcheck_look_up_hospital

Med Bill Check. Whether a hospital is nonprofit, for financial assistance. For requests like "is St. Luke's in Boise a nonprofit?" or "does this hospital have to offer charity care?". Returns how Medicare lists the hospital's ownership (nonprofit, government, for-profit), its city and main phone number, and what that means for financial assistance. Nonprofit hospitals must have a financial assistance policy.

Parameters3

name	string	required	Hospital name as on the bill, like St. Luke's Regional Medical Center.
state	string	optional	US state name or two-letter code. Recommended, since many hospitals share names.
city	string	optional	City, to pick between hospitals with the same name.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Hospital name as on the bill, like St. Luke's Regional Medical Center."
    },
    "state": {
      "type": "string",
      "description": "US state name or two-letter code. Recommended, since many hospitals share names."
    },
    "city": {
      "type": "string",
      "description": "City, to pick between hospitals with the same name."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

medbillcheck_draft_bill_letter

Med Bill Check. Draft a letter to a billing office for the user to send. For requests like "help me dispute this bill", "write a letter asking for an itemized bill", "can I ask for a discount?" or "how do I apply for charity care?". Returns a letter as plain text with [brackets] for anything not given, tips, and the user's No Surprises Act and Good Faith Estimate rights with official CMS links. It never sends anything.

Parameters13

type	string	required	Type: itemized (ask for an itemized bill), dispute (ask for a charge to be reviewed), discount (prompt-pay or self-pay discount), or assistance (financial assistance or charity care).
name	string	optional	Patient or account holder name.
provider	string	optional	Hospital, clinic or provider name.
account	string	optional	Account or invoice number on the bill.
date	string	optional	Date of service.
service	string	optional	The service in plain words.
code	string	optional	Billing code of the charge. With amount, a dispute letter adds Medicare's benchmark (for a hospital charge, the hospital outpatient rate as well as the doctor's part).
amount	number	optional	Amount charged or balance due, in US dollars.
state	string	optional	US state, used for the benchmark in a dispute letter.
reason	string	optional	A sentence on what the user wants checked, for a dispute letter.
insured	string	optional	Set to no if paying without insurance (self-pay), for a discount letter.
setting	string	optional	Setting: office or facility (hospital or surgery center), for the benchmark in a dispute letter. ER visits and hospital clinic visits count as facility anyway.
billed_by	string	optional	Whose bill the charge is on when the service was in a hospital: hospital (the hospital's own facility charge) or doctor (the doctor's or physician group's bill). Leave out if not known: the charge is then compared with both together.

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "itemized",
        "dispute",
        "discount",
        "assistance"
      ],
      "description": "Type: itemized (ask for an itemized bill), dispute (ask for a charge to be reviewed), discount (prompt-pay or self-pay discount), or assistance (financial assistance or charity care)."
    },
    "name": {
      "type": "string",
      "description": "Patient or account holder name."
    },
    "provider": {
      "type": "string",
      "description": "Hospital, clinic or provider name."
    },
    "account": {
      "type": "string",
      "description": "Account or invoice number on the bill."
    },
    "date": {
      "type": "string",
      "description": "Date of service."
    },
    "service": {
      "type": "string",
      "description": "The service in plain words."
    },
    "code": {
      "type": "string",
      "description": "Billing code of the charge. With amount, a dispute letter adds Medicare's benchmark (for a hospital charge, the hospital outpatient rate as well as the doctor's part)."
    },
    "amount": {
      "type": "number",
      "minimum": 1,
      "maximum": 5000000,
      "description": "Amount charged or balance due, in US dollars."
    },
    "state": {
      "type": "string",
      "description": "US state, used for the benchmark in a dispute letter."
    },
    "reason": {
      "type": "string",
      "description": "A sentence on what the user wants checked, for a dispute letter."
    },
    "insured": {
      "type": "string",
      "enum": [
        "yes",
        "no"
      ],
      "description": "Set to no if paying without insurance (self-pay), for a discount letter."
    },
    "setting": {
      "type": "string",
      "enum": [
        "office",
        "facility"
      ],
      "description": "Setting: office or facility (hospital or surgery center), for the benchmark in a dispute letter. ER visits and hospital clinic visits count as facility anyway."
    },
    "billed_by": {
      "type": "string",
      "enum": [
        "hospital",
        "doctor"
      ],
      "description": "Whose bill the charge is on when the service was in a hospital: hospital (the hospital's own facility charge) or doctor (the doctor's or physician group's bill). Leave out if not known: the charge is then compared with both together."
    }
  },
  "required": [
    "type"
  ],
  "additionalProperties": false
}

appealmyclaim_get_appeal_rights

Appeal My Claim. Appeal rights, steps and free help for a plan type and state. For requests like "what are my appeal rights in California?", "my insurer denied my claim, what can I do?" or "how do Medicare appeals work?". Returns who decides, the steps (internal appeal, external review, Medicare levels or Medicaid fair hearing), deadlines, and where to get free help, including the state insurance department. If the plan type is not known, leave it out to get the rules for most private plans.

Parameters2

state	string	optional	US state name or two-letter code, like California or CA. Puerto Rico works too.
plan_type	string	optional	Plan type: marketplace, employer, employer_insured, employer_self_funded, medicare, medicare_advantage, part_d or medicaid. Everyday words work too, like "job", "Obamacare" or "Medi-Cal". Default: most private plans.

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "US state name or two-letter code, like California or CA. Puerto Rico works too."
    },
    "plan_type": {
      "type": "string",
      "description": "Plan type: marketplace, employer, employer_insured, employer_self_funded, medicare, medicare_advantage, part_d or medicaid. Everyday words work too, like \"job\", \"Obamacare\" or \"Medi-Cal\". Default: most private plans."
    }
  },
  "required": [],
  "additionalProperties": false
}

appealmyclaim_get_appeal_deadlines

Appeal My Claim. How long someone has to appeal, and how fast the plan must decide. For requests like "how long do I have to appeal?", "when is my appeal due?" or "how fast does my insurer have to answer?". With the date on the denial notice, gives an approximate file-by date. The date on the user's own notice is the one that counts.

Parameters3

plan_type	string	optional	Same values as plan_type in get_appeal_rights. Default: most private plans.
denial_date	string	optional	Date on the denial notice, like 2026-09-01, 09/01/2026 or September 1, 2026.
urgent	string	optional	Set to yes if waiting could seriously harm the person's health.

Raw schema

{
  "type": "object",
  "properties": {
    "plan_type": {
      "type": "string",
      "description": "Same values as plan_type in get_appeal_rights. Default: most private plans."
    },
    "denial_date": {
      "type": "string",
      "description": "Date on the denial notice, like 2026-09-01, 09/01/2026 or September 1, 2026."
    },
    "urgent": {
      "type": "string",
      "enum": [
        "yes",
        "no"
      ],
      "description": "Set to yes if waiting could seriously harm the person's health."
    }
  },
  "required": [],
  "additionalProperties": false
}

appealmyclaim_explain_denial_code

Appeal My Claim. Explain the denial codes on an Explanation of Benefits. For requests like "my EOB says CO-50, what does that mean?", "what is denial code PR 204?" or "what does N130 mean?". Returns each code in plain words, who usually fixes it (the provider's billing office, an appeal, or the user), whether the provider can bill the user for it (from the group code CO, PR, OA or PI), and a letter link when an appeal fits.

Parameters2

code	string	required	One to four codes from the notice, like CO-50, PR 204, 197 or N130.
plan_type	string	optional	Same values as plan_type in get_appeal_rights. Carried into the letter link.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "One to four codes from the notice, like CO-50, PR 204, 197 or N130."
    },
    "plan_type": {
      "type": "string",
      "description": "Same values as plan_type in get_appeal_rights. Carried into the letter link."
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

appealmyclaim_draft_appeal_letter

Appeal My Claim. Draft an appeal letter for the user to review and send. For requests like "my insurer denied my MRI as not medically necessary, help me appeal" or "write an appeal letter for an out-of-network denial". Returns a letter as plain text with [brackets] for anything not given, a checklist of what to attach (denial notice, doctor's letter of medical necessity, records), and tips. It never sends or files anything.

Parameters14

reason	string	optional	Why the claim was denied: medical_necessity, emergency (said it wasn't an emergency), experimental, out_of_network, prior_auth, coding or generic. Required unless denial_code is given.
denial_code	string	optional	The reason code on the notice, like CO-50 or PR-197. Picks the reason when reason is left out, and is quoted in the letter.
plan_type	string	optional	Same values as plan_type in get_appeal_rights. Changes the wording for Medicare.
name	string	optional	Member's name.
plan	string	optional	Insurer or plan name.
member_id	string	optional	Member ID or Medicare number.
claim	string	optional	Claim or reference number.
service	string	optional	The care that was denied, like "MRI of the right knee".
date	string	optional	Date of service.
denial_date	string	optional	Date on the denial notice.
doctor	string	optional	Treating doctor's name.
provider	string	optional	Hospital, clinic or provider name.
details	string	optional	A sentence or two in the user's words on why the care should be covered.
urgent	string	optional	Set to yes to ask for an expedited review.

Raw schema

{
  "type": "object",
  "properties": {
    "reason": {
      "type": "string",
      "enum": [
        "medical_necessity",
        "emergency",
        "experimental",
        "out_of_network",
        "prior_auth",
        "coding",
        "generic"
      ],
      "description": "Why the claim was denied: medical_necessity, emergency (said it wasn't an emergency), experimental, out_of_network, prior_auth, coding or generic. Required unless denial_code is given."
    },
    "denial_code": {
      "type": "string",
      "description": "The reason code on the notice, like CO-50 or PR-197. Picks the reason when reason is left out, and is quoted in the letter."
    },
    "plan_type": {
      "type": "string",
      "description": "Same values as plan_type in get_appeal_rights. Changes the wording for Medicare."
    },
    "name": {
      "type": "string",
      "description": "Member's name."
    },
    "plan": {
      "type": "string",
      "description": "Insurer or plan name."
    },
    "member_id": {
      "type": "string",
      "description": "Member ID or Medicare number."
    },
    "claim": {
      "type": "string",
      "description": "Claim or reference number."
    },
    "service": {
      "type": "string",
      "description": "The care that was denied, like \"MRI of the right knee\"."
    },
    "date": {
      "type": "string",
      "description": "Date of service."
    },
    "denial_date": {
      "type": "string",
      "description": "Date on the denial notice."
    },
    "doctor": {
      "type": "string",
      "description": "Treating doctor's name."
    },
    "provider": {
      "type": "string",
      "description": "Hospital, clinic or provider name."
    },
    "details": {
      "type": "string",
      "description": "A sentence or two in the user's words on why the care should be covered."
    },
    "urgent": {
      "type": "string",
      "enum": [
        "yes",
        "no"
      ],
      "description": "Set to yes to ask for an expedited review."
    }
  },
  "required": [],
  "additionalProperties": false
}

jobspotter_search_jobs

Job Spotter. Search current job listings. For requests like "find remote Python jobs", "marketing jobs in New York", "junior data analyst jobs posted this week", "senior software engineer jobs in London", "nurse jobs in Manchester". Job words go in what and the place in where. Everyday phrasing in what also works: level words (junior, senior), "remote", "in <city>" and "this week" are picked out. The say line credits listings from Remotive, Himalayas, Jobicy and Remote OK to their source.

Parameters21

what	string	optional	Job title, skill or field, for example "python developer" or "marketing". Required unless where is given.
where	string	optional	A city (New York, Austin, TX, London, Birmingham, UK), a US state (Texas), a UK county or region (Kent, Yorkshire), a UK postcode, a city or country abroad (Bangalore, Dublin, Dubai, Sydney, India), a country (USA, UK, Germany), "remote", or remote in a country ("remote US").
country	string	optional	US or UK, when the place exists in both (Birmingham, Manchester, Cambridge) and the user's country is known. Optional.
level	string	optional	Level: entry (junior, graduate, intern), mid or senior. With entry, jobs asking for more than 2 years of experience are left out and the answer adds apprenticeship and graduate routes.
posted_within_days	integer	optional	Only jobs posted in the last N days, 1 to 90. Default 30. 7 means this week.
limit	integer	optional	How many results, 1 to 10. Default 10.
page	integer	optional	Which page of results, 1 to 20. Default 1. Use 2 for "show me more".
sort	string	optional	Sort: relevance (default), date (newest first) or pay (highest first).
salary_min	string	optional	Lowest yearly pay, in the local currency, for example 40000 or 40k. Jobs that list no pay are left out when set.
salary_max	string	optional	Highest yearly pay, in the local currency.
work_type	string	optional	Work type: remote, hybrid or on-site.
job_type	string	optional	Job type: full time, part time, contract, temporary or internship.
radius_miles	integer	optional	How far from the place, in miles, 1 to 100 (boards that support distance).
visa_sponsorship	string	optional	Set to yes for jobs whose advert says visa sponsorship is offered.
shift	string	optional	Shift: day, evening, night, weekend or flexible.
education	string	optional	Education: degree for jobs asking for a degree, or no degree for jobs that don't.
employer	string	optional	Employer: direct for jobs posted by the employer itself, or agency for recruitment agencies.
include	string	optional	Words the advert must contain, comma separated, for example "python, aws".
exclude	string	optional	Words the advert must not contain, comma separated, for example "sales, commission".
benefits	string	optional	Benefits the advert must mention, comma separated, for example "pension, private healthcare".
company	string	optional	Only jobs at this company, for example "Tesco".

Raw schema

{
  "type": "object",
  "properties": {
    "what": {
      "type": "string",
      "description": "Job title, skill or field, for example \"python developer\" or \"marketing\". Required unless where is given."
    },
    "where": {
      "type": "string",
      "description": "A city (New York, Austin, TX, London, Birmingham, UK), a US state (Texas), a UK county or region (Kent, Yorkshire), a UK postcode, a city or country abroad (Bangalore, Dublin, Dubai, Sydney, India), a country (USA, UK, Germany), \"remote\", or remote in a country (\"remote US\")."
    },
    "country": {
      "type": "string",
      "enum": [
        "US",
        "UK"
      ],
      "description": "US or UK, when the place exists in both (Birmingham, Manchester, Cambridge) and the user's country is known. Optional."
    },
    "level": {
      "type": "string",
      "enum": [
        "entry",
        "mid",
        "senior"
      ],
      "description": "Level: entry (junior, graduate, intern), mid or senior. With entry, jobs asking for more than 2 years of experience are left out and the answer adds apprenticeship and graduate routes."
    },
    "posted_within_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90,
      "description": "Only jobs posted in the last N days, 1 to 90. Default 30. 7 means this week."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many results, 1 to 10. Default 10."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Which page of results, 1 to 20. Default 1. Use 2 for \"show me more\"."
    },
    "sort": {
      "type": "string",
      "enum": [
        "relevance",
        "date",
        "pay"
      ],
      "description": "Sort: relevance (default), date (newest first) or pay (highest first)."
    },
    "salary_min": {
      "type": "string",
      "description": "Lowest yearly pay, in the local currency, for example 40000 or 40k. Jobs that list no pay are left out when set."
    },
    "salary_max": {
      "type": "string",
      "description": "Highest yearly pay, in the local currency."
    },
    "work_type": {
      "type": "string",
      "enum": [
        "remote",
        "hybrid",
        "on-site"
      ],
      "description": "Work type: remote, hybrid or on-site."
    },
    "job_type": {
      "type": "string",
      "enum": [
        "full time",
        "part time",
        "contract",
        "temporary",
        "internship"
      ],
      "description": "Job type: full time, part time, contract, temporary or internship."
    },
    "radius_miles": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "How far from the place, in miles, 1 to 100 (boards that support distance)."
    },
    "visa_sponsorship": {
      "type": "string",
      "enum": [
        "yes"
      ],
      "description": "Set to yes for jobs whose advert says visa sponsorship is offered."
    },
    "shift": {
      "type": "string",
      "enum": [
        "day",
        "evening",
        "night",
        "weekend",
        "flexible"
      ],
      "description": "Shift: day, evening, night, weekend or flexible."
    },
    "education": {
      "type": "string",
      "enum": [
        "degree",
        "no degree"
      ],
      "description": "Education: degree for jobs asking for a degree, or no degree for jobs that don't."
    },
    "employer": {
      "type": "string",
      "enum": [
        "direct",
        "agency"
      ],
      "description": "Employer: direct for jobs posted by the employer itself, or agency for recruitment agencies."
    },
    "include": {
      "type": "string",
      "description": "Words the advert must contain, comma separated, for example \"python, aws\"."
    },
    "exclude": {
      "type": "string",
      "description": "Words the advert must not contain, comma separated, for example \"sales, commission\"."
    },
    "benefits": {
      "type": "string",
      "description": "Benefits the advert must mention, comma separated, for example \"pension, private healthcare\"."
    },
    "company": {
      "type": "string",
      "description": "Only jobs at this company, for example \"Tesco\"."
    }
  },
  "required": [],
  "additionalProperties": false
}

jobspotter_get_job

Job Spotter. Details for one job from a search result. For when the user asks about one of the results, for example "tell me more about the second one" or "what's the apply link for the Uber job?". Takes the id from a search_jobs result exactly as given; ids carry what is needed, so they keep working later. NHS Jobs and Teaching Vacancies results include the closing date.

Parameters1

string

required

The id from a search_jobs result, copied exactly, for example muse-22049500, remotive-2091141 or nhsjobs-C9413-26-0725. Some ids are longer, with a ~ and a code after it.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The id from a search_jobs result, copied exactly, for example muse-22049500, remotive-2091141 or nhsjobs-C9413-26-0725. Some ids are longer, with a ~ and a code after it."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

jobspotter_check_salary

Job Spotter. What a job pays in a place. For "what does a nurse earn in Birmingham", "average salary for a data analyst in Austin", "is £35k good for a junior developer in London". Gives the typical yearly range (middle half of current adverts), the middle figure and the average advertised, from current job adverts. Advertised pay, not offers.

Parameters3

what	string	required	Job title or field, for example "nurse" or "software engineer".
where	string	optional	A city, region, postcode or country, for example Birmingham, Austin, TX or remote.
country	string	optional	US or UK when the place exists in both, or a country by name.

Raw schema

{
  "type": "object",
  "properties": {
    "what": {
      "type": "string",
      "description": "Job title or field, for example \"nurse\" or \"software engineer\"."
    },
    "where": {
      "type": "string",
      "description": "A city, region, postcode or country, for example Birmingham, Austin, TX or remote."
    },
    "country": {
      "type": "string",
      "description": "US or UK when the place exists in both, or a country by name."
    }
  },
  "required": [
    "what"
  ],
  "additionalProperties": false
}

jobspotter_similar_jobs

Job Spotter. Jobs like one from a search result. For "show me more like the second one" or "anything similar to that Tesco job?". Takes the id from a search result exactly as given. Returns jobs with a similar title in the same place, without the job itself.

Parameters2

id	string	required	The id from a search result, copied exactly.
limit	integer	optional	How many results, 1 to 10. Default 10.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The id from a search result, copied exactly."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many results, 1 to 10. Default 10."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

jobspotter_whats_hiring

Job Spotter. What's hiring most in a place. For "who's hiring in Leeds?", "what jobs are in demand in Austin?", "which companies are hiring nurses in Manchester?". Gives the roles advertised most and the employers with the most open jobs.

Parameters3

where	string	required	A city, region, postcode or country, for example Birmingham, Austin, TX or remote.
what	string	optional	Optional field to narrow it, for example "nurse" or "engineering".
country	string	optional	US or UK when the place exists in both, or a country by name.

Raw schema

{
  "type": "object",
  "properties": {
    "where": {
      "type": "string",
      "description": "A city, region, postcode or country, for example Birmingham, Austin, TX or remote."
    },
    "what": {
      "type": "string",
      "description": "Optional field to narrow it, for example \"nurse\" or \"engineering\"."
    },
    "country": {
      "type": "string",
      "description": "US or UK when the place exists in both, or a country by name."
    }
  },
  "required": [
    "where"
  ],
  "additionalProperties": false
}

jobspotter_hiring_posts

Job Spotter. Posts from people saying they're hiring. For "who's posting that they're hiring React developers?", "any startups hiring remote designers?". Public posts from people saying they're hiring, from Hacker News (the monthly Who is hiring? thread), Mastodon and Bluesky, newest first, each with a link to the post. The person posting is often the hiring manager. Also gives a ready search link for X.

Parameters3

what	string	optional	Job title or field, for example "nurse" or "software engineer".
where	string	optional	A city, region, postcode or country, for example Birmingham, Austin, TX or remote.
limit	integer	optional	How many posts, 1 to 20. Default 10.

Raw schema

{
  "type": "object",
  "properties": {
    "what": {
      "type": "string",
      "description": "Job title or field, for example \"nurse\" or \"software engineer\"."
    },
    "where": {
      "type": "string",
      "description": "A city, region, postcode or country, for example Birmingham, Austin, TX or remote."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "How many posts, 1 to 20. Default 10."
    }
  },
  "required": [],
  "additionalProperties": false
}

jobspotter_company_lookup

Job Spotter. Facts about an employer and its hiring. For "tell me about Monzo as an employer", "is Tesco hiring?", "how big is this company?". Gives what the company does, when it was founded, staff numbers, headquarters and website (from Wikidata), UK company records when available (Companies House, Open Government Licence), how many jobs it has open now with examples, and ready searches for people there. Staff reviews are not included. For US employers it adds what they offered on US work visa filings.

Parameters2

name	string	required	The company name, for example "Monzo" or "Tesco".
where	string	optional	Optional place to narrow its open jobs, for example London.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The company name, for example \"Monzo\" or \"Tesco\"."
    },
    "where": {
      "type": "string",
      "description": "Optional place to narrow its open jobs, for example London."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

jobspotter_compare_jobs

Job Spotter. Compare jobs side by side. For "compare the first three", "which of these pays best?". Takes two to five ids from search results and gives each job's pay (and yearly equivalent), work type, job type, how new it is, direct employer or agency, visa sponsorship and ghost-job check, plus which is best on pay, newest and remote.

Parameters1

ids

string

required

Two to five job ids from search results, comma separated, copied exactly.

Raw schema

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "string",
      "description": "Two to five job ids from search results, comma separated, copied exactly."
    }
  },
  "required": [
    "ids"
  ],
  "additionalProperties": false
}

jobspotter_check_job_link

Job Spotter. Check a job link someone pastes. For "is this job real?", "what does this one pay?" with a link. Reads the advert from the employer's job board (Greenhouse, Lever, SmartRecruiters, Ashby and most career pages) and gives the title, company, place, pay, when it was posted, whether it looks like a live, open job, visa sponsorship and a short summary. LinkedIn, Indeed and Glassdoor pages can't be read; the advert text can be pasted into the CV match instead.

Parameters1

url

string

required

The full link to the job advert.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The full link to the job advert."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

jobspotter_interview_prep

Job Spotter. Interview questions and practice. For "help me prepare for my interview", "what will they ask a staff nurse?", "do a mock interview". Gives likely role questions, questions drawn from the advert, behavioural questions, good questions to ask them, tips for one-way video and AI interviews, and an order for a practice interview with timings. Takes a job id from a search, or the role and company.

Parameters3

id	string	optional	A job id from a search result, copied exactly. Optional if what is given.
what	string	optional	The role, for example "staff nurse" or "data analyst".
company	string	optional	The company, for example "NHS" or "Monzo".

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A job id from a search result, copied exactly. Optional if what is given."
    },
    "what": {
      "type": "string",
      "description": "The role, for example \"staff nurse\" or \"data analyst\"."
    },
    "company": {
      "type": "string",
      "description": "The company, for example \"NHS\" or \"Monzo\"."
    }
  },
  "required": [],
  "additionalProperties": false
}

jobspotter_find_people

Job Spotter. People worth contacting at a company. For "who should I contact at Monzo about data jobs?", "find the hiring manager". Gives the people who posted the company's hiring ads publicly (they asked applicants to get in touch) and ready LinkedIn and Google searches that open the person's own connections there, its recruiters, likely hiring managers for the role, people in the role (for a referral) and alumni of a school. Nothing is read from LinkedIn and nothing is gathered about anyone.

Parameters4

company	string	required	The company, for example "Monzo".
role	string	optional	The role, for example "data analyst".
where	string	optional	The city, for example London.
school	string	optional	A university or school to look for alumni from.

Raw schema

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "The company, for example \"Monzo\"."
    },
    "role": {
      "type": "string",
      "description": "The role, for example \"data analyst\"."
    },
    "where": {
      "type": "string",
      "description": "The city, for example London."
    },
    "school": {
      "type": "string",
      "description": "A university or school to look for alumni from."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

jobspotter_match_cv

Job Spotter. How well a CV matches a job. For "how well do I match this job?", "should I apply?", "what's missing from my CV for this?". Scores a CV or profile against a job from a search (or pasted advert) out of 100, the same way every time: skills 45, role 20, experience 15, education 10, place 10. Gives matched and missing skills, strengths, gaps and keywords to add if true. Nothing sent is stored. The score is a fixed formula, not an AI judgement; the person decides what to apply for.

Parameters10

cv	string	optional	The CV as plain text. Optional if titles and skills are given.
titles	string	optional	Current and past job titles, comma separated.
skills	string	optional	Skills, comma separated.
years_experience	number	optional	Years of work experience.
education	string	optional	Highest qualification, for example "BSc Economics".
schools	string	optional	Universities or schools, comma separated.
employers	string	optional	Current and past employers, comma separated.
location	string	optional	Where the person lives or wants to work.
id	string	optional	A job id from a search result, copied exactly. Or give job_text.
job_text	string	optional	The job advert as plain text, when there is no id.

Raw schema

{
  "type": "object",
  "properties": {
    "cv": {
      "type": "string",
      "description": "The CV as plain text. Optional if titles and skills are given."
    },
    "titles": {
      "type": "string",
      "description": "Current and past job titles, comma separated."
    },
    "skills": {
      "type": "string",
      "description": "Skills, comma separated."
    },
    "years_experience": {
      "type": "number",
      "description": "Years of work experience."
    },
    "education": {
      "type": "string",
      "description": "Highest qualification, for example \"BSc Economics\"."
    },
    "schools": {
      "type": "string",
      "description": "Universities or schools, comma separated."
    },
    "employers": {
      "type": "string",
      "description": "Current and past employers, comma separated."
    },
    "location": {
      "type": "string",
      "description": "Where the person lives or wants to work."
    },
    "id": {
      "type": "string",
      "description": "A job id from a search result, copied exactly. Or give job_text."
    },
    "job_text": {
      "type": "string",
      "description": "The job advert as plain text, when there is no id."
    }
  },
  "required": [],
  "additionalProperties": false
}

jobspotter_jobs_for_me

Job Spotter. The best current jobs for a CV. For "find jobs that fit my CV", "what jobs should I apply for?". Searches current jobs for the person's target roles (or past titles) and place, and ranks them by match score, with matched and missing skills for each. Nothing sent is stored. The score is a fixed formula, not an AI judgement; the person decides what to apply for.

Parameters11

cv	string	optional	The CV as plain text. Optional if titles and skills are given.
titles	string	optional	Current and past job titles, comma separated.
skills	string	optional	Skills, comma separated.
years_experience	number	optional	Years of work experience.
education	string	optional	Highest qualification, for example "BSc Economics".
schools	string	optional	Universities or schools, comma separated.
employers	string	optional	Current and past employers, comma separated.
location	string	optional	Where the person lives or wants to work.
target_roles	string	optional	Roles to look for, comma separated. Defaults to the CV's titles.
where	string	optional	Where to look, for example London or remote.
limit	integer	optional	How many jobs, 1 to 10.

Raw schema

{
  "type": "object",
  "properties": {
    "cv": {
      "type": "string",
      "description": "The CV as plain text. Optional if titles and skills are given."
    },
    "titles": {
      "type": "string",
      "description": "Current and past job titles, comma separated."
    },
    "skills": {
      "type": "string",
      "description": "Skills, comma separated."
    },
    "years_experience": {
      "type": "number",
      "description": "Years of work experience."
    },
    "education": {
      "type": "string",
      "description": "Highest qualification, for example \"BSc Economics\"."
    },
    "schools": {
      "type": "string",
      "description": "Universities or schools, comma separated."
    },
    "employers": {
      "type": "string",
      "description": "Current and past employers, comma separated."
    },
    "location": {
      "type": "string",
      "description": "Where the person lives or wants to work."
    },
    "target_roles": {
      "type": "string",
      "description": "Roles to look for, comma separated. Defaults to the CV's titles."
    },
    "where": {
      "type": "string",
      "description": "Where to look, for example London or remote."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many jobs, 1 to 10."
    }
  },
  "required": [],
  "additionalProperties": false
}

jobspotter_apply_kit

Job Spotter. Everything needed to apply for a job. For "help me apply for this", "write my cover letter", "what should I say in my application?". Gives what the job asks for, the lines in the CV that prove each skill, what is missing, keywords to use if true, a cover letter outline and common application questions with how to answer them, so a tailored letter and answers can be written. Job Spotter never applies or sends anything. Nothing sent is stored.

Parameters10

cv	string	optional	The CV as plain text. Optional if titles and skills are given.
titles	string	optional	Current and past job titles, comma separated.
skills	string	optional	Skills, comma separated.
years_experience	number	optional	Years of work experience.
education	string	optional	Highest qualification, for example "BSc Economics".
schools	string	optional	Universities or schools, comma separated.
employers	string	optional	Current and past employers, comma separated.
location	string	optional	Where the person lives or wants to work.
id	string	optional	A job id from a search result, copied exactly. Or give job_text.
job_text	string	optional	The job advert as plain text, when there is no id.

Raw schema

{
  "type": "object",
  "properties": {
    "cv": {
      "type": "string",
      "description": "The CV as plain text. Optional if titles and skills are given."
    },
    "titles": {
      "type": "string",
      "description": "Current and past job titles, comma separated."
    },
    "skills": {
      "type": "string",
      "description": "Skills, comma separated."
    },
    "years_experience": {
      "type": "number",
      "description": "Years of work experience."
    },
    "education": {
      "type": "string",
      "description": "Highest qualification, for example \"BSc Economics\"."
    },
    "schools": {
      "type": "string",
      "description": "Universities or schools, comma separated."
    },
    "employers": {
      "type": "string",
      "description": "Current and past employers, comma separated."
    },
    "location": {
      "type": "string",
      "description": "Where the person lives or wants to work."
    },
    "id": {
      "type": "string",
      "description": "A job id from a search result, copied exactly. Or give job_text."
    },
    "job_text": {
      "type": "string",
      "description": "The job advert as plain text, when there is no id."
    }
  },
  "required": [],
  "additionalProperties": false
}

jobspotter_connection_score

Job Spotter. How relevant a connection is to your goal. For "should I connect with this person?", "is this contact worth messaging about my job search?". Scores how relevant a connection is to the user's goal, out of 100, from two profiles the user provides (it rates the fit with the goal, not the person), the same way every time: works where they want to work, recruiter or likely hiring manager for the goal, same school, same past employer, shared skills, nearby, more senior. Gives the reasons, a short verdict and an outline for a short note. Profiles can be pasted text (for example from LinkedIn's Save to PDF). Nothing sent is stored.

Parameters3

me	object	required	A profile: text, and or fields title, company, employers, schools, location, skills.
them	object	required	A profile: text, and or fields title, company, employers, schools, location, skills.
goal	string	optional	What the person is aiming for, for example "data analyst at Monzo".

Raw schema

{
  "type": "object",
  "properties": {
    "me": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "maxLength": 20000
        },
        "title": {
          "type": "string",
          "maxLength": 120
        },
        "company": {
          "type": "string",
          "maxLength": 80
        },
        "employers": {
          "type": "string",
          "maxLength": 300
        },
        "schools": {
          "type": "string",
          "maxLength": 300
        },
        "location": {
          "type": "string",
          "maxLength": 60
        },
        "skills": {
          "type": "string",
          "maxLength": 1000
        }
      },
      "description": "A profile: text, and or fields title, company, employers, schools, location, skills."
    },
    "them": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "maxLength": 20000
        },
        "title": {
          "type": "string",
          "maxLength": 120
        },
        "company": {
          "type": "string",
          "maxLength": 80
        },
        "employers": {
          "type": "string",
          "maxLength": 300
        },
        "schools": {
          "type": "string",
          "maxLength": 300
        },
        "location": {
          "type": "string",
          "maxLength": 60
        },
        "skills": {
          "type": "string",
          "maxLength": 1000
        }
      },
      "description": "A profile: text, and or fields title, company, employers, schools, location, skills."
    },
    "goal": {
      "type": "string",
      "description": "What the person is aiming for, for example \"data analyst at Monzo\"."
    }
  },
  "required": [
    "me",
    "them"
  ],
  "additionalProperties": false
}

jobspotter_networking_plan

Job Spotter. Who to reach out to, from a CV. For "who should I network with?", "how do I get a job as a data scientist without applying cold?". From a CV or a few details and the role wanted, gives the kinds of people worth contacting in order (hiring managers at the employers hiring most for the role, recruiters who place it, alumni, former colleagues, people who made the same move, community organisers), with ready searches, the employers hiring most now and named people from public posts. Nothing sent is stored.

Parameters11

cv	string	optional	The CV as plain text. Optional if titles and skills are given.
titles	string	optional	Current and past job titles, comma separated.
skills	string	optional	Skills, comma separated.
years_experience	number	optional	Years of work experience.
education	string	optional	Highest qualification, for example "BSc Economics".
schools	string	optional	Universities or schools, comma separated.
employers	string	optional	Current and past employers, comma separated.
location	string	optional	Where the person lives or wants to work.
goal_role	string	required	The job the person is aiming for, for example "data scientist".
where	string	optional	Where, for example London.
school	string	optional	A university or school, for alumni.

Raw schema

{
  "type": "object",
  "properties": {
    "cv": {
      "type": "string",
      "description": "The CV as plain text. Optional if titles and skills are given."
    },
    "titles": {
      "type": "string",
      "description": "Current and past job titles, comma separated."
    },
    "skills": {
      "type": "string",
      "description": "Skills, comma separated."
    },
    "years_experience": {
      "type": "number",
      "description": "Years of work experience."
    },
    "education": {
      "type": "string",
      "description": "Highest qualification, for example \"BSc Economics\"."
    },
    "schools": {
      "type": "string",
      "description": "Universities or schools, comma separated."
    },
    "employers": {
      "type": "string",
      "description": "Current and past employers, comma separated."
    },
    "location": {
      "type": "string",
      "description": "Where the person lives or wants to work."
    },
    "goal_role": {
      "type": "string",
      "description": "The job the person is aiming for, for example \"data scientist\"."
    },
    "where": {
      "type": "string",
      "description": "Where, for example London."
    },
    "school": {
      "type": "string",
      "description": "A university or school, for alumni."
    }
  },
  "required": [
    "goal_role"
  ],
  "additionalProperties": false
}

jobspotter_check_visa_sponsor

Job Spotter. Is this UK employer a licensed visa sponsor? For "does Deliveroo sponsor visas?", "can this company sponsor a Skilled Worker visa?". Looks the employer up in the UK Home Office register of licensed sponsors (workers), with its town and the visa routes it is licensed for, and the register date. A licence means the employer can sponsor; each job still has to qualify. Company names on the register are legal names, so try the legal name if the brand name is not found. For US jobs, the visa_sponsorship field on search results comes from the advert. Register data contains public sector information licensed under the Open Government Licence v3.0.

Parameters1

company

string

required

The employer, for example "Tesco" or its legal name "Tesco Stores Limited".

Raw schema

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "The employer, for example \"Tesco\" or its legal name \"Tesco Stores Limited\"."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

jobspotter_employer_reply_rate

Job Spotter. How often an employer replies to applications. For "do they actually reply?". From Job Spotter users who track their applications: the share of applications that got any answer (interview, offer or rejection) within the time tracked, and the usual wait. Shown only from 5 tracked applications, so nobody can be singled out.

Parameters1

company

string

required

The employer, for example "Monzo".

Raw schema

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "The employer, for example \"Monzo\"."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

jobspotter_write_job_advert

Job Spotter. Write a job advert and check the pay. For employers: "help me write an advert for a care assistant", "is £12 an hour enough?". Builds a clear advert from the title, duties, must-haves and pay, flags what puts applicants off (missing pay, too many must-haves, slang like "rockstar", age-coded or gendered wording, "native speaker") and compares the pay with current adverts for the role and place. Nothing is posted or stored; posting is free at jobspotter.pages.dev/employers.

Parameters15

title	string	required	Job title.
company	string	optional	Company name.
location	string	optional	Where the job is.
remote	boolean	optional	Remote job.
type	string	optional	Type: full_time, part_time, contract, temporary, internship or per_diem.
pay_lo	number	optional	Pay from.
pay_hi	number	optional	Pay to.
pay_cur	string	optional	GBP, USD, EUR or CAD.
pay_per	string	optional	Pay per: year, hour, day or month.
about	string	optional	A line or two about the company.
duties	string	optional	What the person will do, one per line or comma separated.
must	string	optional	Must-haves, comma separated.
nice	string	optional	Nice to have, comma separated.
benefits	string	optional	Benefits, comma separated.
apply	string	optional	How to apply.

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Job title."
    },
    "company": {
      "type": "string",
      "description": "Company name."
    },
    "location": {
      "type": "string",
      "description": "Where the job is."
    },
    "remote": {
      "type": "boolean",
      "description": "Remote job."
    },
    "type": {
      "type": "string",
      "description": "Type: full_time, part_time, contract, temporary, internship or per_diem."
    },
    "pay_lo": {
      "type": "number",
      "description": "Pay from."
    },
    "pay_hi": {
      "type": "number",
      "description": "Pay to."
    },
    "pay_cur": {
      "type": "string",
      "description": "GBP, USD, EUR or CAD."
    },
    "pay_per": {
      "type": "string",
      "description": "Pay per: year, hour, day or month."
    },
    "about": {
      "type": "string",
      "description": "A line or two about the company."
    },
    "duties": {
      "type": "string",
      "description": "What the person will do, one per line or comma separated."
    },
    "must": {
      "type": "string",
      "description": "Must-haves, comma separated."
    },
    "nice": {
      "type": "string",
      "description": "Nice to have, comma separated."
    },
    "benefits": {
      "type": "string",
      "description": "Benefits, comma separated."
    },
    "apply": {
      "type": "string",
      "description": "How to apply."
    }
  },
  "required": [
    "title"
  ],
  "additionalProperties": false
}

jobspotter_referral_note

Job Spotter. A ready note asking someone for a referral. For "write to Amy at Monzo asking for a referral". Gives a LinkedIn connection note under 300 characters and a longer email version that asks for a referral or a short chat, built from how they know each other and why the job fits. Nothing is sent or stored.

Parameters8

your_name	string	optional	The sender.
their_name	string	optional	The person being asked.
how_you_know	string	optional	For example "We worked together at Sunrise".
job_title	string	required	The job.
company	string	required	The company.
job_link	string	optional	Link to the job.
why_fit	string	optional	One line on why the job fits.
ask	string	optional	Ask: referral (default) or chat.

Raw schema

{
  "type": "object",
  "properties": {
    "your_name": {
      "type": "string",
      "description": "The sender."
    },
    "their_name": {
      "type": "string",
      "description": "The person being asked."
    },
    "how_you_know": {
      "type": "string",
      "description": "For example \"We worked together at Sunrise\"."
    },
    "job_title": {
      "type": "string",
      "description": "The job."
    },
    "company": {
      "type": "string",
      "description": "The company."
    },
    "job_link": {
      "type": "string",
      "description": "Link to the job."
    },
    "why_fit": {
      "type": "string",
      "description": "One line on why the job fits."
    },
    "ask": {
      "type": "string",
      "description": "Ask: referral (default) or chat."
    }
  },
  "required": [
    "job_title",
    "company"
  ],
  "additionalProperties": false
}

jobspotter_job_demand

Job Spotter. What job seekers are searching for, by role and place. For "how many people are looking for care jobs in Leeds?" or "what are people searching for in Bristol?". Anonymous weekly counts of searches on Job Spotter by role words and place over the last 8 weeks, with the listings people found per search. Leave out what to get the most searched roles in a place (with a rising or falling trend), or where to get the places a role is searched most. For a role, it also gives the easiest places to find openings: where each search finds the most listings. A group is shown only when it holds 10 or more searches.

Parameters3

what	string	optional	The role, for example "care assistant".
where	string	optional	A town or city, or "remote".
country	string	optional	US or UK.

Raw schema

{
  "type": "object",
  "properties": {
    "what": {
      "type": "string",
      "description": "The role, for example \"care assistant\"."
    },
    "where": {
      "type": "string",
      "description": "A town or city, or \"remote\"."
    },
    "country": {
      "type": "string",
      "enum": [
        "US",
        "UK"
      ],
      "description": "US or UK."
    }
  },
  "required": [],
  "additionalProperties": false
}

jobspotter_fair_hiring_check

Job Spotter. Check an employer against the fair hiring badge. For "is this employer fair to applicants?". Four checks from what the employer does: shows pay in its adverts on Job Spotter, replies to tracked applications, hires through scored consent-first introductions, and (UK employers with 250 or more staff) reports its gender pay gap on time. Each check comes with its figures; the badge is earned when every check with data passes and at least two have data. Includes a badge image link.

Parameters1

company

string

required

The employer, for example "Greggs".

Raw schema

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "The employer, for example \"Greggs\"."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

jobspotter_cover_letter

Job Spotter. Draft a cover letter and application answers. For "write my cover letter for this job" or "help me answer these application questions". Builds a first draft only from the person's own CV lines and the advert: the strongest matching achievements, the skills the job asks for in the CV's own words, an honest gap line, and draft answers to the form's questions. Anything only the person can know is left as a [bracketed] prompt. Job Spotter never applies or sends anything, and nothing sent is stored.

Parameters15

cv	string	optional	The CV as plain text. Optional if titles and skills are given.
titles	string	optional	Current and past job titles, comma separated.
skills	string	optional	Skills, comma separated.
years_experience	number	optional	Years of work experience.
education	string	optional	Highest qualification, for example "BSc Economics".
schools	string	optional	Universities or schools, comma separated.
employers	string	optional	Current and past employers, comma separated.
location	string	optional	Where the person lives or wants to work.
id	string	optional	A job id from a search result, copied exactly. Or give job_text.
job_text	string	optional	The job advert as plain text, when there is no id.
company	string	optional	The employer's name, when the advert is pasted as job_text.
your_name	string	optional	The person's name, to sign the letter.
why_company	string	optional	One specific reason they want this employer, in their words. Left as a gap to fill in if not given.
availability	string	optional	When they could start, for example "I can start in May".
questions	string	optional	Application form questions to draft answers for, one per line. Common questions are used if left out.

Raw schema

{
  "type": "object",
  "properties": {
    "cv": {
      "type": "string",
      "description": "The CV as plain text. Optional if titles and skills are given."
    },
    "titles": {
      "type": "string",
      "description": "Current and past job titles, comma separated."
    },
    "skills": {
      "type": "string",
      "description": "Skills, comma separated."
    },
    "years_experience": {
      "type": "number",
      "description": "Years of work experience."
    },
    "education": {
      "type": "string",
      "description": "Highest qualification, for example \"BSc Economics\"."
    },
    "schools": {
      "type": "string",
      "description": "Universities or schools, comma separated."
    },
    "employers": {
      "type": "string",
      "description": "Current and past employers, comma separated."
    },
    "location": {
      "type": "string",
      "description": "Where the person lives or wants to work."
    },
    "id": {
      "type": "string",
      "description": "A job id from a search result, copied exactly. Or give job_text."
    },
    "job_text": {
      "type": "string",
      "description": "The job advert as plain text, when there is no id."
    },
    "company": {
      "type": "string",
      "description": "The employer's name, when the advert is pasted as job_text."
    },
    "your_name": {
      "type": "string",
      "description": "The person's name, to sign the letter."
    },
    "why_company": {
      "type": "string",
      "description": "One specific reason they want this employer, in their words. Left as a gap to fill in if not given."
    },
    "availability": {
      "type": "string",
      "description": "When they could start, for example \"I can start in May\"."
    },
    "questions": {
      "type": "string",
      "description": "Application form questions to draft answers for, one per line. Common questions are used if left out."
    }
  },
  "required": [],
  "additionalProperties": false
}

jobspotter_interview_practice

Job Spotter. Practise an interview, one question at a time. For "practise an interview with me" or "how was that answer?". Send the role to get the first question; send the question and the person's answer to get a score out of 10 with what went well, one thing to fix and the next question. Scored by fixed rules, the same for everyone: structure (situation, task, action, result), what the person did themselves, a concrete result, length and the question's own words. It scores the answer, never the person, and nothing is stored.

Parameters4

role	string	optional	The job being interviewed for, for example "staff nurse".
question	string	optional	The question that was answered, copied from the last reply. Leave out to get a question.
answer	string	optional	The person's answer, as they would say it. Leave out to get the next question.
n	integer	optional	Which practice question to ask, from 0. The reply gives next_n.

Raw schema

{
  "type": "object",
  "properties": {
    "role": {
      "type": "string",
      "description": "The job being interviewed for, for example \"staff nurse\"."
    },
    "question": {
      "type": "string",
      "description": "The question that was answered, copied from the last reply. Leave out to get a question."
    },
    "answer": {
      "type": "string",
      "description": "The person's answer, as they would say it. Leave out to get the next question."
    },
    "n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 6,
      "description": "Which practice question to ask, from 0. The reply gives next_n."
    }
  },
  "required": [],
  "additionalProperties": false
}

jobspotter_us_visa_salaries

Job Spotter. What a US employer offered on work visa filings. For "what does Google pay software engineers?" or "how much does Infosys pay on H-1B?". Wages US employers offered on certified H-1B, H-1B1 and E-3 labour condition applications (US Department of Labor disclosure data): the number of filings, the median and typical range, and the most common job titles with their median offered wage. Offered wages on filings, a guide to pay at that employer; contact people named in the filings are left out.

Parameters2

company	string	required	The employer, for example "Google" or "Amazon.com Services".
title	string	optional	A job title to pick out, for example "software engineer".

Raw schema

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "The employer, for example \"Google\" or \"Amazon.com Services\"."
    },
    "title": {
      "type": "string",
      "description": "A job title to pick out, for example \"software engineer\"."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

jobspotter_about_job_spotter

Job Spotter. What Job Spotter can do, for job seekers and employers. The capabilities, the rules (nothing is sent without a yes) and which tool does what. A ready-to-read summary is in `say`.

Parameters

No parameters.

Raw schema

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

syncmycycle_get_todays_phase

Sync My Cycle. Today's cycle phase, with workout and food ideas. For when the user asks what phase they are in, what workout or food suits them today, or why their energy is up or down, for example "what phase am I in, my last period started September 12th" or "what should I train today?". Needs the first day of their last period. Not for getting pregnant, fertile days, ovulation timing, contraception or pregnancy: this is general wellbeing only, not for pregnancy planning or contraception, and a doctor or pharmacist is the right person for those. When `period_may_be_late` is true the say line says the period may be late and suggests checking with a doctor.

Parameters8

last_period	string	required	First day of the user's most recent period, YYYY-MM-DD. Must be within the last 120 days.
cycle_length	integer	optional	Usual days from one period start to the next, 20 to 45. Default 28.
period_length	integer	optional	Usual days of bleeding, 2 to 10. Default 5.
date	string	optional	Day to ask about, YYYY-MM-DD, a real calendar day. Default today where the user is: from tz, else country, else the request, else UTC.
diet	string	optional	Comma separated: vegetarian, vegan, pescatarian, halal. Food ideas are filtered to suit.
country	string	optional	Two-letter country code (UK is read as GB). Sets the kit links (US, GB and IE get local Amazon links) and the time zone for today. Default from the request.
tz	string	optional	The user's IANA time zone, for example Europe/London or America/Chicago, so today is the user's today. Optional: country is enough in most places.
last_period_start	string	optional	Older name for last_period, kept for existing callers; last_period is the current name.

Raw schema

{
  "type": "object",
  "properties": {
    "last_period": {
      "type": "string",
      "format": "date",
      "description": "First day of the user's most recent period, YYYY-MM-DD. Must be within the last 120 days."
    },
    "cycle_length": {
      "type": "integer",
      "minimum": 20,
      "maximum": 45,
      "description": "Usual days from one period start to the next, 20 to 45. Default 28."
    },
    "period_length": {
      "type": "integer",
      "minimum": 2,
      "maximum": 10,
      "description": "Usual days of bleeding, 2 to 10. Default 5."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Day to ask about, YYYY-MM-DD, a real calendar day. Default today where the user is: from tz, else country, else the request, else UTC."
    },
    "diet": {
      "type": "string",
      "description": "Comma separated: vegetarian, vegan, pescatarian, halal. Food ideas are filtered to suit."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code (UK is read as GB). Sets the kit links (US, GB and IE get local Amazon links) and the time zone for today. Default from the request."
    },
    "tz": {
      "type": "string",
      "description": "The user's IANA time zone, for example Europe/London or America/Chicago, so today is the user's today. Optional: country is enough in most places."
    },
    "last_period_start": {
      "type": "string",
      "format": "date",
      "description": "Older name for last_period, kept for existing callers; last_period is the current name."
    }
  },
  "required": [
    "last_period"
  ],
  "additionalProperties": false
}

syncmycycle_get_week_ahead

Sync My Cycle. The days ahead by phase. For when the user wants to plan training or meals for the week, for example "plan my training this week around my cycle". Returns each day's likely phase, workout focus, intensity and food focus. Not for getting pregnant, fertile days, ovulation timing, contraception or pregnancy: this is general wellbeing only, not for pregnancy planning or contraception, and it is not a fertility calendar. When `period_may_be_late` is true, `days` is empty and the say line suggests checking with a doctor.

Parameters9

last_period	string	required	First day of the user's most recent period, YYYY-MM-DD. Must be within the last 120 days.
cycle_length	integer	optional	Usual cycle length, 20 to 45. Default 28.
period_length	integer	optional	Usual days of bleeding, 2 to 10. Default 5.
date	string	optional	First day of the plan, YYYY-MM-DD, a real calendar day. Default today where the user is: from tz, else country, else the request, else UTC.
days	integer	optional	How many days, a whole number from 1 to 35. Default 7.
diet	string	optional	Accepted for symmetry with get_todays_phase; the week view has no food list, so it has no effect here.
country	string	optional	Two-letter country code (UK is read as GB), used for the time zone of today.
tz	string	optional	The user's IANA time zone, for example Europe/London or America/Chicago, so today is the user's today. Optional: country is enough in most places.
last_period_start	string	optional	Older name for last_period, kept for existing callers; last_period is the current name.

Raw schema

{
  "type": "object",
  "properties": {
    "last_period": {
      "type": "string",
      "format": "date",
      "description": "First day of the user's most recent period, YYYY-MM-DD. Must be within the last 120 days."
    },
    "cycle_length": {
      "type": "integer",
      "minimum": 20,
      "maximum": 45,
      "description": "Usual cycle length, 20 to 45. Default 28."
    },
    "period_length": {
      "type": "integer",
      "minimum": 2,
      "maximum": 10,
      "description": "Usual days of bleeding, 2 to 10. Default 5."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "First day of the plan, YYYY-MM-DD, a real calendar day. Default today where the user is: from tz, else country, else the request, else UTC."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 35,
      "description": "How many days, a whole number from 1 to 35. Default 7."
    },
    "diet": {
      "type": "string",
      "description": "Accepted for symmetry with get_todays_phase; the week view has no food list, so it has no effect here."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code (UK is read as GB), used for the time zone of today."
    },
    "tz": {
      "type": "string",
      "description": "The user's IANA time zone, for example Europe/London or America/Chicago, so today is the user's today. Optional: country is enough in most places."
    },
    "last_period_start": {
      "type": "string",
      "format": "date",
      "description": "Older name for last_period, kept for existing callers; last_period is the current name."
    }
  },
  "required": [
    "last_period"
  ],
  "additionalProperties": false
}

syncmycycle_list_phases

Sync My Cycle. What each phase usually feels like, with workout and food ideas. For general questions about cycle syncing that need no dates, for example "what should I eat in my luteal phase?". Not for conception, fertile days, contraception or pregnancy: general wellbeing only, not for pregnancy planning or contraception.

Parameters

No parameters.

Raw schema

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

wardrobeconnect_find_clothes

Wardrobe Connect. Find clothes that match a description. For when the user describes a piece of clothing they want ("black pleated wide-leg trousers", "cream cable-knit jumper like the one I saved"). Natural requests are fine ("a navy midi wrap dress for a summer wedding under £60 in a size 12"): the occasion is kept out of the search and returned in `occasion`, and a price or size in the words is used when max_price or size is not passed. Returns eBay listings in the Clothing, Shoes and Accessories category, closest matches first and then cheapest first (from a best-match and a price-sorted search), plus search links for other shops and a Facebook Marketplace search phrase. Listings must match the colour and fabric named, the same kind of garment (by title and by eBay category, so socks never answer a search for trainers), and men's or women's if given; kids' items only when asked for. Adult, fetish and costume listings are never shown, repeat listings of the same item count once, and listings far below the typical price for the search (usually bait or junk) are left out.

Parameters5

q	string	required	A clear description of the item: colour, type, fabric or style, brand if known.
size	string	optional	The user's size, for example M, XL, 12, UK 9, US 8.5, EU 39 or W32. Numbers without UK, US or EU are read in the country's usual sizes. Dress and shoe sizes are converted between UK, US and EU, and dress sizes to S, M and L. Listings that state a different size are left out; listings that state the size come first (size_listed true), then ones that don't say.
max_price	number	optional	Most the user wants to pay, in their local currency, shipping included.
condition	string	optional	Condition: new, used (pre-owned) or any. Default any. pre-owned and second-hand are read as used.
country	string	optional	Two-letter country code. Defaults to where the request comes from. Supported: US, GB, IE, CA, AU, DE, FR, IT, ES.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "A clear description of the item: colour, type, fabric or style, brand if known."
    },
    "size": {
      "type": "string",
      "description": "The user's size, for example M, XL, 12, UK 9, US 8.5, EU 39 or W32. Numbers without UK, US or EU are read in the country's usual sizes. Dress and shoe sizes are converted between UK, US and EU, and dress sizes to S, M and L. Listings that state a different size are left out; listings that state the size come first (size_listed true), then ones that don't say."
    },
    "max_price": {
      "type": "number",
      "description": "Most the user wants to pay, in their local currency, shipping included."
    },
    "condition": {
      "type": "string",
      "enum": [
        "any",
        "new",
        "used"
      ],
      "description": "Condition: new, used (pre-owned) or any. Default any. pre-owned and second-hand are read as used."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. Defaults to where the request comes from. Supported: US, GB, IE, CA, AU, DE, FR, IT, ES."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

wardrobeconnect_find_clothes_by_image

Wardrobe Connect. Find clothes that look like a picture. For when the user shares or points at a picture of an outfit or item (a Pinterest pin, a saved post, a photo). Takes the image's direct https link. Returns visually similar eBay listings from the Clothing, Shoes and Accessories category only, in eBay's look-alike order. If the picture does not look like one piece of clothing (the results are scattered across unrelated kinds), `matches` is empty and the say line asks what the item is. A short description in q makes results match it, which removes look-alikes of the wrong kind.

Parameters6

image_url	string	required	Direct https link to a JPEG, PNG or WebP picture, 6 MB at most.
q	string	optional	Which item in the picture, for example "the camel coat". Results must match it, and it is used as a fallback text search.
size	string	optional	Clothing or shoe size to match, for example M, 10 or UK 8.
max_price	number	optional	Highest price, in the local currency.
condition	string	optional	Condition: any, new or used.
country	string	optional	Two-letter country code for the eBay site and currency, for example US or GB.

Raw schema

{
  "type": "object",
  "properties": {
    "image_url": {
      "type": "string",
      "description": "Direct https link to a JPEG, PNG or WebP picture, 6 MB at most."
    },
    "q": {
      "type": "string",
      "description": "Which item in the picture, for example \"the camel coat\". Results must match it, and it is used as a fallback text search."
    },
    "size": {
      "type": "string",
      "description": "Clothing or shoe size to match, for example M, 10 or UK 8."
    },
    "max_price": {
      "type": "number",
      "description": "Highest price, in the local currency."
    },
    "condition": {
      "type": "string",
      "enum": [
        "any",
        "new",
        "used"
      ],
      "description": "Condition: any, new or used."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code for the eBay site and currency, for example US or GB."
    }
  },
  "required": [
    "image_url"
  ],
  "additionalProperties": false
}

formguide_get_team

Form Guide. A club's league position, recent form and next games. For requests like "how are Arsenal doing?", "what's Spurs' form?", "when do Birmingham play next?"

Parameters4

team	string	required	Club name as the user said it, up to 80 characters. Nicknames and small typos are fine.
league	string	optional	One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404. Only needed if two clubs share a name.
q	string	optional	Older name for team, kept for existing callers; team is the current name.
country	string	optional	Two-letter country code for the shirt link (US, GB and IE get local Amazon links). Default from the request. When passed as US or CA, the say line also gives the next kick-off in US Eastern time.

Raw schema

{
  "type": "object",
  "properties": {
    "team": {
      "type": "string",
      "description": "Club name as the user said it, up to 80 characters. Nicknames and small typos are fine."
    },
    "league": {
      "type": "string",
      "description": "One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404. Only needed if two clubs share a name."
    },
    "q": {
      "type": "string",
      "description": "Older name for team, kept for existing callers; team is the current name."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code for the shirt link (US, GB and IE get local Amazon links). Default from the request. When passed as US or CA, the say line also gives the next kick-off in US Eastern time."
    }
  },
  "required": [
    "team"
  ],
  "additionalProperties": false
}

formguide_get_fixtures

Form Guide. Upcoming fixtures for a club or a league. For requests like "who do Liverpool play next?" or "what's on in La Liga this weekend?". Without team or league, gives the Premier League.

Parameters4

team	string	optional	A club name, for example Liverpool or Real Madrid.
league	string	optional	One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404.
days	integer	optional	How far ahead, a whole number from 1 to 60. Default 21. If nothing falls in the window (an international break), the next fixtures are returned anyway.
country	string	optional	US or CA adds US Eastern kick-off times to the say line (and to each fixture's us_eastern, which is always there when a time is known).

Raw schema

{
  "type": "object",
  "properties": {
    "team": {
      "type": "string",
      "description": "A club name, for example Liverpool or Real Madrid."
    },
    "league": {
      "type": "string",
      "description": "One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "description": "How far ahead, a whole number from 1 to 60. Default 21. If nothing falls in the window (an international break), the next fixtures are returned anyway."
    },
    "country": {
      "type": "string",
      "description": "US or CA adds US Eastern kick-off times to the say line (and to each fixture's us_eastern, which is always there when a time is known)."
    }
  },
  "required": [],
  "additionalProperties": false
}

formguide_get_results

Form Guide. Latest results for a club, or the last round of a league. For requests like "how did Chelsea get on?" or "what were the Serie A results?". Without team or league, gives the Premier League.

Parameters3

team	string	optional	A club name, for example Liverpool or Real Madrid.
league	string	optional	One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404.
n	integer	optional	How many of the club's results, a whole number from 1 to 20. Default 5.

Raw schema

{
  "type": "object",
  "properties": {
    "team": {
      "type": "string",
      "description": "A club name, for example Liverpool or Real Madrid."
    },
    "league": {
      "type": "string",
      "description": "One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404."
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "How many of the club's results, a whole number from 1 to 20. Default 5."
    }
  },
  "required": [],
  "additionalProperties": false
}

formguide_get_table

Form Guide. League table. For requests like "show me the Championship table" or "who is top of La Liga?". Points include official deductions; a deducted club's row has points_deducted.

Parameters1

league

string

optional

One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404. Default premier league.

Raw schema

{
  "type": "object",
  "properties": {
    "league": {
      "type": "string",
      "description": "One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404. Default premier league."
    }
  },
  "required": [],
  "additionalProperties": false
}

formguide_compare_teams

Form Guide. Two clubs side by side before they meet. For requests like "Arsenal v Leeds, how do they compare?". Gives positions, form, goals, this season's meeting and the next date they play. Stats only, not betting advice.

Parameters5

home	string	required	The home club, for example Arsenal.
away	string	required	A different club from home.
team1	string	optional	Older name for home, kept for existing callers; home is the current name.
team2	string	optional	Older name for away, kept for existing callers; away is the current name.
country	string	optional	US or CA adds US Eastern kick-off times to the say line (and to each fixture's us_eastern, which is always there when a time is known).

Raw schema

{
  "type": "object",
  "properties": {
    "home": {
      "type": "string",
      "description": "The home club, for example Arsenal."
    },
    "away": {
      "type": "string",
      "description": "A different club from home."
    },
    "team1": {
      "type": "string",
      "description": "Older name for home, kept for existing callers; home is the current name."
    },
    "team2": {
      "type": "string",
      "description": "Older name for away, kept for existing callers; away is the current name."
    },
    "country": {
      "type": "string",
      "description": "US or CA adds US Eastern kick-off times to the say line (and to each fixture's us_eastern, which is always there when a time is known)."
    }
  },
  "required": [
    "home",
    "away"
  ],
  "additionalProperties": false
}

bookslikethis_get_book

Books Like This. A book's details and any film or series made from it. For requests like "tell me about Project Hail Mary", "is The Name of the Wind being made into a film?", "how long is Dune?". Misspellings are fine. If screen_checked is false, the film and TV check could not run just now, so the film and TV status is unknown.

Parameters3

title	string	required	The book's title, 2 to 120 characters. Add author for very short or common titles.
author	string	optional	The author's name, to pin down the right book or list their books.
country	string	optional	For buy links: US, GB, IE, CA, AU. Default from the request.

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "The book's title, 2 to 120 characters. Add author for very short or common titles."
    },
    "author": {
      "type": "string",
      "description": "The author's name, to pin down the right book or list their books."
    },
    "country": {
      "type": "string",
      "description": "For buy links: US, GB, IE, CA, AU. Default from the request."
    }
  },
  "required": [
    "title"
  ],
  "additionalProperties": false
}

bookslikethis_find_similar_books

Books Like This. Books like one the user enjoyed, or for a genre. For requests like "books like The Martian" or "a good cosy mystery". Suggestions are English-language books for the same readers (picture book, children, young adult or adult), one per author and one per series. Well-read books of the same kind come first (picked_from: shelf, and because names the kind, for example "celebrated dystopian novels"), then books sharing specific subjects on Open Library (picked_from: subjects, and because lists the shared subjects). Novels never get self-help, textbooks, anthologies, study guides, category romance lines or explicit books as suggestions, and popular books are preferred over obscure ones. Other books by the same author are left out unless same_author=true. Give title or subject; common other titles work (1984, The Sorcerer's Stone)

Parameters5

title	string	optional	A book the user liked, 2 to 120 characters.
author	string	optional	The author's name, to pin down the right book or list their books.
subject	string	optional	A genre or theme, for example space opera, cozy mystery, heist.
same_author	boolean	optional	True to include more books by the same author.
country	string	optional	Two-letter country code for the shop links, for example US or GB.

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "A book the user liked, 2 to 120 characters."
    },
    "author": {
      "type": "string",
      "description": "The author's name, to pin down the right book or list their books."
    },
    "subject": {
      "type": "string",
      "description": "A genre or theme, for example space opera, cozy mystery, heist."
    },
    "same_author": {
      "type": "boolean",
      "description": "True to include more books by the same author."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code for the shop links, for example US or GB."
    }
  },
  "required": [],
  "additionalProperties": false
}

bookslikethis_get_author_books

Books Like This. An author's books, newest first. For requests like "what has Andy Weir written?" or "Sally Rooney's books"

Parameters2

author	string	required	The author's name, to pin down the right book or list their books.
country	string	optional	For buy links: US, GB, IE, CA, AU. Default from the request.

Raw schema

{
  "type": "object",
  "properties": {
    "author": {
      "type": "string",
      "description": "The author's name, to pin down the right book or list their books."
    },
    "country": {
      "type": "string",
      "description": "For buy links: US, GB, IE, CA, AU. Default from the request."
    }
  },
  "required": [
    "author"
  ],
  "additionalProperties": false
}

fairfare_estimate_fare

Fair 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
}

fairfare_check_fare

Fair 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
}

fairfare_best_time_to_ride

Fair Fare. 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
}

fairfare_get_airport

Fair Fare. 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
}

fairfare_get_taxi_tariff

Fair Fare. 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
}

fairfare_check_driver_licence

Fair Fare. 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
}

fairfare_list_cities

Fair Fare. 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
}

fairfare_check_fleet_file

Fair Fare. 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
}

artspotter_search_art

Art Spotter - Eye of the Beholder. Find art for sale from independent artists. Searches works in independent artists' own shops and eBay art by words (subject, style, place, artist), kind, original or print, price, size and colour. Results show title, artist, size, price, where it ships from, an image and a link to buy straight from the artist.

Parameters13

q	string	optional	What to look for, for example abstract blue, linocut bird, Scottish landscape or a dog portrait.
kind	string	optional	Kind: painting, print, printmaking, photography, drawing, watercolour, ceramics, sculpture, textile, illustration or other.
original	boolean	optional	Set to true for one-off originals only, false for prints only.
max_price	number	optional	Highest price, in the currency given (or the buyer's local currency).
min_price	number	optional	Lowest price.
currency	string	optional	Currency for prices, for example USD, GBP or EUR.
min_size	number	optional	Smallest longest side, in unit.
max_size	number	optional	Largest longest side, in unit.
unit	string	optional	Unit: in or cm. Defaults to in.
colour	string	optional	A main colour, for example blue or ochre.
country	string	optional	Buyer's two-letter country code, for eBay and currency, for example US or GB.
ships_from	string	optional	Only artists based in this two-letter country.
limit	integer	optional	How many results, 1 to 20.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "What to look for, for example abstract blue, linocut bird, Scottish landscape or a dog portrait."
    },
    "kind": {
      "type": "string",
      "enum": [
        "painting",
        "print",
        "printmaking",
        "photography",
        "drawing",
        "watercolour",
        "ceramics",
        "sculpture",
        "textile",
        "illustration",
        "other"
      ],
      "description": "Kind: painting, print, printmaking, photography, drawing, watercolour, ceramics, sculpture, textile, illustration or other."
    },
    "original": {
      "type": "boolean",
      "description": "Set to true for one-off originals only, false for prints only."
    },
    "max_price": {
      "type": "number",
      "description": "Highest price, in the currency given (or the buyer's local currency)."
    },
    "min_price": {
      "type": "number",
      "description": "Lowest price."
    },
    "currency": {
      "type": "string",
      "description": "Currency for prices, for example USD, GBP or EUR."
    },
    "min_size": {
      "type": "number",
      "description": "Smallest longest side, in unit."
    },
    "max_size": {
      "type": "number",
      "description": "Largest longest side, in unit."
    },
    "unit": {
      "type": "string",
      "enum": [
        "in",
        "cm"
      ],
      "description": "Unit: in or cm. Defaults to in."
    },
    "colour": {
      "type": "string",
      "description": "A main colour, for example blue or ochre."
    },
    "country": {
      "type": "string",
      "description": "Buyer's two-letter country code, for eBay and currency, for example US or GB."
    },
    "ships_from": {
      "type": "string",
      "description": "Only artists based in this two-letter country."
    },
    "limit": {
      "type": "integer",
      "description": "How many results, 1 to 20."
    }
  },
  "required": [],
  "additionalProperties": false
}

artspotter_get_fair_art_price

Art Spotter - Eye of the Beholder. Fair price for a new artwork by size and medium. What original work or prints of about this size and kind sell for in independent artists' own shops: the typical price, the middle half of prices and the price per square inch, from comparable works for sale.

Parameters6

width	number	required	Width, in unit.
height	number	required	Height, in unit.
unit	string	optional	Unit: in or cm.
kind	string	optional	Kind of work. Defaults to painting.
original	boolean	optional	Set to true for originals (the default), false for prints.
currency	string	optional	Currency for the answer, for example USD or GBP.

Raw schema

{
  "type": "object",
  "properties": {
    "width": {
      "type": "number",
      "description": "Width, in unit."
    },
    "height": {
      "type": "number",
      "description": "Height, in unit."
    },
    "unit": {
      "type": "string",
      "enum": [
        "in",
        "cm"
      ],
      "description": "Unit: in or cm."
    },
    "kind": {
      "type": "string",
      "enum": [
        "painting",
        "print",
        "printmaking",
        "photography",
        "drawing",
        "watercolour",
        "ceramics",
        "sculpture",
        "textile",
        "illustration",
        "other"
      ],
      "description": "Kind of work. Defaults to painting."
    },
    "original": {
      "type": "boolean",
      "description": "Set to true for originals (the default), false for prints."
    },
    "currency": {
      "type": "string",
      "description": "Currency for the answer, for example USD or GBP."
    }
  },
  "required": [
    "width",
    "height"
  ],
  "additionalProperties": false
}

artspotter_compare_where_to_sell

Art Spotter - Eye of the Beholder. What an artist keeps on each selling platform. For a sale price, what the artist keeps after fees on Etsy, eBay, Saatchi Art, Artfinder, Singulart, their own Shopify shop and direct card payments, sorted by money kept, with print-on-demand options for prints. US and UK fee tables.

Parameters4

price	number	required	The price the buyer pays.
currency	string	optional	USD or GBP.
shipping	number	optional	Shipping charged to the buyer, if any.
kind	string	optional	Kind: original (the default) or print.

Raw schema

{
  "type": "object",
  "properties": {
    "price": {
      "type": "number",
      "description": "The price the buyer pays."
    },
    "currency": {
      "type": "string",
      "enum": [
        "USD",
        "GBP"
      ],
      "description": "USD or GBP."
    },
    "shipping": {
      "type": "number",
      "description": "Shipping charged to the buyer, if any."
    },
    "kind": {
      "type": "string",
      "enum": [
        "original",
        "print"
      ],
      "description": "Kind: original (the default) or print."
    }
  },
  "required": [
    "price"
  ],
  "additionalProperties": false
}

artspotter_price_commission

Art Spotter - Eye of the Beholder. Price and terms for commissioning a piece. A price guide for a commissioned piece by size and the artist's level, what similar finished originals sell for, the usual deposit, revision rounds, cancellation fees, copyright and a contract checklist for buyer and artist.

Parameters5

width	number	required	Width, in unit.
height	number	required	Height, in unit.
unit	string	optional	Unit: in or cm.
medium	string	optional	Kind of work, for example painting or drawing.
level	string	optional	Level: emerging (the default), mid or established.

Raw schema

{
  "type": "object",
  "properties": {
    "width": {
      "type": "number",
      "description": "Width, in unit."
    },
    "height": {
      "type": "number",
      "description": "Height, in unit."
    },
    "unit": {
      "type": "string",
      "enum": [
        "in",
        "cm"
      ],
      "description": "Unit: in or cm."
    },
    "medium": {
      "type": "string",
      "description": "Kind of work, for example painting or drawing."
    },
    "level": {
      "type": "string",
      "enum": [
        "emerging",
        "mid",
        "established"
      ],
      "description": "Level: emerging (the default), mid or established."
    }
  },
  "required": [
    "width",
    "height"
  ],
  "additionalProperties": false
}

artspotter_size_art_for_wall

Art Spotter - Eye of the Beholder. What size art fits a wall and how high to hang it. Art width for the furniture or wall, the hanging height, the gap above furniture and gallery wall spacing, with a ready search for works in that size range.

Parameters3

furniture_width	number	optional	Width of the sofa, bed or sideboard below the art.
wall_width	number	optional	Width of the wall, if there's no furniture below.
unit	string	optional	Unit: in or cm.

Raw schema

{
  "type": "object",
  "properties": {
    "furniture_width": {
      "type": "number",
      "description": "Width of the sofa, bed or sideboard below the art."
    },
    "wall_width": {
      "type": "number",
      "description": "Width of the wall, if there's no furniture below."
    },
    "unit": {
      "type": "string",
      "enum": [
        "in",
        "cm"
      ],
      "description": "Unit: in or cm."
    }
  },
  "required": [],
  "additionalProperties": false
}

artspotter_list_open_calls

Art Spotter - Eye of the Beholder. Open calls, prizes and residencies for artists. Recurring open exhibitions, prizes, residencies and listing sites in the UK, US and Canada, with entry fees, usual closing month, media and official links.

Parameters3

country	string	optional	UK, US or CA.
media	string	optional	For example painting, watercolour, print or photography.
kind	string	optional	Kind: open call, prize, residency or listing hub.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "UK, US or CA."
    },
    "media": {
      "type": "string",
      "description": "For example painting, watercolour, print or photography."
    },
    "kind": {
      "type": "string",
      "description": "Kind: open call, prize, residency or listing hub."
    }
  },
  "required": [],
  "additionalProperties": false
}

artspotter_get_artist_funding

Art Spotter - Eye of the Beholder. Grants, buyer finance, royalties and copyright for artists. For the UK: arts council grants, Own Art 0% buyer finance and the Artist's Resale Right. For the US: grants and the $85 group copyright registration for 2 to 20 artworks.

Parameters1

country

string

optional

GB or US.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "GB or US."
    }
  },
  "required": [],
  "additionalProperties": false
}

artspotter_calculate_resale_royalty

Art Spotter - Eye of the Beholder. UK Artist's Resale Right on a resale. The royalty owed to an artist on a UK resale through a gallery, dealer or auction house, by band, with the cap and who collects it.

Parameters1

price

number

required

Resale price in pounds.

Raw schema

{
  "type": "object",
  "properties": {
    "price": {
      "type": "number",
      "description": "Resale price in pounds."
    }
  },
  "required": [
    "price"
  ],
  "additionalProperties": false
}

artspotter_check_art_listing

Art Spotter - Eye of the Beholder. Check an art listing before buying. Whether a link is an independent artist in the index or a marketplace with buyer protection, reverse image search links for the picture, and the checks that catch stolen images, AI work sold as hand-made and payment scams.

Parameters2

url	string	optional	The listing or shop address.
image	string	optional	The address of the artwork's picture.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The listing or shop address."
    },
    "image": {
      "type": "string",
      "description": "The address of the artwork's picture."
    }
  },
  "required": [],
  "additionalProperties": false
}

artspotter_make_artwork_passport

Art Spotter - Eye of the Beholder. A free artwork passport for an artist's work. Makes a certificate for a work (title, artist, year, medium, size, edition) with a fingerprint of its picture, as printable text and schema.org data the artist can publish, so anyone can later check the picture is unchanged.

Parameters7

image	string	required	The https address of the work's picture.
title	string	required	Title of the work.
artist	string	required	Artist's name.
year	string	optional	Year made.
medium	string	optional	For example oil on canvas.
size	string	optional	For example 60 x 90 cm.
edition	string	optional	For example 3/25, for prints.

Raw schema

{
  "type": "object",
  "properties": {
    "image": {
      "type": "string",
      "description": "The https address of the work's picture."
    },
    "title": {
      "type": "string",
      "description": "Title of the work."
    },
    "artist": {
      "type": "string",
      "description": "Artist's name."
    },
    "year": {
      "type": "string",
      "description": "Year made."
    },
    "medium": {
      "type": "string",
      "description": "For example oil on canvas."
    },
    "size": {
      "type": "string",
      "description": "For example 60 x 90 cm."
    },
    "edition": {
      "type": "string",
      "description": "For example 3/25, for prints."
    }
  },
  "required": [
    "image",
    "title",
    "artist"
  ],
  "additionalProperties": false
}

artspotter_verify_artwork_passport

Art Spotter - Eye of the Beholder. Check a picture matches an artwork passport. Recomputes the picture's fingerprint and says whether it matches the one in the passport.

Parameters2

image	string	required	The https address of the picture.
sha256	string	required	The fingerprint from the passport.

Raw schema

{
  "type": "object",
  "properties": {
    "image": {
      "type": "string",
      "description": "The https address of the picture."
    },
    "sha256": {
      "type": "string",
      "description": "The fingerprint from the passport."
    }
  },
  "required": [
    "image",
    "sha256"
  ],
  "additionalProperties": false
}

artspotter_check_artworks_feed

Art Spotter - Eye of the Beholder. Check an artist's artworks.json. Reads an artist's artworks.json (the open format at artspotter.pages.dev/artworks that lets assistants find work sold direct) and lists anything to fix.

Parameters1

url

string

required

The https address of the artworks.json file.

Raw schema

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

talmud_get_today

Talmud Scroller. Today's reading, line by line (same as the app shows today). Talmud: daily readings, plans, search and original text lookup; whole books from the Library, read a passage at a time.

Parameters1

date

string

optional

Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

talmud_list_readings

Talmud Scroller. All curated daily readings and plans. Talmud: daily readings, plans, search and original text lookup; whole books from the Library, read a passage at a time.

Parameters

No parameters.

Raw schema

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

talmud_get_reading

Talmud Scroller. One reading or plan, line by line. Talmud: daily readings, plans, search and original text lookup; whole books from the Library, read a passage at a time.

Parameters1

string

required

A reading or plan id from list_readings, or a plan name such as "japji" or "The Gita in 18 Days".

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A reading or plan id from list_readings, or a plan name such as \"japji\" or \"The Gita in 18 Days\"."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

talmud_search_readings

Talmud Scroller. Search the curated readings, best match first. Talmud: daily readings, plans, search and original text lookup; whole books from the Library, read a passage at a time.

Parameters1

string

required

Words to search for, for example kindness or Shabbat.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Words to search for, for example kindness or Shabbat."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

talmud_get_talmud_text

Talmud Scroller. Original text of any Talmud page or passage, or a Mishnah such as Pirkei Avot 1:14, from Sefaria.

Parameters1

ref

string

required

A tractate and page, for example "Berakhot 2a", "Bava Metzia 59b" or "Shabbat 31a:6". Spoken forms such as "Bava Metzia page 59 b" also work.

Raw schema

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "A tractate and page, for example \"Berakhot 2a\", \"Bava Metzia 59b\" or \"Shabbat 31a:6\". Spoken forms such as \"Bava Metzia page 59 b\" also work."
    }
  },
  "required": [
    "ref"
  ],
  "additionalProperties": false
}

talmud_get_card

Talmud Scroller. Today's reading one line at a time, for voice.. Talmud: daily readings, plans, search and original text lookup; whole books from the Library, read a passage at a time.

Parameters3

n	integer	optional	Which card, starting at 1. Defaults to 1.
reading	string	optional	A reading or plan id from list_readings. Defaults to today's reading.
date	string	optional	Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Which card, starting at 1. Defaults to 1."
    },
    "reading": {
      "type": "string",
      "description": "A reading or plan id from list_readings. Defaults to today's reading."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

talmud_list_books

Talmud Scroller. The whole books in the Library that can be read a passage at a time. Talmud: daily readings, plans, search and original text lookup; whole books from the Library, read a passage at a time.

Parameters

No parameters.

Raw schema

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

talmud_read_book

Talmud Scroller. Follow next for the next passage; it carries on into the next chapter. Talmud: daily readings, plans, search and original text lookup; whole books from the Library, read a passage at a time.

Parameters4

book	string	required	Book id or title from list_books, for example pirkei-avot, bekhorot.
section	string	optional	Chapter, book, poem, letter or daf to start at, as listed in the book (for example 5, "chapter 2", "havamal", or 10b for the second side of a daf). Defaults to the beginning; Bekhorot defaults to today's Daf Yomi page while the cycle is in it.
n	integer	optional	Passage within the section, starting at 1.
ref	string	optional	Optional: jump straight to a passage by its reference, for example "Havamal 139", "Meditations 4.3", "Gita 2.47", "Iliad 1.5" or "10b". Overrides section and n.

Raw schema

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "Book id or title from list_books, for example pirkei-avot, bekhorot."
    },
    "section": {
      "type": "string",
      "description": "Chapter, book, poem, letter or daf to start at, as listed in the book (for example 5, \"chapter 2\", \"havamal\", or 10b for the second side of a daf). Defaults to the beginning; Bekhorot defaults to today's Daf Yomi page while the cycle is in it."
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Passage within the section, starting at 1."
    },
    "ref": {
      "type": "string",
      "description": "Optional: jump straight to a passage by its reference, for example \"Havamal 139\", \"Meditations 4.3\", \"Gita 2.47\", \"Iliad 1.5\" or \"10b\". Overrides section and n."
    }
  },
  "required": [
    "book"
  ],
  "additionalProperties": false
}

gurbani_get_today

Scroll the Gurbani. Today's reading, line by line (same as the app shows today). Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters1

date

string

optional

Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

gurbani_list_readings

Scroll the Gurbani. All curated daily readings and plans. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters

No parameters.

Raw schema

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

gurbani_get_reading

Scroll the Gurbani. One reading or plan, line by line. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters1

string

required

A reading or plan id from list_readings, or a plan name such as "japji" or "The Gita in 18 Days".

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A reading or plan id from list_readings, or a plan name such as \"japji\" or \"The Gita in 18 Days\"."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

gurbani_search_readings

Scroll the Gurbani. Search the curated readings, best match first. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters1

string

required

Words or a bani's name to search for, for example Japji or humility.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Words or a bani's name to search for, for example Japji or humility."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

gurbani_get_ang

Scroll the Gurbani. Every line on an Ang in Gurmukhi with transliteration and English. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters1

ang

integer

required

The Ang (page) of Sri Guru Granth Sahib, 1 to 1430.

Raw schema

{
  "type": "object",
  "properties": {
    "ang": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1430,
      "description": "The Ang (page) of Sri Guru Granth Sahib, 1 to 1430."
    }
  },
  "required": [
    "ang"
  ],
  "additionalProperties": false
}

gurbani_get_shabad

Scroll the Gurbani. A whole shabad by BaniDB id, with transliteration and English. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters1

integer

required

A BaniDB shabad ID.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "A BaniDB shabad ID."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

gurbani_get_card

Scroll the Gurbani. Today's reading one line at a time, for voice.. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters3

n	integer	optional	Which card, starting at 1. Defaults to 1.
reading	string	optional	A reading or plan id from list_readings. Defaults to today's reading.
date	string	optional	Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Which card, starting at 1. Defaults to 1."
    },
    "reading": {
      "type": "string",
      "description": "A reading or plan id from list_readings. Defaults to today's reading."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

gurbani_list_books

Scroll the Gurbani. The whole books in the Library that can be read a passage at a time. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters

No parameters.

Raw schema

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

gurbani_read_book

Scroll the Gurbani. Follow next for the next passage; it carries on into the next chapter. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters4

book	string	required	Book id or title from list_books, for example japji, sukhmani.
section	string	optional	Chapter, book, poem, letter or daf to start at, as listed in the book (for example 5, "chapter 2", "havamal", or 10b for the second side of a daf). Defaults to the beginning; Bekhorot defaults to today's Daf Yomi page while the cycle is in it.
n	integer	optional	Passage within the section, starting at 1.
ref	string	optional	Optional: jump straight to a passage by its reference, for example "Havamal 139", "Meditations 4.3", "Gita 2.47", "Iliad 1.5" or "10b". Overrides section and n.

Raw schema

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "Book id or title from list_books, for example japji, sukhmani."
    },
    "section": {
      "type": "string",
      "description": "Chapter, book, poem, letter or daf to start at, as listed in the book (for example 5, \"chapter 2\", \"havamal\", or 10b for the second side of a daf). Defaults to the beginning; Bekhorot defaults to today's Daf Yomi page while the cycle is in it."
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Passage within the section, starting at 1."
    },
    "ref": {
      "type": "string",
      "description": "Optional: jump straight to a passage by its reference, for example \"Havamal 139\", \"Meditations 4.3\", \"Gita 2.47\", \"Iliad 1.5\" or \"10b\". Overrides section and n."
    }
  },
  "required": [
    "book"
  ],
  "additionalProperties": false
}

gita_get_today

Gita Scroller. Today's reading, line by line (same as the app shows today). Bhagavad Gita: daily verses, plans, search and verse lookup; whole books from the Library, read a passage at a time.

Parameters1

date

string

optional

Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

gita_list_readings

Gita Scroller. All curated daily readings and plans. Bhagavad Gita: daily verses, plans, search and verse lookup; whole books from the Library, read a passage at a time.

Parameters

No parameters.

Raw schema

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

gita_get_reading

Gita Scroller. One reading or plan, line by line. Bhagavad Gita: daily verses, plans, search and verse lookup; whole books from the Library, read a passage at a time.

Parameters1

string

required

A reading or plan id from list_readings, or a plan name such as "japji" or "The Gita in 18 Days".

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A reading or plan id from list_readings, or a plan name such as \"japji\" or \"The Gita in 18 Days\"."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

gita_search_readings

Gita Scroller. Search the curated readings, best match first. Bhagavad Gita: daily verses, plans, search and verse lookup; whole books from the Library, read a passage at a time.

Parameters1

string

required

Words to search for, for example duty or fear.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Words to search for, for example duty or fear."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

gita_get_verse

Gita Scroller. A verse or range (e.g. 47-51) in Sanskrit with transliteration and English. Bhagavad Gita: daily verses, plans, search and verse lookup; whole books from the Library, read a passage at a time.

Parameters2

chapter	integer	required	Chapter number, 1 to 18.
verse	string	required	For example: 47-51.

Raw schema

{
  "type": "object",
  "properties": {
    "chapter": {
      "type": "integer",
      "minimum": 1,
      "maximum": 18,
      "description": "Chapter number, 1 to 18."
    },
    "verse": {
      "type": "string",
      "description": "For example: 47-51."
    }
  },
  "required": [
    "chapter",
    "verse"
  ],
  "additionalProperties": false
}

gita_get_chapter

Gita Scroller. A whole chapter in Sanskrit with transliteration and English. Bhagavad Gita: daily verses, plans, search and verse lookup; whole books from the Library, read a passage at a time.

Parameters1

chapter

integer

required

Chapter number, 1 to 18.

Raw schema

{
  "type": "object",
  "properties": {
    "chapter": {
      "type": "integer",
      "minimum": 1,
      "maximum": 18,
      "description": "Chapter number, 1 to 18."
    }
  },
  "required": [
    "chapter"
  ],
  "additionalProperties": false
}

gita_get_card

Gita Scroller. Today's reading one line at a time, for voice.. Bhagavad Gita: daily verses, plans, search and verse lookup; whole books from the Library, read a passage at a time.

Parameters3

n	integer	optional	Which card, starting at 1. Defaults to 1.
reading	string	optional	A reading or plan id from list_readings. Defaults to today's reading.
date	string	optional	Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Which card, starting at 1. Defaults to 1."
    },
    "reading": {
      "type": "string",
      "description": "A reading or plan id from list_readings. Defaults to today's reading."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

gita_list_books

Gita Scroller. The whole books in the Library that can be read a passage at a time. Bhagavad Gita: daily verses, plans, search and verse lookup; whole books from the Library, read a passage at a time.

Parameters

No parameters.

Raw schema

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

gita_read_book

Gita Scroller. Follow next for the next passage; it carries on into the next chapter. Bhagavad Gita: daily verses, plans, search and verse lookup; whole books from the Library, read a passage at a time.

Parameters4

book	string	required	Book id or title from list_books, for example gita.
section	string	optional	Chapter, book, poem, letter or daf to start at, as listed in the book (for example 5, "chapter 2", "havamal", or 10b for the second side of a daf). Defaults to the beginning; Bekhorot defaults to today's Daf Yomi page while the cycle is in it.
n	integer	optional	Passage within the section, starting at 1.
ref	string	optional	Optional: jump straight to a passage by its reference, for example "Havamal 139", "Meditations 4.3", "Gita 2.47", "Iliad 1.5" or "10b". Overrides section and n.

Raw schema

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "Book id or title from list_books, for example gita."
    },
    "section": {
      "type": "string",
      "description": "Chapter, book, poem, letter or daf to start at, as listed in the book (for example 5, \"chapter 2\", \"havamal\", or 10b for the second side of a daf). Defaults to the beginning; Bekhorot defaults to today's Daf Yomi page while the cycle is in it."
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Passage within the section, starting at 1."
    },
    "ref": {
      "type": "string",
      "description": "Optional: jump straight to a passage by its reference, for example \"Havamal 139\", \"Meditations 4.3\", \"Gita 2.47\", \"Iliad 1.5\" or \"10b\". Overrides section and n."
    }
  },
  "required": [
    "book"
  ],
  "additionalProperties": false
}

lore_get_today

Scroll the Lore. Today's reading, line by line (same as the app shows today). Greek and Norse myth: daily readings explained line by line, plans, search, and the whole Theogony, Iliad, Odyssey and Poetic Edda read a passage at a time.

Parameters1

date

string

optional

Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

lore_list_readings

Scroll the Lore. All curated daily readings and plans. Greek and Norse myth: daily readings explained line by line, plans, search, and the whole Theogony, Iliad, Odyssey and Poetic Edda read a passage at a time.

Parameters

No parameters.

Raw schema

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

lore_get_reading

Scroll the Lore. One reading or plan, line by line. Greek and Norse myth: daily readings explained line by line, plans, search, and the whole Theogony, Iliad, Odyssey and Poetic Edda read a passage at a time.

Parameters1

string

required

A reading or plan id from list_readings, or a plan name such as "japji" or "The Gita in 18 Days".

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A reading or plan id from list_readings, or a plan name such as \"japji\" or \"The Gita in 18 Days\"."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

lore_search_readings

Scroll the Lore. Search the curated readings, best match first. Greek and Norse myth: daily readings explained line by line, plans, search, and the whole Theogony, Iliad, Odyssey and Poetic Edda read a passage at a time.

Parameters1

string

required

Words or a name to search for, for example Loki or Persephone.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Words or a name to search for, for example Loki or Persephone."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

lore_get_card

Scroll the Lore. Today's reading one line at a time, for voice.. Greek and Norse myth: daily readings explained line by line, plans, search, and the whole Theogony, Iliad, Odyssey and Poetic Edda read a passage at a time.

Parameters3

n	integer	optional	Which card, starting at 1. Defaults to 1.
reading	string	optional	A reading or plan id from list_readings. Defaults to today's reading.
date	string	optional	Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Which card, starting at 1. Defaults to 1."
    },
    "reading": {
      "type": "string",
      "description": "A reading or plan id from list_readings. Defaults to today's reading."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

lore_list_books

Scroll the Lore. The whole books in the Library that can be read a passage at a time. Greek and Norse myth: daily readings explained line by line, plans, search, and the whole Theogony, Iliad, Odyssey and Poetic Edda read a passage at a time.

Parameters

No parameters.

Raw schema

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

lore_read_book

Scroll the Lore. Follow next for the next passage; it carries on into the next chapter. Greek and Norse myth: daily readings explained line by line, plans, search, and the whole Theogony, Iliad, Odyssey and Poetic Edda read a passage at a time.

Parameters4

book	string	required	Book id or title from list_books, for example iliad, odyssey.
section	string	optional	Chapter, book, poem, letter or daf to start at, as listed in the book (for example 5, "chapter 2", "havamal", or 10b for the second side of a daf). Defaults to the beginning; Bekhorot defaults to today's Daf Yomi page while the cycle is in it.
n	integer	optional	Passage within the section, starting at 1.
ref	string	optional	Optional: jump straight to a passage by its reference, for example "Havamal 139", "Meditations 4.3", "Gita 2.47", "Iliad 1.5" or "10b". Overrides section and n.

Raw schema

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "Book id or title from list_books, for example iliad, odyssey."
    },
    "section": {
      "type": "string",
      "description": "Chapter, book, poem, letter or daf to start at, as listed in the book (for example 5, \"chapter 2\", \"havamal\", or 10b for the second side of a daf). Defaults to the beginning; Bekhorot defaults to today's Daf Yomi page while the cycle is in it."
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Passage within the section, starting at 1."
    },
    "ref": {
      "type": "string",
      "description": "Optional: jump straight to a passage by its reference, for example \"Havamal 139\", \"Meditations 4.3\", \"Gita 2.47\", \"Iliad 1.5\" or \"10b\". Overrides section and n."
    }
  },
  "required": [
    "book"
  ],
  "additionalProperties": false
}

stoics_get_today

Stoic Scroller. Today's reading, line by line (same as the app shows today). The Stoics: daily readings from Marcus Aurelius, Epictetus and Seneca explained line by line, plans, search, and the whole Meditations, Enchiridion and Seneca's letters read a passage at a time.

Parameters1

date

string

optional

Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

stoics_list_readings

Stoic Scroller. All curated daily readings and plans. The Stoics: daily readings from Marcus Aurelius, Epictetus and Seneca explained line by line, plans, search, and the whole Meditations, Enchiridion and Seneca's letters read a passage at a time.

Parameters

No parameters.

Raw schema

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

stoics_get_reading

Stoic Scroller. One reading or plan, line by line. The Stoics: daily readings from Marcus Aurelius, Epictetus and Seneca explained line by line, plans, search, and the whole Meditations, Enchiridion and Seneca's letters read a passage at a time.

Parameters1

string

required

A reading or plan id from list_readings, or a plan name such as "japji" or "The Gita in 18 Days".

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A reading or plan id from list_readings, or a plan name such as \"japji\" or \"The Gita in 18 Days\"."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

stoics_search_readings

Stoic Scroller. Search the curated readings, best match first. The Stoics: daily readings from Marcus Aurelius, Epictetus and Seneca explained line by line, plans, search, and the whole Meditations, Enchiridion and Seneca's letters read a passage at a time.

Parameters1

string

required

Words to search for, for example anger or death.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Words to search for, for example anger or death."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

stoics_get_card

Stoic Scroller. Today's reading one line at a time, for voice.. The Stoics: daily readings from Marcus Aurelius, Epictetus and Seneca explained line by line, plans, search, and the whole Meditations, Enchiridion and Seneca's letters read a passage at a time.

Parameters3

n	integer	optional	Which card, starting at 1. Defaults to 1.
reading	string	optional	A reading or plan id from list_readings. Defaults to today's reading.
date	string	optional	Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Which card, starting at 1. Defaults to 1."
    },
    "reading": {
      "type": "string",
      "description": "A reading or plan id from list_readings. Defaults to today's reading."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

stoics_list_books

Stoic Scroller. The whole books in the Library that can be read a passage at a time. The Stoics: daily readings from Marcus Aurelius, Epictetus and Seneca explained line by line, plans, search, and the whole Meditations, Enchiridion and Seneca's letters read a passage at a time.

Parameters

No parameters.

Raw schema

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

stoics_read_book

Stoic Scroller. Follow next for the next passage; it carries on into the next chapter. The Stoics: daily readings from Marcus Aurelius, Epictetus and Seneca explained line by line, plans, search, and the whole Meditations, Enchiridion and Seneca's letters read a passage at a time.

Parameters4

book	string	required	Book id or title from list_books, for example meditations, enchiridion.
section	string	optional	Chapter, book, poem, letter or daf to start at, as listed in the book (for example 5, "chapter 2", "havamal", or 10b for the second side of a daf). Defaults to the beginning; Bekhorot defaults to today's Daf Yomi page while the cycle is in it.
n	integer	optional	Passage within the section, starting at 1.
ref	string	optional	Optional: jump straight to a passage by its reference, for example "Havamal 139", "Meditations 4.3", "Gita 2.47", "Iliad 1.5" or "10b". Overrides section and n.

Raw schema

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "Book id or title from list_books, for example meditations, enchiridion."
    },
    "section": {
      "type": "string",
      "description": "Chapter, book, poem, letter or daf to start at, as listed in the book (for example 5, \"chapter 2\", \"havamal\", or 10b for the second side of a daf). Defaults to the beginning; Bekhorot defaults to today's Daf Yomi page while the cycle is in it."
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Passage within the section, starting at 1."
    },
    "ref": {
      "type": "string",
      "description": "Optional: jump straight to a passage by its reference, for example \"Havamal 139\", \"Meditations 4.3\", \"Gita 2.47\", \"Iliad 1.5\" or \"10b\". Overrides section and n."
    }
  },
  "required": [
    "book"
  ],
  "additionalProperties": false
}

bible_get_today

Bible Swipe. Today's reading, line by line (same as the app shows today). Bible: daily readings, plans, search and passage lookup (World English Bible)

Parameters1

date

string

optional

Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

bible_list_readings

Bible Swipe. All curated daily readings and plans. Bible: daily readings, plans, search and passage lookup (World English Bible)

Parameters

No parameters.

Raw schema

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

bible_get_reading

Bible Swipe. One reading or plan, line by line. Bible: daily readings, plans, search and passage lookup (World English Bible)

Parameters1

string

required

A reading or plan id from list_readings, or a plan name such as "japji" or "The Gita in 18 Days".

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A reading or plan id from list_readings, or a plan name such as \"japji\" or \"The Gita in 18 Days\"."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

bible_search_readings

Bible Swipe. Search the curated readings, best match first. Bible: daily readings, plans, search and passage lookup (World English Bible)

Parameters1

string

required

Words to search for, for example forgiveness or shepherd.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Words to search for, for example forgiveness or shepherd."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

bible_get_passage

Bible Swipe. Any verse, range, chapter or cross-chapter range (Genesis 1:1-2:3) of the World English Bible.

Parameters1

ref

string

required

For example: John 3:16.

Raw schema

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "For example: John 3:16."
    }
  },
  "required": [
    "ref"
  ],
  "additionalProperties": false
}

bible_get_card

Bible Swipe. Today's reading one line at a time, for voice.. Bible: daily readings, plans, search and passage lookup (World English Bible)

Parameters3

n	integer	optional	Which card, starting at 1. Defaults to 1.
reading	string	optional	A reading or plan id from list_readings. Defaults to today's reading.
date	string	optional	Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Which card, starting at 1. Defaults to 1."
    },
    "reading": {
      "type": "string",
      "description": "A reading or plan id from list_readings. Defaults to today's reading."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "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 (162)

mizan_screen_companymizan_list_standardsmizan_purify_dividendmizan_find_halal_alternativesmizan_screen_portfoliomizan_calculate_zakathalalornot_check_ingredientshalalornot_check_product_by_barcode

Remote endpoint

Streamable HTTP

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

url

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

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