GrailPeople MCP Connector

Connect ChatGPT, Claude, and other MCP-compatible AI assistants to GrailPeople's beauty knowledge base via the Model Context Protocol. Ask about skincare, makeup, and hair care — the connector returns real quotes and creator credentials from 11,000+ YouTube-reviewed products.

What it does

GrailPeople is a structured database of beauty products extracted from real YouTube creator videos — dermatologists, estheticians, makeup artists, and beauty creators. Every product is backed by direct quotes with timestamps, creator credentials, endorsement strength, and verified claims (fragrance-free, non-comedogenic, fungal-acne safe, and more).

The MCP connector makes this available to MCP-compatible AI assistants. When you ask a beauty question, the assistant can query the GrailPeople database and return creator-sourced evidence — not marketing copy.

Creator quotes and source links are attributed back to the original public videos. Creator-content correction and removal requests are handled through the Terms of Service.

Connecting

Use the Streamable HTTP endpoint below in ChatGPT, Claude, or another assistant that supports remote MCP connectors. GrailPeople is also listed in the Claude Connectors Directory. For Claude:

  1. Go to Claude.ai → Settings → Integrations
  2. Search for GrailPeople and click Connect
  3. No account or API key required — GrailPeople is a free, public knowledge base

Connecting manually (custom connector)

You can add GrailPeople as a custom connector using the Streamable HTTP endpoint:

https://grailpeople.com/api/mcp

Transport: Streamable HTTP · Auth: none · Protocol: MCP 2025-03-26

Tools

The connector exposes five composable tools. MCP-compatible assistants can route between them automatically based on the question — you never need to name a tool directly.

search_beauty_products
Search beauty products

Discovery tool — the default first call for any beauty, skincare, makeup, or hair question. Returns products ranked by creator endorsement strength, with creator credentials, quotes, consensus summaries, price, and retailers. Filters: ingredient, skin concern, price tier, verified claims (fragrance-free, non-comedogenic…), brand origin (K-beauty, French pharmacy…), finish, formulation, and more.

get_product_reviews
Get product evidence dossier

Depth tool — the full creator-evidence dossier for one named product. Returns every creator who mentioned it, their quotes and timestamps, endorsement strength, verified tags (claims, attributes, warnings), and a consensus summary. Use after search_beauty_products identifies a product.

get_brand_reviews
Get brand intelligence

Brand lens — verdict and reputation for one specific brand. Returns an AI-generated verdict from real creator quotes, signature products, brand-level tags, and origin (K-beauty, J-beauty, French pharmacy…). Use for 'is [brand] worth it?' or 'what should I buy from [brand]?'

get_creator_recommendations
Get a creator's picks

Creator lens — everything one specific creator endorses, with quotes and timestamps. Returns the creator's top picks sorted by endorsement strength, plus their overall tag tendencies (what concerns, attributes, and claims they talk about most). Use for 'what does [creator] recommend?'

find_brand_or_creator
Resolve brand or creator name to slug/handle

Name resolver — converts a messy brand or creator name (with tricky casing, accents, or partial names) into the slug or handle that other tools need. Call this first when you have a human-written name but not the exact slug. Returns matching brands and/or a creator so you can immediately pass the result to get_brand_reviews or get_creator_recommendations.

Example prompts

Once connected, you can ask questions like these:

What's the best vitamin C serum for hyperpigmentation under $40?

search_beauty_products with ingredient=vitamin c, concern=hyperpigmentation, max_price_usd=40

Is CeraVe a good brand for acne-prone skin?

get_brand_reviews for cerave — returns verdict + good_for tags for acne-prone

What skincare does Hyram actually recommend?

get_creator_recommendations for hyram with endorsed_only=true

Honest reviews of Rare Beauty Soft Pinch Liquid Blush

get_product_reviews — returns every creator quote, endorsement strength, and caveats

Best non-comedogenic foundation for oily skin — dermatologist-tested

search_beauty_products with verified=non_comedogenic, skin_type=oily, creator_type=dermatologist

Data & privacy

GrailPeople MCP tools are read-only. They do not collect or store any full conversation from ChatGPT, Claude, or another assistant. Queries hit the public GrailPeople API ( grailpeople.com/api/v1), which returns structured product data only. GrailPeople does not receive or store your full AI conversation, but standard request metadata may be logged briefly for security, debugging, and aggregate usage analysis as described in the Privacy Policy.

See our Privacy Policy for full details, including the MCP connector section.

Troubleshooting

A tool returns “not found”
Try find_brand_or_creator first to convert a brand or creator name to the exact slug/handle. Brand slugs are lowercase with hyphens (e.g. beauty-of-joseon); creator handles are lowercase without @ (e.g. hyram).
Results seem thin
Coverage is creator-sourced. If a claim (e.g. vegan, pregnancy-safe) isn't tagged, it means no creator stated it on camera — not that the product lacks it. For broader results, remove hard filters and use SOFT re-ranking params instead.
Connector not responding
The endpoint is https://grailpeople.com/api/mcp. If you see a timeout, try again — GrailPeople is hosted on Vercel serverless with a 15-second request timeout.
Still stuck?
Email hello@grailpeople.com.