# supp.fit MCP server > The supp.fit MCP server. Connect Claude, ChatGPT or any Model Context Protocol client to supplement evidence from published studies, a catalogue of real products, and your own stack and intake log. Read-only, one endpoint, OAuth 2.1. The Model Context Protocol server for supp.fit. It lets an AI assistant read supplement evidence taken from published studies, a catalogue of real supplement products, and the caller's own stack and intake log. Endpoint: POST https://mcp.supp.fit/mcp POST https://mcp.supp.fit/ works too, for a client given the host alone Authorization server: https://api.supp.fit Discovery: https://mcp.supp.fit/.well-known/oauth-protected-resource Website: https://supp.fit Every tool needs a signed-in supp.fit account. Everything is read-only. # Scopes - evidence.read: supplements, benefits, findings, study summaries, products and brands. Nothing about the person. - me.read: the caller's own favourites, current stack, ended periods and intake log. They are separate tick boxes on the consent page, so one can be granted without the other. # Tools - search_supplements (Search supplements): Find supplements by name or by a known synonym, with how many benefits and how many studies supp.fit holds for each. Use this first when a question names a supplement, to get its slug for the other tools. - get_supplement (Get one supplement): Everything supp.fit holds about one supplement: every benefit it has evidence for, how strong that evidence is, how many studies support it, and the measured impacts. Takes a slug from search_supplements. - get_benefit_evidence (Get the studies behind one benefit): The individual studies behind one supplement-and-benefit pair: PubMed id, title, year, participant count, trust score and supp.fit's own summary. This is the large answer; call it only when a question is about the strength of the evidence rather than about what the evidence says. - get_article (Get one study): One study by its PubMed id: title, year, and supp.fit's summary of what it found for each supplement it covers. The full paper text is never returned — it is licensed. Follow the `url` to PubMed for the paper. - search_products (Search the product catalogue): Search real supplement products by name, brand or ingredient. A query is required: there is no way to list the whole catalogue, because no column in it can honestly rank one product above another. - get_product (Get one product): One product: its brand, category, price and its Supplement Facts panel. IMPORTANT: the panel is present only when the product's barcode matched a registered label AND the brand agreed. When `has_confirmed_label` is false there is no panel, and that means the match could not be confirmed — it does NOT mean the product has no ingredients. Never tell a reader a product contains nothing. - whoami (Who this connection belongs to): The supp.fit account this connection was authorised by. Use it to confirm whose data the personal tools will return. - get_my_favourites (Saved supplements and bottles): What this person has saved on supp.fit: supplements and products. - get_my_stack (What this person takes now): The supplements and products this person is currently taking, with the dose, the unit and the schedule for each. - get_my_stack_history (What this person used to take): Periods that have ended, newest first. Stopping something does not delete it, so a supplement taken twice appears as two periods. - get_my_log (Whether this person actually took it): The daily intake answers inside a date window, capped at 400 days. IMPORTANT: a date with no answer means nobody said, which is NOT the same as a missed dose. Do not count silence as a skip. - get_my_consumption (How much of each item was taken): How much of each item this person took over a window, grouped per item AND per unit. IMPORTANT: do not add these figures together across items or across units, and do not convert them into milligrams of a nutrient. Capsules, softgels and millilitres are different things, and no compound-to-element conversion table exists here — a guess is typically seven times too high, in the direction that hides an upper-limit warning. Report the figures as they come back. # Questions people ask ## Do I need a supp.fit account to use this MCP server? Yes. Every tool needs a signed-in supp.fit account, including the ones that read evidence the website shows to anybody. Your MCP client sends you to the consent page, you sign in with Google, and you choose what to share. ## Why does public evidence need a sign-in? An assistant is a loop, and almost every useful question mixes the public half with the private one: what the studies say, and what you are actually taking. One rule for every tool is a rule that can be tested. A per-tool judgement is a thing somebody eventually forgets. ## Can it change anything in my account? No. Every tool is read-only. There is no tool that adds a supplement to your stack, records a dose, edits your log or deletes anything, and the server has no write path to the database at all. ## What can it read about me? Only what the scope you granted covers. The evidence.read scope covers supplements, benefits, studies, products and brands, and says nothing about you. The me.read scope covers your own favourites, your current stack, the periods that have ended and your intake log. They are separate tick boxes, so you can grant the evidence half and withhold the personal one. ## Which clients can connect to it? Anything that speaks the Model Context Protocol over Streamable HTTP and can follow an OAuth 2.1 flow. That includes Claude, ChatGPT's connectors and the MCP command line tools. The server is stateless, so it issues no session id and opens no event stream. ## Where does the evidence come from? From published studies on PubMed, read and summarised on supp.fit. Every finding carries the study it came from, so an assistant can name the paper, the year and the number of participants rather than asserting a claim on its own authority. The full paper text is never returned, because it is licensed. ## What does a missing Supplement Facts panel mean? That the product's barcode could not be matched to a registered label, not that the product has no ingredients. The two look identical in the data and mean opposite things, so the tool description says so in words and an assistant is told never to report that a product contains nothing. # This page in other languages - Deutsch: https://mcp.supp.fit/de - Español: https://mcp.supp.fit/es - Français: https://mcp.supp.fit/fr - Italiano: https://mcp.supp.fit/it - Polski: https://mcp.supp.fit/pl - Русский: https://mcp.supp.fit/ru # Not medical advice This server returns information about supplements and the studies behind them. It does not give medical advice, and neither does anything built on it.