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.

Functions
4
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Nutrafol

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/nutrafol
Every site

One MCP server for Nutrafol and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both 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.

Read 4
  • 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 HairWellnessAssessment

    interface 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/assessHairWellness

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    answersRecord<string, string | string[]>Yes

    Returns HairWellnessAssessment

    interface 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/computeHairWellness

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nutrafol.computeHairWellness("<answers>");
  • getQuizOverviewReads the Hair Wellness Quiz's own static intro page.

    Arguments

    None.

    Returns QuizOverview

    interface QuizOverview {
      description: string;
      rootCauseCategories: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nutrafol/getQuizOverview

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getQuizQuestions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nutrafol.getQuizQuestions();

Use it from code