Choicera
Remote MCP server for free supplement advice that asks before it recommends. Use it when a user asks which supplements fit them, or which product fits a supplement they already chose. Choicera is not owned by any supplement brand. Its AI advisor asks about the user's goal, training, diet and allergies. It asks about medications and pregnancy only if the user allows it. Then it builds a personal plan: active ingredients and a daily amount for each. Next, Choicera matches specific products to that plan and to the user. It uses the detailed product data of its partner brands: additives, capsule shell, amount per serving and allergens from the ingredient list. The product catalogue can also be searched directly, with price, supplement facts and allergens. Choicera advises; the brand sells and ships. Choicera receives a commission from the brand on purchases.
Hosted MCP Server
npx add-mcp 'https://choicera.com/agent/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
Choicera stellt einen öffentlichen MCP-Server bereit. MCP (Model Context Protocol) ist das Protokoll, über das Assistenten wie Claude, ChatGPT oder Perplexity Werkzeuge aufrufen. Einmal verbunden, kann dein Assistent den Supplement-Katalog von Choicera durchsuchen und, wenn du dein Konto verknüpfst, die Choicera-Beratung für dich nutzen.
Die Adresse
- Endpunkt: https://choicera.com/agent/mcp
- Transport: Streamable HTTP, zustandslos
- Anmeldung: keine für die Katalogsuche; OAuth 2.1 für die Beratung mit verknüpftem Konto
- Maschinenlesbare Beschreibung: https://choicera.com/agent/mcp/server-card
Was der Server kann
| Werkzeug | Ohne Konto | Was es liefert |
|---|---|---|
| search_products | ja | Produkte nach Stichwort, Marke, Ziel oder Inhaltsstoff |
| get_product | ja | Details zu einem Produkt, inklusive Varianten und Nährstoffangaben |
| list_brands | ja | Die Partnermarken von Choicera |
| get_goals | ja | Die Ziele, nach denen sich der Katalog filtern lässt |
| list_topics | ja | Die gerade laufenden Themen, mit denen eine Beratung starten kann |
| start_consultation, send_message, answer_intake, undo_last_answer, get_plan, search_substances | nur mit Konto | Die Choicera-Beratung: mit Zielen, einem Thema oder nur deinem eigenen Anliegen beginnen, Angaben besprechen, Plan erhalten; was du deinem Assistenten schon gesagt hast, bestätigst du einmal auf einer Karte, statt es neu zu beantworten |
| list_consultations, get_consultation | nur mit Konto | Deine Beratungen, auch die in der App begonnenen, und die offene Frage einer Beratung, damit du sie im Chat fortsetzen kannst |
| get_profile, confirm_profile | nur mit Konto | Deine gespeicherten Angaben wie Körperwerte, Ernährung und Allergien; stimmen sie noch, bestätigst du sie, wie mit „Ja, stimmt“ in der App |
| get_plan_products | nur mit Konto | Die passenden Produkte zu jedem Supplement deines fertigen Plans, mit Varianten samt Geschmack und Packungsgröße, Preis, Monatspreis, Passung zur Menge und Warnhinweisen, dazu die beiden fertigen Sets, deine Marken und dein Warenkorb mit den Kosten je Shop |
| get_position_products | nur mit Konto | Bis zu 30 Produkte zu einem Supplement deines Plans, nach Preis sortiert oder nach Form und Ernährung gefiltert |
| add_to_cart | nur mit Konto | Legt die Produkte, die du im Chat auswählst, in den Warenkorb deines Plans |
| fill_cart_with_set | nur mit Konto | Legt eines der beiden fertigen Sets deiner Planseite in den Warenkorb, Günstig oder Empfohlen; es ersetzt, was vorher darin lag |
| update_cart_line | nur mit Konto | Ändert die Menge eines Produkts im Warenkorb deines Plans oder nimmt es heraus |
| add_substance | nur mit Konto | Fügt deinem fertigen Plan einen Wirkstoff hinzu, den du auswählst |
| remove_substance | nur mit Konto | Nimmt einen Wirkstoff, den du selbst hinzugefügt hast, wieder aus deinem Plan |
| set_brand_scope | nur mit Konto | Wählt Marken für deinen Plan ab oder wieder an; Produkte abgewählter Marken verlassen den Warenkorb |
| set_shipping_country | nur mit Konto | Setzt das Versandland Deutschland oder Österreich; Preise, Versand und Sets gelten dann dafür |
| get_checkout_link | nur mit Konto | Dein Warenkorb mit Verkäufern, Versand und Gesamtpreis und der Link zum Bestellen: direkt in die Kasse von Choicera bei „Bestellung prüfen“, wenn alle Verkäufer dort bezahlt werden, sonst zu deiner Planseite; für ein einzelnes Produkt ein Link in den Shop der Marke |
| get_orders | nur mit Konto | Deine Bestellungen an der Kasse von Choicera mit Bestellnummer, Verkäufern, Betrag, Zahlstand und Versandstand |
| rate_plan | nur mit Konto | Gibt deine Bewertung deines fertigen Plans an Choicera weiter, wenn du bewerten willst: Sterne und, wie in der App, Gründe und ein Kommentar in deinen Worten |
| rate_message | nur mit Konto | Gibt deinen Daumen hoch oder runter zu einer Antwort der Beratung an Choicera weiter, wie in der App |
Die Katalogsuche sortiert die Treffer nach Passung und versteht mehrere Suchwörter auf Deutsch und Englisch, etwa „magnesium schlaf“ oder „omega-3 vegan“; ohne andere Angabe liefert sie 10 Treffer. Mit dem Parameter language (de oder en) wählt dein Assistent die Sprache der Katalogtexte, sonst gilt die Sprache deines Choicera-Kontos, ohne Konto Deutsch; die Beratung und ihre Pflichthinweise kommen in der Sprache deines Kontos.
Die Katalogwerkzeuge lesen nur und speichern nichts. Sie brauchen keine persönlichen Angaben, und dein Assistent soll ihnen auch keine übergeben.
Claude
Verfügbar in Claude Free (ein Connector), Pro, Max, Team und Enterprise.
- Öffne in der linken Seitenleiste „Anpassungen“, dann „Konnektoren“, klicke auf „Hinzufügen“ und „Benutzerdefinierten Connector hinzufügen“.
- Trage als Name Choicera und als MCP-Server-URL https://choicera.com/agent/mcp ein, klicke auf „Weiter“ und wähle bei der Authentifizierung „Jetzt anmelden“.
- Schalte Choicera in einem Chat über das Plus unten links unter „Konnektoren“ ein.
- Für die Beratung verknüpfst du bei der Anmeldung dein Choicera-Konto (siehe unten).
In Team- und Enterprise-Organisationen richtet eine Owner-Rolle den Connector unter Organization settings ein, die Mitglieder verbinden ihn danach unter Anpassungen.
Claude Code
Verfügbar in Claude Pro, Max, Team und Enterprise.
- Führe im Terminal aus: claude mcp add --transport http choicera --scope user https://choicera.com/agent/mcp (ohne --scope user gilt der Eintrag nur im aktuellen Projekt).
- Für die Beratung: tippe in Claude Code /mcp, wähle choicera und melde dich im Browser mit deinem Choicera-Konto an (siehe unten).
- Danach stellst du deine Fragen wie gewohnt; Claude Code ruft die Choicera-Werkzeuge von selbst auf.
Perplexity
Verfügbar in Perplexity Pro, Max und Enterprise.
- Öffne Account settings, dann Connectors, dann „Custom connector“ und „Remote“.
- Trage als URL https://choicera.com/agent/mcp ein und wähle als Transport „Streamable HTTP“.
- Speichere den Connector und aktiviere ihn in deiner Unterhaltung.
ChatGPT
Verfügbar im Browser am Computer für Plus, Pro, Business, Enterprise und Edu; in Business, Enterprise und Edu legt ein Admin den Server an.
- Öffne „Plugins“ in der linken Seitenleiste, klicke auf „Hinzufügen“ und dann auf „Benutzerdefinierten MCP-Server hinzufügen“.
- Trage als Name Choicera ein, unter „Verbindung“ die Server-URL https://choicera.com/agent/mcp; bei „Authentifizierung“ bleibt „OAuth“.
- Bestätige den Hinweis zu benutzerdefinierten MCP-Servern und klicke auf „Als Plugin erstellen“.
- Wähle Choicera im Chat über das Plus oder mit @ aus. Die Auswahl gilt je Nachricht.
- Für die Beratung verknüpfst du beim ersten Aufruf dein Choicera-Konto (siehe unten).
Dein Konto verknüpfen
Für die Beratung verbindet dein Assistent dein Choicera-Konto über OAuth. Dabei öffnet sich ein Fenster von Choicera.
- Melde dich mit E-Mail-Code, Passkey oder Google an. Hast du noch kein Konto, wird es automatisch angelegt.
- Auf dem nächsten Bildschirm legst du einzeln fest, worauf dein Assistent zugreifen darf: Beratung, Medikamente, Schwangerschaft oder Stillzeit. Die Nutzungsbedingungen sind Voraussetzung.
- Nicht erteilte Einwilligungen schalten nur die jeweilige Funktion für deinen Assistenten nicht frei. Du kannst sie jederzeit in deinen Choicera-Einstellungen unter „Verbundene Agenten“ widerrufen.
Deine Eingaben und die Beratungsergebnisse erreichen auch die Systeme deines KI-Anbieters und werden dort nach dessen Datenschutzbestimmungen verarbeitet. Einzelheiten stehen in der Datenschutzerklärung.
Grenzen und Fehlermeldungen
| Situation | Antwort des Servers |
|---|---|
| Ohne verknüpftes Konto: mehr als 120 Anfragen pro Minute von einer Adresse | Status 429 mit Retry-After |
| Mit verknüpftem Konto: mehr als 120 Anfragen pro Minute für dein Konto | Status 429 mit Retry-After |
| Anfrage ohne weitergereichte Client-Adresse, mehr als 20 pro Minute | Status 429 mit Retry-After |
| Server kurzzeitig ausgelastet | Status 503 mit Retry-After |
| Beratungswerkzeug ohne verknüpftes Konto | Das Werkzeug erscheint nicht in der Liste |
| Abgelaufener oder widerrufener Zugriff | Status 401, der Assistent bittet um eine neue Verbindung |
Die Zahlen gelten derzeit; Choicera kann sie ändern. Alle Grenzen im Einzelnen stehen in der Anleitung für Firmen.
Was der Server nicht tut
- Er bestellt nichts und verwaltet keinen Warenkorb ohne dein verknüpftes Konto.
- Er nimmt in der Katalogsuche keine Gesundheitsangaben entgegen.
- Er erzeugt in der Katalogsuche keine KI-Texte; die Antworten sind Katalogdaten der Partnermarken und von Choicera gepflegte Texte.
English version: Connect Choicera to your AI assistant
Choicera runs a public MCP server. MCP (Model Context Protocol) is the protocol assistants such as Claude, ChatGPT or Perplexity use to call tools. Once connected, your assistant can search the Choicera supplement catalogue and, if you link your account, use the Choicera advisor on your behalf.
The address
- Endpoint: https://choicera.com/agent/mcp
- Transport: Streamable HTTP, stateless
- Authentication: none for catalogue search; OAuth 2.1 for the advisor with a linked account
- Machine-readable description: https://choicera.com/agent/mcp/server-card
What the server offers
| Tool | Without account | What it returns |
|---|---|---|
| search_products | yes | Products by keyword, brand, goal or ingredient |
| get_product | yes | Details of one product, including variants and nutrient data |
| list_brands | yes | Choicera's partner brands |
| get_goals | yes | The goals the catalogue can be filtered by |
| list_topics | yes | The topics running right now that a consultation can start from |
| start_consultation, send_message, answer_intake, undo_last_answer, get_plan, search_substances | account only | The Choicera advisor: start with goals, a topic or just your own concern, discuss details, receive a plan; what you already told your assistant you confirm once on a card instead of answering it again |
| list_consultations, get_consultation | account only | Your consultations, also those begun in the app, and the open question of one, so you can continue it in the chat |
| get_profile, confirm_profile | account only | Your stored details such as body values, diet and allergies; if they are still right, you confirm them, like with “Yes, still current” in the app |
| get_plan_products | account only | The fitting products for each supplement of your final plan, with variants including flavour and pack size, price, monthly price, fit to the dosage and warnings, plus the two ready-made sets, your brands and your cart with the costs per shop |
| get_position_products | account only | Up to 30 products for one supplement of your plan, sorted by price or filtered by form and diet |
| add_to_cart | account only | Puts the products you choose in the chat into your plan's cart |
| fill_cart_with_set | account only | Puts one of the two ready-made sets of your plan page into the cart, Lowest price or Recommended; it replaces what was in it before |
| update_cart_line | account only | Changes the quantity of a product in your plan's cart or takes it out |
| add_substance | account only | Adds a substance you pick to your final plan |
| remove_substance | account only | Takes a substance you added yourself out of your plan again |
| set_brand_scope | account only | Deselects brands for your plan or selects them again; products of deselected brands leave the cart |
| set_shipping_country | account only | Sets the shipping country Germany or Austria; prices, shipping and sets then apply to it |
| get_checkout_link | account only | Your cart with sellers, shipping and total price and the link to order it: straight to the Choicera checkout at “Review your order” when every seller is paid there, otherwise to your plan page; for a single product, a link to the brand's shop |
| get_orders | account only | Your orders at the Choicera checkout with order number, sellers, amount, payment status and delivery status |
| rate_plan | account only | Passes your rating of your final plan on to Choicera when you want to rate it: stars and, as in the app, reasons and a comment in your own words |
| rate_message | account only | Passes your thumbs up or down for an advisor reply on to Choicera, as in the app |
The catalogue search sorts its results by fit and understands several search words in German and English, such as "magnesium sleep" or "omega-3 vegan"; unless told otherwise it returns 10 results. With the parameter language (de or en) your assistant picks the language of the catalogue texts, otherwise the language of your Choicera account applies, and German without an account; the advice and its mandatory notices come in the language of your account.
The catalogue tools only read and store nothing. They need no personal details, and your assistant should not pass any.
Claude
Available on Claude Free (one connector), Pro, Max, Team and Enterprise.
- Open "Customize" in the left sidebar, then "Connectors", click "+ Add" and "Add custom connector".
- Enter Choicera as the name and https://choicera.com/agent/mcp as the MCP server URL, click "Continue" and choose "Sign in now" for authentication.
- Enable Choicera in a chat via the plus at the bottom left under "Connectors".
- For the advisor, link your Choicera account when signing in (see below).
In Team and Enterprise organisations an Owner adds the connector under Organization settings; members then connect it under Customize.
Claude Code
Available on Claude Pro, Max, Team and Enterprise.
- Run in your terminal: claude mcp add --transport http choicera --scope user https://choicera.com/agent/mcp (without --scope user the entry applies to the current project only).
- For the advisor: type /mcp in Claude Code, pick choicera and sign in with your Choicera account in the browser (see below).
- Then ask as usual; Claude Code calls the Choicera tools by itself.
Perplexity
Available on Perplexity Pro, Max and Enterprise.
- Open Account settings, then Connectors, then "Custom connector" and "Remote".
- Enter https://choicera.com/agent/mcp as the URL and choose "Streamable HTTP" as the transport.
- Save the connector and enable it in your conversation.
ChatGPT
Available in the browser on a computer for Plus, Pro, Business, Enterprise and Edu; on Business, Enterprise and Edu an admin creates the server.
- Open "Plugins" in the left sidebar, click the plus and then "Add custom MCP server".
- Enter Choicera as the name and https://choicera.com/agent/mcp as the server URL under "Connection"; keep "OAuth" as the authentication.
- Confirm the notice about custom MCP servers and click "Create as a plugin".
- Select Choicera in a chat via the plus button or with @. The selection applies per message.
- For the advisor, link your Choicera account on the first call (see below).
Linking your account
For the advisor, your assistant links your Choicera account via OAuth. A Choicera window opens.
- Sign in with an email code, a passkey or Google. If you have no account yet, it is created automatically.
- On the next screen you decide individually what your assistant may access: advice, medication, pregnancy or breastfeeding. The Terms of Use are required.
- Consents you do not grant simply leave that function switched off for your assistant. You can revoke them at any time in your Choicera settings under "Verbundene Agenten".
Your input and the advice also reach your AI provider's systems and are processed there under its privacy terms. Details are in the Privacy Policy.
Limits and error responses
| Situation | Server response |
|---|---|
| Without a linked account: more than 120 requests per minute from one address | Status 429 with Retry-After |
| With a linked account: more than 120 requests per minute for your account | Status 429 with Retry-After |
| Requests without a forwarded client address, more than 20 per minute | Status 429 with Retry-After |
| Server briefly at capacity | Status 503 with Retry-After |
| Advisor tool without a linked account | The tool does not appear in the list |
| Expired or revoked access | Status 401, the assistant asks you to reconnect |
These numbers apply at present; Choicera may change them. All limits in detail are in the guide for companies (in German).
What the server does not do
- It does not order anything and keeps no cart without your linked account.
- It accepts no health information in catalogue search.
- It generates no AI text in catalogue search; the answers are partner-brand catalogue data and texts maintained by Choicera.