MCP

Lyra MCP server

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

你的 AI,连接到你的 Lyra

Lyra 为你自己的 AI 助手提供一条安全、私密的通道,通往你的数据。连接 Claude、ChatGPT 或 Gemini,它就能读取你精炼过的清单、你的定期购买、你的每月必需品和你的规划清单，并读取你正在查看的页面，完全不抓取任何东西。

两个服务器,一条通道

云端 MCP，你的账户数据. 托管于 lyrasearch.com/mcp,由你的付费账户解锁(OAuth 设备流程)。它只暴露你自己的数据，绝不涉及他人,绝不涉及完整的官方清单。

本地 MCP，你所在的页面. Lyra 应用在你的设备上运行一个极小的服务器(仅限本地回环,默认关闭)。你的 AI 读取已经用你的会话渲染好的页面，无需抓取,无需与反爬机制对抗,没有任何东西离开设备。

网页本身也可以提供自己的工具（WebMCP）。你的 AI 可以替你调用，但任何会执行操作的动作都会先在屏幕上请求你的确认。

你的 AI 能读取什么

  • 你自己的屏蔽清单和 Clean 清单
  • 你会回购什么,以及下次到期是何时
  • 你的每月必需品和支出
  • 你的规划／愿望清单(添加未来的购买)
  • 你正在查看的页面和你打开的标签页
  • 你的收藏夹和浏览历史记录（仅保存在设备上，绝不离开设备）

你始终掌控一切

读取是免费的。导航和添加到你自己的清单每个会话询问一次,之后便顺畅进行。任何代表你进行沟通或作出承诺的操作，购买、发送电子邮件或消息、提交表单、签署文件或推进一个法律流程，始终需要你在屏幕上明确批准,每一次都是。你的保险库和密码绝不会被暴露。

连接你的助手

端上(本地)服务器. 在 Lyra 应用中,打开 Settings → 本地 AI 服务器,将其开启,然后把地址和令牌复制到你的端上 AI 客户端中。

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