supp.fit über das Model Context Protocol

Dieser Server gibt einem KI-Assistenten Lesezugriff auf die Studienlage zu Nahrungsergänzungsmitteln aus veröffentlichten Studien, auf einen Katalog echter Produkte und — wenn Sie es erlauben — auf Ihren eigenen Stack und Ihr Einnahmeprotokoll. Es ist ein Endpunkt, er ist nur lesend, und jedes Werkzeug verlangt ein angemeldetes supp.fit-Konto.

Was das ist

Das Model Context Protocol, kurz MCP, ist der Weg, über den ein KI-Assistent Daten erreicht, die nicht in seinen Trainingsdaten stehen. Ein Client wie Claude oder ChatGPT verbindet sich mit einem MCP-Server, liest die Liste der angebotenen Werkzeuge und ruft eines auf, wenn eine Frage es verlangt. Dieser Server ist die supp.fit-Seite dieser Verbindung.

Ohne ihn schreibt ein Assistent die Antwort auf eine Frage zu einem Nahrungsergänzungsmittel aus dem Gedächtnis: keine Studie, kein Jahr, keine Teilnehmerzahl und keine Möglichkeit für Sie, das zu prüfen. Mit ihm liest der Assistent dieselbe Datenbasis, auf der die Website supp.fit aufgebaut ist, und jede Aussage, die er wiedergibt, lässt sich bis zur Arbeit zurückverfolgen, aus der sie stammt.

Was Sie fragen können

Das sind Fragen, die die Werkzeuge unten beantworten können. Die Formulierung ist Ihre; das Werkzeug wählt der Assistent.

Was sagt die Studienlage zu Ashwagandha bei Angst, und auf wie vielen Studien beruht das?
Wie stark ist die Evidenz für Kreatin und Muskelkraft?
Zeig mir die einzelnen Studien zu Magnesium und Schlaf, mit Teilnehmerzahlen und Jahren.
Was ist gerade in meinem Stack, und wie ist die Evidenz für jeden einzelnen Punkt?
Welche Mittel habe ich abgesetzt, und wann?
Habe ich mein Vitamin D in den letzten dreißig Tagen tatsächlich genommen?
Wie viele Kapseln von jedem Mittel habe ich im Juli genommen?
Finde Produkte mit Magnesiumbisglycinat und zeig mir die Nährwerttabelle.

So verbinden Sie ihn

Richten Sie Ihren MCP-Client auf den Endpunkt und folgen Sie der Anmeldung, die er anbietet. Es gibt nichts zu installieren und keinen API-Schlüssel zu kopieren.

POST https://mcp.supp.fit/mcp

Manche Clients fragen nur nach einem Host. Der blanke Host funktioniert ebenfalls — ein POST auf die Wurzel ist derselbe Endpunkt. https://mcp.supp.fit

In einem Client, der aus einer Datei konfiguriert wird, lautet der Eintrag:

{
  "mcpServers": {
    "supp-fit": {
      "type": "http",
      "url": "https://mcp.supp.fit/mcp"
    }
  }
}

Was jedes Werkzeug tut

Die Liste ist bewusst kurz. Die supp.fit-API hat weit über vierzig Endpunkte; ein Werkzeug je Endpunkt ergäbe eine Liste, aus der ein Assistent nicht wählen kann und in der sich zwei Einträge um ein einziges Wort unterscheiden.

Evidenz, Produkte und Marken — `evidence.read`

