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を接続すれば、洗練されたリスト、定期的な購入、毎月の必需品、そしてプランニングリストを読み取り，さらにあなたが見ているページも読み取れます，何もスクレイピングすることなく。

2つのサーバー、1つのチャンネル

クラウド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