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.
- Site
- prose.com
- 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/proseEvery 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/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.
Read 3
getHaircareProductPriceLooks up ONE Prose product type's real one-time and subscription USD price (e.g. "shampoo", "hair_mask", "supplement_core").Arguments
Name Type Required typestringYes Returns
ProseHaircareProductinterface 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/getHaircareProductPriceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prose.getHaircareProductPrice("shampoo");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prose.getHaircareProductPrice("shampoo"))curl -X POST https://api.bowmark.ai/v1/sites/prose/getHaircareProductPrice \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"type":"shampoo"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prose.getHaircareProductPrice("shampoo");getHairPrescriptionRuns Prose's real online hair consultation end to end.Arguments
Name Type Required 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_texturestringThe 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_levelnumber0 (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_levelnumber0 (never flaky) to 4 (very flaky).Yes diag_sensitivity_levelnumber0 (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_freebooleanProse'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/getHairPrescriptionCall 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: [] });import asyncio from bowmark_web import bowmark result = asyncio.run(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": [] }))curl -X POST https://api.bowmark.ai/v1/sites/prose/getHairPrescription \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"answers":{"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":[]}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listHaircareProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prose.listHaircareProducts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prose.listHaircareProducts())curl -X POST https://api.bowmark.ai/v1/sites/prose/listHaircareProducts \ -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.prose.listHaircareProducts();
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/prose/<function> - OpenAPI
/v1/sites/prose/openapi.json