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