io.github.fulcrai/skb-mcp

Official10 tools

by fulcrai · Dockerfile

SkinKnowledgeBase Skincare Question and Answer MCP

Skincare Question and Answer with cited products, ingredients, sources, and comparison context.

Skincare Q&A with cited products, ingredients, sources, and comparison data.

Captured live from the server via tools/list.

search

Search public SkinKnowledgeBase content. Required input: query string. Optional inputs: entity_type (Question, Concern, Ingredient, Product, SideEffect, Source), deprecated type alias, limit 1-50, and cursor. Returns compact ranked public results with canonical URLs, snippets, matched fields, scores, and public-safe retrieval metadata. Use for skincare questions, ingredient/product lookup, cited source lookup, and comparison-page discovery.

Parameters (5)

querystringrequired
limitinteger
cursorstring
entity_typestring
Preferred entity type filter.
typestring
Deprecated alias for entity_type; kept for compatibility.

fetch

Fetch one public SkinKnowledgeBase resource. Required input: id, which may be a canonical SKB URL, public comparison URL, entity ULID, slug, or accepted comparison-page identifier. Returns public read-only text and structured data such as title, canonical URL, entity type, evidence sources, product fact sources, updated_at, and public-safe comparison metadata where applicable.

Parameters (1)

idstringrequired

search_questions

Search published public SkinKnowledgeBase Question pages. Required input: query string. Optional inputs: filters for concern, ingredient, product, or side_effect; limit 1-25; cursor. Returns public question search results with identifiers and canonical URLs for follow-up retrieval.

Parameters (4)

querystringrequired
filtersobject
limitinteger
cursorstring

get_question_bundle

Fetch a public SkinKnowledgeBase Question bundle. Required input: slug_or_id, accepting a question slug or ULID. Optional booleans include include_sources, include_products, and include_validation_summary. Returns the public question answer structure and requested linked public context.

Parameters (4)

slug_or_idstringrequired
include_sourcesboolean
include_productsboolean
include_validation_summaryboolean

get_entity

Fetch one public SkinKnowledgeBase entity. Required inputs: type (Question, Concern, Ingredient, Product, SideEffect, or Source) and slug_or_id (entity slug or ULID). Returns public entity details, canonical URL, text, and linked source/context fields where available.

Parameters (2)

typestringrequired
slug_or_idstringrequired

search_entities

Search public SkinKnowledgeBase entities. Required input: query string. Optional inputs: type (Question, Concern, Ingredient, Product, SideEffect, Source), limit 1-25, and cursor. Returns matching public entities with slugs/IDs and canonical URLs.

Parameters (4)

typestring
querystringrequired
limitinteger
cursorstring

get_ranked_products_for_question

Return public supporting product context for one eligible SkinKnowledgeBase Question. Required input: slug_or_id, accepting a question slug or ULID. Returns at most two relevant products with public fit/caveat context; it does not purchase, recommend as medical advice, or modify anything.

Parameters (1)

slug_or_idstringrequired

get_ranked_product_for_question

Deprecated read-only alias for get_ranked_products_for_question. Required input: slug_or_id, accepting a question slug or ULID. Returns the same public supporting product context, capped at two products, without modifying anything.

Parameters (1)

slug_or_idstringrequired

get_sources_for_question

Return public Source entities cited by one SkinKnowledgeBase Question. Required input: slug_or_id, accepting a question slug or ULID. Returns source records and canonical URLs used to support the public question page.

Parameters (1)

slug_or_idstringrequired

list_entities

List public SkinKnowledgeBase entities. Optional input: entity_type (Question, Concern, Ingredient, Product, SideEffect, or Source). Returns published MCP-eligible entity identifiers and metadata for discovery; it does not expose drafts or private/internal data.

Parameters (1)

entity_typestring

Install

claude_desktop_config.json

{
  "mcpServers": {
    "skb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.skinknowledgebase.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.