Supplement Check

Official4 tools

by GoodTurnStudio · JavaScript

Supplement labels, doses against official upper limits, and a whole-stack check for overlaps.

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

This MCP server provides label and dose checking for supplements. It evaluates doses against official upper limits and performs a whole-stack check for overlaps. The server is identified as io.github.GoodTurnStudio/supplementcheck.

🛠️ Key Features

Supplement labels review
Dose validation against official upper limits
Whole-stack overlap checking

🚀 Use Cases

Checking supplement dosing for compliance with official upper limits
Detecting overlaps across a whole stack of supplement entries

⚡ Developer Benefits

Structured support for label- and limit-based supplement validation
Overlap detection aligned to the server’s whole-stack check approach

⚠️ Limitations

Available details describe labels, official upper limits, and overlap checks, without further scope or interfaces provided.

Captured live from the server via tools/list.

get_supplement

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
}

get_nutrient

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
}

check_dose

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
}

check_stack

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
}

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 (4)

get_supplementget_nutrientcheck_dosecheck_stack

Remote endpoint

Streamable HTTP

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

url

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

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

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

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_supplement

get_nutrient

check_dose

check_stack

goodturn-mcp

Products

How it works

Build and test

Licence

Install

Remote endpoint

Related servers