supp.fit attraverso il Model Context Protocol

Questo server dà a un assistente IA accesso in lettura alle prove sugli integratori tratte da studi pubblicati, a un catalogo di prodotti reali e — se lo consenti — al tuo stack e al tuo diario delle assunzioni. È un solo endpoint, è in sola lettura, e ogni strumento richiede un account supp.fit con accesso effettuato.

Che cos'è

Il Model Context Protocol, o MCP, è il modo in cui un assistente IA raggiunge dati che non fanno parte del suo addestramento. Un client come Claude o ChatGPT si collega a un server MCP, legge l'elenco degli strumenti che offre e ne chiama uno quando una domanda lo richiede. Questo server è il lato supp.fit di quel collegamento.

Senza di esso, un assistente che risponde a una domanda su un integratore scrive a memoria: nessuno studio, nessun anno, nessun numero di partecipanti e nessun modo per te di verificare. Con esso, l'assistente legge la stessa base di prove su cui è costruito il sito supp.fit, e ogni affermazione che riporta si può risalire all'articolo da cui proviene.

Che cosa puoi chiedergli

Queste sono domande a cui gli strumenti qui sotto sanno rispondere. Le parole sono le tue; lo strumento lo sceglie l'assistente.

Che cosa dicono le prove sull'ashwagandha per l'ansia, e su quanti studi si basano?
Quanto sono solide le prove sulla creatina e la forza muscolare?
Mostrami i singoli studi su magnesio e sonno, con il numero di partecipanti e l'anno.
Che cosa c'è adesso nel mio stack di integratori, e quali sono le prove per ciascuna voce?
Quali integratori ho smesso di prendere, e quando?
Ho preso davvero la vitamina D negli ultimi trenta giorni?
Quante capsule di ciascuna voce ho preso a luglio?
Trova prodotti che contengono magnesio bisglicinato e mostrami la tabella nutrizionale.

Come collegarlo

Punta il tuo client MCP all'endpoint e segui l'accesso che ti propone. Non c'è nulla da installare e nessuna chiave API da copiare.

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

Alcuni client chiedono solo un host. Anche l'host da solo funziona: un POST alla radice è lo stesso endpoint. https://mcp.supp.fit

In un client configurato da un file, la voce è:

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

Che cosa fa ogni strumento

L'elenco è volutamente corto. L'API di supp.fit ha ben più di quaranta endpoint; uno strumento per ciascuno darebbe all'assistente un elenco da cui non può scegliere, in cui due voci differiscono per una sola parola.

Prove, prodotti e marche — `evidence.read`

Strumento	Che cosa restituisce
`search_supplements` Cerca integratori	Trova integratori per nome o per un sinonimo noto, con quanti benefici e quanti studi supp.fit conserva per ciascuno. Usa questo per primo quando una domanda nomina un integratore, per ottenere il suo slug per gli altri strumenti.
`get_supplement` Ottieni un integratore	Tutto ciò che supp.fit conserva su un integratore: ogni beneficio per cui ha prove, quanto sono solide quelle prove, quanti studi le sostengono e gli effetti misurati. Richiede uno slug da search_supplements.
`get_benefit_evidence` Ottieni gli studi dietro un beneficio	I singoli studi dietro una coppia di integratore e beneficio: identificativo PubMed, titolo, anno, numero di partecipanti, punteggio di affidabilità e la sintesi di supp.fit. Questa è la risposta grande; chiamala solo quando la domanda riguarda la solidità delle prove e non ciò che le prove dicono.
`get_article` Ottieni uno studio	Uno studio dal suo identificativo PubMed: titolo, anno e la sintesi di supp.fit di ciò che ha trovato per ogni integratore che tratta. Il testo completo non viene mai restituito — è soggetto a licenza. Segui l'`url` fino a PubMed per leggere l'articolo.
`search_products` Cerca nel catalogo prodotti	Cerca prodotti reali per nome, marca o ingrediente. La query è obbligatoria: non c'è modo di elencare l'intero catalogo, perché nessuna colonna può onestamente mettere un prodotto sopra un altro.
`get_product` Ottieni un prodotto	Un prodotto: marca, categoria, prezzo e la sua tabella nutrizionale. IMPORTANTE: la tabella è presente solo se il codice a barre del prodotto è stato abbinato a un'etichetta registrata E la marca corrispondeva. Quando `has_confirmed_label` è falso non c'è tabella, e questo significa che l'abbinamento non è stato confermato — NON significa che il prodotto non abbia ingredienti. Non dire mai a un lettore che un prodotto non contiene nulla.

I tuoi dati — `me.read`