Werkzeug	Was es zurückgibt
`search_supplements` Nahrungsergänzungsmittel suchen	Findet Mittel nach Namen oder bekanntem Synonym, mit der Anzahl der Wirkungen und der Studien, die supp.fit zu jedem hält. Zuerst dieses Werkzeug nutzen, wenn eine Frage ein Mittel nennt, um seinen Slug für die anderen Werkzeuge zu erhalten.
`get_supplement` Ein Mittel abrufen	Alles, was supp.fit zu einem Mittel hält: jede Wirkung, für die es Evidenz gibt, wie stark diese Evidenz ist, wie viele Studien sie stützen und die gemessenen Effekte. Nimmt einen Slug aus search_supplements.
`get_benefit_evidence` Die Studien hinter einer Wirkung abrufen	Die einzelnen Studien hinter einem Paar aus Mittel und Wirkung: PubMed-Kennung, Titel, Jahr, Teilnehmerzahl, Vertrauenswert und die eigene Zusammenfassung von supp.fit. Das ist die große Antwort; nur aufrufen, wenn eine Frage die Stärke der Evidenz betrifft und nicht das, was die Evidenz aussagt.
`get_article` Eine Studie abrufen	Eine Studie über ihre PubMed-Kennung: Titel, Jahr und die Zusammenfassung von supp.fit, was sie für jedes darin behandelte Mittel gefunden hat. Der vollständige Text wird nie zurückgegeben — er ist lizenziert. Der `url` folgen, um die Arbeit auf PubMed zu lesen.
`search_products` Den Produktkatalog durchsuchen	Sucht echte Produkte nach Name, Marke oder Inhaltsstoff. Eine Suchanfrage ist Pflicht: Es gibt keinen Weg, den ganzen Katalog aufzulisten, weil keine Spalte darin ein Produkt ehrlich über ein anderes stellen kann.
`get_product` Ein Produkt abrufen	Ein Produkt: Marke, Kategorie, Preis und seine Nährwerttabelle. WICHTIG: Die Tabelle ist nur vorhanden, wenn der Barcode des Produkts einem registrierten Etikett zugeordnet wurde UND die Marke übereinstimmte. Ist `has_confirmed_label` falsch, gibt es keine Tabelle, und das heißt, die Zuordnung konnte nicht bestätigt werden — es heißt NICHT, dass das Produkt keine Inhaltsstoffe hat. Einem Leser niemals sagen, ein Produkt enthalte nichts.

Ihre eigenen Daten — `me.read`

Werkzeug	Was es zurückgibt
`whoami` Wem diese Verbindung gehört	Das supp.fit-Konto, von dem diese Verbindung autorisiert wurde. Damit lässt sich bestätigen, wessen Daten die persönlichen Werkzeuge zurückgeben.
`get_my_favourites` Gespeicherte Mittel und Produkte	Was diese Person auf supp.fit gespeichert hat: Nahrungsergänzungsmittel und Produkte.
`get_my_stack` Was diese Person jetzt nimmt	Die Mittel und Produkte, die diese Person derzeit nimmt, mit Dosis, Einheit und Zeitplan für jedes.
`get_my_stack_history` Was diese Person früher genommen hat	Beendete Zeiträume, der neueste zuerst. Etwas abzusetzen löscht es nicht, deshalb erscheint ein zweimal genommenes Mittel als zwei Zeiträume.
`get_my_log` Ob diese Person es tatsächlich genommen hat	Die täglichen Einnahmeangaben innerhalb eines Zeitfensters, begrenzt auf 400 Tage. WICHTIG: Ein Tag ohne Angabe heißt, dass niemand etwas gesagt hat, und das ist NICHT dasselbe wie eine ausgelassene Dosis. Schweigen nicht als Auslassen zählen.
`get_my_consumption` Wie viel von jedem Mittel genommen wurde	Wie viel diese Person von jedem Mittel über ein Zeitfenster genommen hat, gruppiert je Mittel UND je Einheit. WICHTIG: Diese Zahlen nicht über Mittel oder über Einheiten hinweg addieren und nicht in Milligramm eines Nährstoffs umrechnen. Kapseln, Weichkapseln und Milliliter sind verschiedene Dinge, und es gibt hier keine Umrechnungstabelle von Verbindung zu Element — eine Schätzung liegt typischerweise sieben Mal zu hoch, und zwar in der Richtung, die eine Warnung vor der Höchstmenge verdeckt. Die Zahlen so wiedergeben, wie sie zurückkommen.

Was er lesen darf und was nicht

Zwei Berechtigungen, auf der Zustimmungsseite einzeln anzuhaken, sodass die Evidenz-Hälfte ohne die persönliche erteilt werden kann.

Berechtigung	Umfasst
`evidence.read`	Nahrungsergänzungsmittel, Wirkungen, Befunde, Studienzusammenfassungen, Produkte, Marken. Nichts über Sie.
`me.read`	Ihre Favoriten, Ihren aktuellen Stack, die beendeten Zeiträume und Ihr Einnahmeprotokoll.

