Prose MCP server for AI agents

Let Claude, ChatGPT or your own agent read Prose: 3 typed functions through one MCP server. No Prose API key needed.

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

Connect

Just Prose

An MCP server for Prose 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/prose
Every site

One MCP server for Prose 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 3
  • getHaircareProductPriceLooks up ONE Prose product type's real one-time and subscription USD price (e.g. "shampoo", "hair_mask", "supplement_core").

    Arguments

    NameTypeRequired
    typestringYes

    Returns ProseHaircareProduct

    interface ProseHaircareProduct {
      type: string;               // e.g. "shampoo", "conditioner", "hair_mask"
      category: string;
      subCategory: string;
      isCustom: boolean;          // true for a personalized formula, false for a fixed item
      isSubscribable: boolean;
      currency: string;           // "USD" once the account's profile_country is set
      price: number;
      subscribedPrice: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prose/getHaircareProductPrice

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prose.getHaircareProductPrice("shampoo");
  • getHairPrescriptionRuns Prose's real online hair consultation end to end.

    Arguments

    NameTypeRequired
    profile_age_range"20" | "30" | "40" | "50" | "60" | "70"Yes
    profile_zipcodestringYes
    profile_hydration"less_than_3_glasses" | "4_6_glasses" | "7_8_glasses" | "more_than_8_glasses"Yes
    profile_smoke_level"rarely" | "little" | "often"Yes
    profile_stress_level"never" | "little" | "moderately" | "lot"Yes
    profile_stress_causestring[]
    Life events in the last 3 months, if any.
    Yes
    profile_sportsstring[]Yes
    profile_diet_compositionstring[]Yes
    profile_hormonesstring[]Yes
    diag_hair_texturestring
    The site's own texture codes, e.g. "type_2b".
    Yes
    diag_hair_length"short" | "shoulder" | "long" | "very_long"Yes
    diag_hair_type"dry" | "normal" | "oily" | "oily_dry"Yes
    diag_split_ends"yes" | "no" | "not_sure"Yes
    diag_hair_porosity"low" | "medium" | "high"Yes
    diag_hair_thickness"thin" | "average" | "thick"Yes
    diag_density_levelnumber
    0 (sparse) to 4 (dense).
    Yes
    diag_hairloss_level"normal" | "bit_than_normal" | "excessive"Yes
    diag_hairloss_genetic"yes" | "no" | "not_sure"Yes
    diag_shampoo_frequency"once_a_week" | "every_2_3_days" | "every_day" | "less_once_a_week"Yes
    diag_regrease_delay"never" | "second_day" | "three_more_days" | "dont_know"Yes
    diag_scalp_type"balanced" | "dry" | "oily" | "not_sure"Yes
    diag_dandruff_levelnumber
    0 (never flaky) to 4 (very flaky).
    Yes
    diag_sensitivity_levelnumber
    0 (not sensitive) to 4 (very sensitive).
    Yes
    diag_gray_hair"none" | "few" | "half" | "full"Yes
    diag_color_treatmentsbooleanYes
    diag_color_treatments_location"full_head" | "partial" | "tips" | "not_applicable"Yes
    diag_color_treatments_typestring[]Yes
    diag_color_treatments_frequency| "every_month" | "two_three_months" | "few_a_year" | "just_started" | nullYes
    diag_other_treatmentsstring[]Yes
    diag_other_treatments_frequency| "every_month" | "two_three_months" | "few_a_year" | "just_started" | nullYes
    diag_stylingstring[]
    What the caller uses today, in the site's own catalog.
    Yes
    diag_styling_frequency"every_day" | "once_week" | "time_to_time"Yes
    diag_extensionsstring[]
    Protective styles / extensions; "none" is valid.
    Yes
    diag_hold_level"none" | "light" | "medium" | "not_sure"Yes
    diag_routine_effort"low" | "medium" | "high"Yes
    pref_veganbooleanYes
    pref_silicone"yes" | "no" | "low"Yes
    pref_fragrancestringYes
    pref_fragrance_freeboolean
    Prose's own twin field, true asks for no scent at all.
    Yes
    goalsArray< | "anti_brass" | "curl" | "hair_growth" | "hair_shedding" | "moisture" | "shine" | "straight" | "volume" >
    Does not ask for one.
    Yes

    Returns HairPrescription

    // One line of Prose's personalized-formula output, one product TYPE and where
    // it landed in the caller's routine.
    interface HairPrescriptionItem {
      category: string;
      type: string;                        // e.g. "shampoo", "curl_cream"
      // "main" is what the consultation tells the customer to buy today;
      // "inadvisable" is a product Prose's own engine advises AGAINST for this profile.
      section: "main" | "upsale" | "optional" | "featured" | "inadvisable" | string;
      quantity: number;
      currency: string | null;
      price: number | null;                // null when the type has no matching catalog entry
      subscribedPrice: number | null;
    }
    
    interface HairPrescription {
      items: HairPrescriptionItem[];
      coreRoutineTotal: number;            // one-time USD for every "main" item, today's basket
      coreRoutineSubscribedTotal: number;
      currency: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prose/getHairPrescription

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prose.getHairPrescription({
      profile_age_range: "20",
      profile_zipcode: "<profile_zipcode>",
      profile_hydration: "less_than_3_glasses",
      profile_smoke_level: "rarely",
      profile_stress_level: "never",
      profile_stress_cause: [],
      profile_sports: [],
      profile_diet_composition: [],
      profile_hormones: [],
      diag_hair_texture: "<diag_hair_texture>",
      diag_hair_length: "short",
      diag_hair_type: "dry",
      diag_split_ends: "yes",
      diag_hair_porosity: "low",
      diag_hair_thickness: "thin",
      diag_density_level: 1,
      diag_hairloss_level: "normal",
      diag_hairloss_genetic: "yes",
      diag_shampoo_frequency: "once_a_week",
      diag_regrease_delay: "never",
      diag_scalp_type: "balanced",
      diag_dandruff_level: 1,
      diag_sensitivity_level: 1,
      diag_gray_hair: "none",
      diag_color_treatments: true,
      diag_color_treatments_location: "full_head",
      diag_color_treatments_type: [],
      diag_color_treatments_frequency: "<diag_color_treatments_frequency>",
      diag_other_treatments: [],
      diag_other_treatments_frequency: "<diag_other_treatments_frequency>",
      diag_styling: [],
      diag_styling_frequency: "every_day",
      diag_extensions: [],
      diag_hold_level: "none",
      diag_routine_effort: "low",
      pref_vegan: true,
      pref_silicone: "yes",
      pref_fragrance: "<pref_fragrance>",
      pref_fragrance_free: true,
      goals: []
    });
  • listHaircareProductsLists every haircare formula/tool type Prose sells (shampoo, conditioner, hair mask, dry shampoo, leave-in, scalp serum, styling gel, curl cream…

    Arguments

    None.

    Returns ProseHaircareProduct[]

    interface ProseHaircareProduct {
      type: string;               // e.g. "shampoo", "conditioner", "hair_mask"
      category: string;
      subCategory: string;
      isCustom: boolean;          // true for a personalized formula, false for a fixed item
      isSubscribable: boolean;
      currency: string;           // "USD" once the account's profile_country is set
      price: number;
      subscribedPrice: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prose/listHaircareProducts

    Call it

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

Use it from code