Model Context Protocol (MCP) Streamable HTTP endpoint exposing Oyster's Skin Intelligence Engine to partner chatbots. This is a single JSON-RPC 2.0 endpoint — every tool is invoked with method: "tools/call" and a params.name selecting the tool, so the tools are not separate REST URLs. Point any MCP-compatible client (Claude API connector, OpenAI Agents SDK, LangChain, custom) at this URL.

Authentication: send your vendor MCP token as Authorization: Bearer <token>. Generate it from your vendor dashboard (POST /vendors/mcp-tokens). The token is scoped to skin analysis only.

Available tools (params.name):

• analyze_skin — run a full AI skin analysis from 3 face photos
  (front, left, right). Synchronous, 30–120s; set your client tool
  timeout to ≥180s. Returns a batch_id plus the skin profile.
• generate_routine — build a personalized product routine from a
  completed scan's batch_id and quiz answers. Products come only from
  your synced catalogue.
• list_customer_scans — list a returning customer's scans by email
  (batch_id, scanned_at, has_routine).
• get_scan_results — recall a past scan's profile by batch_id. - get_routine — recall a previously generated routine by batch_id.

Errors: tool failures return a JSON-RPC result with isError: true whose text content is { "code", "message", "retryable", "details"? }.