Nutrafol MCP server for AI agents
Let Claude, ChatGPT or your own agent read Nutrafol: 4 typed functions through one MCP server. No Nutrafol API key needed.
- Site
- nutrafol.com
- Functions
- 4
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Nutrafol alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/nutrafolOne MCP server for Nutrafol and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
assessHairWellnessScores Nutrafol's own Hair Wellness Quiz along its default answer path (Woman, then 'None of the above' / 'No' / the first option at every question)…Arguments
None.
Returns
HairWellnessAssessmentinterface RootCause { category: "Stress" | "Metabolism" | "Nutrition" | "Lifestyle" | "Hormone" | "Aging"; severity: string; // the site's own label: "NEEDS SUPPORT", "MODERATE" or "NORMAL" description: string | null; signs: string[]; // the tags of the answers behind it, as the site displays them } interface HairWellnessAssessment { rootCauses: RootCause[]; // in the order the results page renders them }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nutrafol/assessHairWellnessCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nutrafol.assessHairWellness();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nutrafol.assessHairWellness())curl -X POST https://api.bowmark.ai/v1/sites/nutrafol/assessHairWellness \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nutrafol.assessHairWellness();computeHairWellnessScores the caller's own quiz answers (question id -> option id) with the site's own branching and root-cause rules, returning exactly what…Arguments
Name Type Required answersRecord<string, string | string[]>Yes Returns
HairWellnessAssessmentinterface RootCause { category: "Stress" | "Metabolism" | "Nutrition" | "Lifestyle" | "Hormone" | "Aging"; severity: string; // the site's own label: "NEEDS SUPPORT", "MODERATE" or "NORMAL" description: string | null; signs: string[]; // the tags of the answers behind it, as the site displays them } interface HairWellnessAssessment { rootCauses: RootCause[]; // in the order the results page renders them }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nutrafol/computeHairWellnessCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nutrafol.computeHairWellness("<answers>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nutrafol.computeHairWellness("<answers>"))curl -X POST https://api.bowmark.ai/v1/sites/nutrafol/computeHairWellness \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"answers":"<answers>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nutrafol.computeHairWellness("<answers>");getQuizOverviewReads the Hair Wellness Quiz's own static intro page.Arguments
None.
Returns
QuizOverviewinterface QuizOverview { description: string; rootCauseCategories: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nutrafol/getQuizOverviewCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nutrafol.getQuizOverview();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nutrafol.getQuizOverview())curl -X POST https://api.bowmark.ai/v1/sites/nutrafol/getQuizOverview \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nutrafol.getQuizOverview();getQuizQuestionsLists every question the Hair Wellness Quiz can ask, with option ids and labels, so a caller can build answers for computeHairWellness.Arguments
None.
Returns
QuizQuestionSummary[]interface QuizQuestionSummary { id: string; // the key to use in computeHairWellness's answers path: "women" | "men" | "both"; type: "single" | "multi"; // multi takes an array of option ids text: string; options: { id: string; label: string }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nutrafol/getQuizQuestionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nutrafol.getQuizQuestions();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nutrafol.getQuizQuestions())curl -X POST https://api.bowmark.ai/v1/sites/nutrafol/getQuizQuestions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nutrafol.getQuizQuestions();
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/nutrafol/<function> - OpenAPI
/v1/sites/nutrafol/openapi.json