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 tools for privacy-respecting lookups (is a specific domain blocked or Clean?), curated alternatives, filtered search, install links, ready-to-share messages and your personal lists. The official block and Clean lists are private, so the MCP never returns them in full, only per-item answers. Public read-only tools work without auth; your own lists and shopping data are unlocked by signing in with OAuth (one-click, no key to copy).

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 login (free daily quota)

• check_domain
• suggest_alternatives
• get_stats
• search_with_lyra
• get_install_links
• get_share_message

Your lists — read & write (sign in with OAuth)

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

Your shopping data & planning — reads, plus writes that show a real-time notice + Undo in the Lyra app (sign in with OAuth)

• get_recurring_purchases
• get_monthly_essentials
• get_shopping_plan
• list_future_purchases
• add_to_plan / remove_from_plan

On-device only (page, tabs, favorites & history). Actions that touch the outside world — buying, sending, submitting — are NOT available here; they always need your express on-screen confirmation in Lyra.

• get_current_page
• list_tabs
• get_favorites
• get_history
• list_page_tools
• call_page_tool

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"
      }
    }
  }
}

Public read-only tools work with no header. For your own lists and shopping data, connect with OAuth (one-click sign-in to your Lyra account — no key to copy): the client opens Lyra, you approve, done. A manual Bearer key from /billing is only for scripts/CLIs that can't open a browser.

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 (MCP connector or Custom GPT)

ChatGPT now speaks MCP: in Developer Mode / Connectors, add the server URL https://lyrasearch.com/mcp and authorize with OAuth (one-click, no key). If your plan doesn't show MCP connectors, wrap our OpenAPI 3 spec as a custom GPT Action instead.

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

Lyra has four ways to use it — all on the same curated lists:

• Extension (Chrome, Edge, Brave): filters in real time inside the browser
• DNS (Lyra Safe DNS): cleans every app on the device
• App (Android, iPhone, Mac, PC): the native Lyra browser
• Site (lyrasearch.com): Lyra Search on the web, with login