# Papyras Catalog

> Structured, enriched product catalog exposed over MCP (Model Context Protocol).
> Query by intent, category, price, or free-text search and receive pre-enriched
> JSON — tags, relevance explanations, live pricing, verified affiliate links —
> without scraping or rendering HTML.

Endpoint: https://papyrasai.com/mcp
Transport: Streamable HTTP (current MCP standard)
Legacy SSE endpoint (older clients): https://papyrasai.com/mcp/sse
Discovery manifest: /.well-known/mcp.json
Full API reference: /api-docs.html
Plain technical index (for agents/developers): /agents.html
Human/brand-partnership overview (homepage): /

## Tools

- search_products: hybrid structured + semantic search. Params: query, category,
  brand, min_price, max_price, intent_tag, use_case_tag, audience_tag,
  availability, limit, offset. Defaults to in_stock only.
- get_product: full detail for one product by UUID. Returns regardless of
  stock status (direct lookup, not discovery).
- get_products_batch: fetch up to 100 products by UUID in one call.
- get_related_products: related/similar/accessory products by UUID. Currently
  returns an empty result set for all products (relationship data not yet
  generated) -- this is expected, not an error.
- get_feed_page: sequential full-catalog pagination for bulk export.

## Notes for querying

- Prefer natural-language phrases over single bare keywords in `query` --
  short single-word queries retrieve less accurately than descriptive phrases,
  since the embedding model has more context to place longer queries precisely.
- All monetary fields are returned as decimal strings, not floats.
- Enrichment tags (intent/use_case/audience) are LLM-generated per product --
  treat as a strong signal, not verified ground truth.
- Authentication is not yet enforced on this endpoint as of this writing.
  This is provisional; do not assume permanently open access in integrations
  intended to run long-term.

## Docs

- /agents.html -- plain technical landing page for agents/developers
- /api-docs.html -- full parameter tables and response schemas for every tool
- /.well-known/mcp.json -- machine-readable connection manifest