tira-mcp

MCP server for Tira Beauty — search products, get details, compare prices, and analyze ingredients right from your AI assistant.

No authentication. No browser. No API keys. Just install and go.

Install

Claude Code

claude mcp add tira -- bunx tira-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "tira": {
      "command": "bunx",
      "args": ["tira-mcp"]
    }
  }
}

Cursor / VS Code

Add to your MCP settings:

{
  "mcpServers": {
    "tira": {
      "command": "bunx",
      "args": ["tira-mcp"]
    }
  }
}

Standalone

bunx tira-mcp
# or
npx tira-mcp

Tools

search_products

Search products by keyword, brand, or category.

query     string   required   "lipstick", "niacinamide serum", "Minimalist foundation"
limit     number   5          Max results (1-20)
sort_by   enum     relevance  relevance | price_asc | price_desc | discount

get_product_details

Get full details for a product — pricing, ingredients, description, variants.

product_id   string   Product slug from search results
url          string   Full Tira product URL (alternative to product_id)

batch_get_prices

Quick price + stock check for up to 20 products at once.

product_ids   string[]   Array of product slugs (max 20)

analyze_ingredients

Break down a product's ingredient list into actives, base ingredients, and flags.

product_id   string   Product slug to analyze

Detects 46+ active ingredients (niacinamide, retinol, hyaluronic acid, vitamin C, etc.) and 16+ flagged ingredients (parabens, sulfates, formaldehyde, etc.).

How it works

Uses Tira's public Fynd Platform APIs — no authentication needed:

1. Search API — fast product search with full metadata
2. Autocomplete API — fallback product discovery
3. HTML fallback — page scraping as last resort

All unauthenticated. No browser automation, no Playwright.

Development

git clone https://github.com/ashfaqmehmood/tira-mcp.git
cd tira-mcp
bun install
bun run dev        # watch mode
bun run build      # compile to build/
bun test           # run tests

Configuration

All optional — works out of the box.

License

MIT