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