MCP

Lyra MCP server

Connect Lyra to Claude Desktop, Cursor, Zed, Continue, ChatGPT custom GPTs, or any agent that speaks Model Context Protocol.

Your AI, connected to your Lyra

Lyra gives your own AI assistant a secure, private channel to your data. Connect Claude, ChatGPT or Gemini and it can read your refined lists, your recurring purchases, your monthly essentials and your planning list, and read the page you are looking at, without scraping anything.

Two servers, one channel

Cloud MCP: your account data. Hosted at lyrasearch.com/mcp and unlocked by your paid account (OAuth device flow). It exposes only YOUR own data, never other people’s, never the full official list.

Local MCP: the page you are on. The Lyra app runs a tiny server on your device (loopback only, off by default). Your AI reads the page already rendered with your session: no scraping, no anti-bot fights, nothing leaves the device.

Pages can also expose their own tools (WebMCP). Your AI may call them for you, but anything that acts still asks for your on-screen approval first.

What your AI can read

  • Your own block and Clean lists
  • What you rebuy and when it is next due
  • Your monthly essentials and spend
  • Your planning / wishlist (add future purchases)
  • The page you are viewing and your open tabs
  • Your favorites and browsing history (on-device only, never leaves the device)

You are always in control

Reads are free. Navigating and adding to your own lists ask once per session, then flow. Anything that communicates or commits on your behalf, such as buying, sending e-mail or messages, submitting forms, signing a document or routing a legal process, ALWAYS needs your express approval on-screen, every time. Your vault and passwords are never exposed.

Connect your assistant

On-device (local) server. In the Lyra app, open Settings → Local AI server, turn it on and copy the address and token into your on-device AI client.

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