Lyra MCP server

What is MCP?

MCP (Model Context Protocol) is an open spec from Anthropic for AI assistants to call tools on remote servers in a standardized way. Think USB-C for LLMs: any client speaks to any server.

Lyra runs an MCP server at https://lyrasearch.com/mcp. It exposes 15 tools covering the block list, the Clean brand list, personal lists, search, install links and ready-to-share messages. Public read-only tools work without auth; account-touching tools require a Bearer license key from /billing.

Why this exists

The Lyra browser extension blocks fast-fashion noise inside the user's own browser. The MCP server takes the same curated lists and makes them programmable from the agent layer:

• "Hey Claude, is shein.com on Lyra's block list?" → instant yes/no with category
• "Suggest sustainable alternatives for casual sneakers" → up to N curated brands
• "Search for kitchen knife sets but skip the dropshipping junk" → filtered DDG/Google URL
• "Add this brand I just discovered to my personal Clean list" → synced across all my devices
• "How do I install Lyra on Android?" → direct Play Store link

One source of truth, served everywhere.

Tools available

Public (no auth)

• list_blocked_domains
• list_clean_brands
• check_domain
• suggest_alternatives
• get_stats
• search_with_lyra
• get_install_links
• get_share_message

Authenticated (Bearer license key)

• submit_block_domain
• submit_clean_brand
• list_personal
• add_personal_block / remove_personal_block
• add_personal_clean / remove_personal_clean

Setup · Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "lyra": {
      "url": "https://lyrasearch.com/mcp",
      "headers": {
        "Authorization": "Bearer lyra_YOUR_LICENSE_KEY_HERE"
      }
    }
  }
}

The Authorization header is optional — needed only for personal-list and submit tools. Generate a key at /billing.

Setup · Cursor / Zed / Continue

These editors support MCP via streamable HTTP. Add this to your editor's MCP config:

{
  "lyra": {
    "transport": "http",
    "url": "https://lyrasearch.com/mcp"
  }
}

Setup · ChatGPT (Custom GPT)

ChatGPT doesn't speak MCP natively yet, but you can wrap our endpoints as a custom GPT Action. Use our OpenAPI 3 spec and import it directly into the GPT builder.

Quick test (curl)

List all tools without auth:

curl -X POST https://lyrasearch.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Check a domain:

curl -X POST https://lyrasearch.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
    "name":"check_domain",
    "arguments":{"domain":"shein.com","locale":"pt-BR"}
  }}'

Submit a domain to block (with license key):

curl -X POST https://lyrasearch.com/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer lyra_YOUR_KEY" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{
    "name":"submit_block_domain",
    "arguments":{"domain":"newpredator.com","reason":"dropshipping low-quality"}
  }}'

Localization

Every tool accepts a locale argument. Supported values: en, pt-BR, es, zh-CN, zh-TW, hi, ar, fr, bn, ru, id, ur, de, ja, vi, tr, ko, it, pl, nl, he.

When omitted, the server defaults to en. Category labels in the response are translated; brand names and domain identifiers stay canonical.

Ecosystem

The MCP server is one of four Lyra surfaces. All consume the same curated lists:

• Browser extension (Chrome, Edge, Brave) — filters at request time inside the user's browser
• Web app (lyrasearch.com) — Lyra Search with login + 20/day quota
• Public REST API (/api/docs) — same data via JSON GET endpoints
• MCP server (you are here) — programmable tools for AI agents

Roadmap

• Safari Web Extension (iOS + macOS) — Wave 6
• Lyra Browser app (Android) — Wave 7
• Lyra Browser app (iOS) — Wave 8
• AI search Pro tier (Perplexity-style answers grounded in Clean brands) — future