Strumento	Che cosa restituisce
`whoami` A chi appartiene questo collegamento	L'account supp.fit che ha autorizzato questo collegamento. Usalo per confermare di chi sono i dati che restituiranno gli strumenti personali.
`get_my_favourites` Integratori e prodotti salvati	Che cosa questa persona ha salvato su supp.fit: integratori e prodotti.
`get_my_stack` Che cosa prende adesso questa persona	Gli integratori e i prodotti che questa persona sta prendendo, con dose, unità e cadenza di ciascuno.
`get_my_stack_history` Che cosa prendeva prima questa persona	Periodi conclusi, dal più recente. Smettere qualcosa non lo cancella, perciò un integratore preso due volte compare come due periodi.
`get_my_log` Se questa persona lo ha preso davvero	Le risposte quotidiane sulle assunzioni dentro un intervallo di date, con un limite di 400 giorni. IMPORTANTE: una data senza risposta significa che nessuno ha detto nulla, il che NON equivale a una dose saltata. Non contare il silenzio come una dimenticanza.
`get_my_consumption` Quanto è stato preso di ogni voce	Quanto questa persona ha preso di ogni voce lungo un intervallo, raggruppato per voce E per unità. IMPORTANTE: non sommare queste cifre tra voci diverse né tra unità diverse, e non convertirle in milligrammi di un nutriente. Capsule, perle e millilitri sono cose diverse, e qui non esiste alcuna tabella di conversione da composto a elemento — una stima è tipicamente sette volte troppo alta, nella direzione che nasconde un avviso di limite massimo. Riporta le cifre così come arrivano.

Che cosa può leggere e che cosa no

Due autorizzazioni, da spuntare separatamente nella pagina di consenso, così la metà sulle prove può essere concessa senza quella personale.

Autorizzazione	Copre
`evidence.read`	integratori, benefici, risultati, sintesi degli studi, prodotti, marche. Nulla su di te.
`me.read`	i tuoi preferiti, il tuo stack attuale, i periodi conclusi e il tuo diario delle assunzioni.

Tutto è in sola lettura. Nessuno strumento scrive, modifica o cancella nulla, e il server non ha alcuna via di scrittura verso il database. Non custodisce nemmeno un proprio segreto: porta con sé il token che il tuo client ha ricevuto e nient'altro, e ogni decisione su che cosa quel token possa leggere la prende l'API, non questo server.

Il testo completo di un articolo non viene mai restituito. È soggetto a licenza, perciò gli strumenti restituiscono la sintesi di supp.fit e un collegamento all'articolo su PubMed.

Domande frequenti

Mi serve un account supp.fit per usare questo server MCP?

Sì. Ogni strumento richiede un account supp.fit con accesso effettuato, comprese le funzioni che leggono prove che il sito mostra a chiunque. Il tuo client MCP ti manda alla pagina di consenso, accedi con Google e scegli che cosa condividere.

Perché anche le prove pubbliche richiedono l'accesso?

Un assistente è un ciclo, e quasi ogni domanda utile mescola la metà pubblica con quella privata: che cosa dicono gli studi e che cosa prendi davvero. Una regola per tutti gli strumenti è una regola verificabile. Una valutazione diversa per ogni strumento è una cosa che prima o poi qualcuno dimentica.

Può modificare qualcosa nel mio account?

No. Ogni strumento è in sola lettura. Non esiste uno strumento che aggiunga un integratore al tuo stack, registri una dose, modifichi il tuo diario o cancelli qualcosa, e il server non ha alcuna via di scrittura verso il database.

Che cosa può leggere su di me?

Solo ciò che copre l'autorizzazione che hai concesso. L'autorizzazione evidence.read copre integratori, benefici, studi, prodotti e marche, e non dice nulla su di te. L'autorizzazione me.read copre i tuoi preferiti, il tuo stack attuale, i periodi conclusi e il tuo diario delle assunzioni. Sono caselle separate, quindi puoi concedere la metà sulle prove e trattenere quella personale.

Quali client possono collegarsi?

Qualsiasi client che parli il Model Context Protocol su Streamable HTTP e sappia seguire un flusso OAuth 2.1. Rientrano Claude, i connettori di ChatGPT e gli strumenti MCP da riga di comando. Il server è privo di stato, quindi non emette alcun identificatore di sessione e non apre alcun flusso di eventi.

Da dove vengono le prove?

Da studi pubblicati su PubMed, letti e riassunti su supp.fit. Ogni risultato porta con sé lo studio da cui proviene, così un assistente può citare l'articolo, l'anno e il numero di partecipanti invece di affermare qualcosa per propria autorità. Il testo completo dell'articolo non viene mai restituito, perché è soggetto a licenza.

Che cosa significa una tabella nutrizionale mancante?

Che il codice a barre del prodotto non è stato abbinato a un'etichetta registrata, non che il prodotto non abbia ingredienti. Le due cose appaiono identiche nei dati e significano l'opposto, perciò la descrizione dello strumento lo dice a parole e all'assistente viene detto di non riferire mai che un prodotto non contiene nulla.

Endpoint

URL	Che cos'è
`POST https://mcp.supp.fit/mcp`	la conversazione MCP. Un POST alla radice è la stessa cosa.
`GET https://mcp.supp.fit/.well-known/oauth-protected-resource`	dove ottenere un token, come lo descrive l'RFC 9728.
`https://api.supp.fit`	il server di autorizzazione. Emette ogni token che questo server spende.
`GET https://mcp.supp.fit/llms.txt`	questa pagina come testo semplice, per un agente che legge invece di navigare.