Alles ist nur lesend. Kein Werkzeug schreibt, ändert oder löscht etwas, und der Server hat keinen Schreibweg zur Datenbank. Er hält auch kein eigenes Geheimnis: Er trägt das Token, das Ihr Client erhalten hat, und sonst nichts, und jede Entscheidung darüber, was dieses Token lesen darf, trifft die API und nicht dieser Server.

Der vollständige Text einer Arbeit wird nie zurückgegeben. Er ist lizenziert, deshalb liefern die Werkzeuge die eigene Zusammenfassung von supp.fit und einen Link zur Arbeit auf PubMed.

Häufige Fragen

Brauche ich ein supp.fit-Konto für diesen MCP-Server?

Ja. Jedes Werkzeug verlangt ein angemeldetes supp.fit-Konto, auch die Werkzeuge, die Daten lesen, die die Website jedem zeigt. Ihr MCP-Client schickt Sie auf die Zustimmungsseite, Sie melden sich mit Google an und wählen, was Sie freigeben.

Warum verlangen auch öffentliche Daten eine Anmeldung?

Ein Assistent arbeitet in einer Schleife, und fast jede nützliche Frage mischt die öffentliche Hälfte mit der privaten: was die Studien sagen und was Sie tatsächlich einnehmen. Eine Regel für alle Werkzeuge ist eine Regel, die sich prüfen lässt. Eine Entscheidung je Werkzeug ist etwas, das irgendwann jemand vergisst.

Kann er etwas in meinem Konto ändern?

Nein. Jedes Werkzeug ist nur lesend. Es gibt kein Werkzeug, das ein Mittel in Ihren Stack einträgt, eine Dosis erfasst, Ihr Protokoll ändert oder etwas löscht, und der Server hat überhaupt keinen Schreibweg zur Datenbank.

Was kann er über mich lesen?

Nur das, was die von Ihnen erteilte Berechtigung umfasst. Die Berechtigung evidence.read umfasst Nahrungsergänzungsmittel, Wirkungen, Studien, Produkte und Marken und sagt nichts über Sie. Die Berechtigung me.read umfasst Ihre eigenen Favoriten, Ihren aktuellen Stack, die beendeten Zeiträume und Ihr Einnahmeprotokoll. Es sind getrennte Kästchen, Sie können also die Evidenz-Hälfte erteilen und die persönliche zurückhalten.

Welche Clients können sich verbinden?

Alles, was das Model Context Protocol über Streamable HTTP spricht und einem OAuth-2.1-Ablauf folgen kann. Dazu gehören Claude, die Connectors von ChatGPT und die MCP-Kommandozeilenwerkzeuge. Der Server ist zustandslos, vergibt also keine Sitzungskennung und öffnet keinen Ereignisstrom.

Woher stammt die Evidenz?

Aus veröffentlichten Studien auf PubMed, gelesen und auf supp.fit zusammengefasst. Jeder Befund trägt die Studie bei sich, aus der er stammt, sodass ein Assistent die Arbeit, das Jahr und die Teilnehmerzahl nennen kann, statt eine Aussage aus eigener Autorität zu behaupten. Der vollständige Text einer Arbeit wird nie zurückgegeben, weil er lizenziert ist.

Was bedeutet eine fehlende Nährwerttabelle?

Dass der Barcode des Produkts keinem registrierten Etikett zugeordnet werden konnte, nicht dass das Produkt keine Inhaltsstoffe hat. Beides sieht in den Daten gleich aus und bedeutet das Gegenteil, deshalb sagt die Beschreibung des Werkzeugs es ausdrücklich, und einem Assistenten wird gesagt, er dürfe nie berichten, ein Produkt enthalte nichts.

Endpunkte

URL	Was es ist
`POST https://mcp.supp.fit/mcp`	das MCP-Gespräch. Ein POST auf die Wurzel ist dasselbe.
`GET https://mcp.supp.fit/.well-known/oauth-protected-resource`	wo ein Token zu bekommen ist, wie RFC 9728 es beschreibt.
`https://api.supp.fit`	der Autorisierungsserver. Er stellt jedes Token aus, das dieser Server einlöst.
`GET https://mcp.supp.fit/llms.txt`	diese Seite als reiner Text, für einen Agenten, der liest statt zu browsen.