Plate Pal

Official3 tools

by GoodTurnStudio · JavaScript

Calories and nutrition for any food, chain meal or barcode, and meal ideas for a goal and diet.

MCP Server: io.github.GoodTurnStudio/platepal

The MCP server named io.github.GoodTurnStudio/platepal provides calories and nutrition for any food, including chain meals or barcode inputs. It also returns meal ideas aligned to a specified goal and diet. The server is intended to support nutrition lookup and meal-planning information retrieval.

🛠️ Key Features

Calories and nutrition for any food
Support for chain meal queries
Barcode-based nutrition lookups
Meal ideas for a goal and diet

🚀 Use Cases

Estimate calories and nutrition for foods and chain meals
Retrieve nutrition details from a barcode
Generate meal ideas tailored to dietary goals

⚡ Developer Benefits

Data-driven nutrition responses for foods, chains, and barcodes
Consistent meal-idea guidance tied to goal and diet

Captured live from the server via tools/list.

get_food_nutrition

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
}

get_barcode_nutrition

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
}

get_meal_ideas

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
}

README.md4 KBView on GitHub

goodturn-mcp

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

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

Products

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

How it works

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

Build and test

code

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

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

Licence

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

Install

Tools (3)

get_food_nutritionget_barcode_nutritionget_meal_ideas

Remote endpoint

Streamable HTTP

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

url

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

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

MCP Server: io.github.GoodTurnStudio/platepal

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

get_food_nutrition

get_barcode_nutrition

get_meal_ideas

goodturn-mcp

Products

How it works

Build and test

Licence

Install

Remote endpoint

Related servers