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; 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)

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

Your personal lists (Bearer license key)

• 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 (Bearer license key)

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

On-device only (local server: page, tabs, favorites & history)

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

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