Servidor MCP da Lyra

O que é MCP?

MCP (Model Context Protocol) é uma especificação aberta da Anthropic pra assistentes de IA chamarem ferramentas em servidores remotos de forma padronizada. Pense em USB-C pra LLMs: qualquer cliente fala com qualquer servidor.

A Lyra roda um servidor MCP em https://lyrasearch.com/mcp. Ele expõe ferramentas para consultas que respeitam a privacidade (um domínio específico está bloqueado ou Clean?), alternativas curadas, busca filtrada, links de instalação, mensagens prontas pra compartilhar e as suas listas pessoais. As listas oficiais de bloqueio e Clean são privadas, então o MCP nunca as devolve por inteiro, só respostas item a item. Ferramentas públicas (só leitura) funcionam sem autenticação; ferramentas que mexem em conta pedem uma chave Bearer obtida em /billing.

Por que isso existe

A extensão da Lyra bloqueia o ruído de fast-fashion dentro do navegador do usuário. O servidor MCP pega as mesmas listas curadas e as torna programáveis na camada dos agentes:

• "Claude, a shein.com está na lista de bloqueio da Lyra?" → resposta sim/não na hora, com categoria
• "Sugira alternativas sustentáveis pra tênis casual" → até N marcas curadas
• "Busque conjuntos de facas de cozinha mas pule dropshipping ruim" → URL do DDG/Google já filtrada
• "Adicione esta marca que descobri à minha lista Clean pessoal" → sincronizado em todos os meus dispositivos
• "Como instalo a Lyra no Android?" → link direto da Play Store

Uma fonte de verdade, servida em todo lugar.

Ferramentas disponíveis

Públicas (sem autenticação)

• check_domain
• suggest_alternatives
• get_stats
• search_with_lyra
• get_install_links
• get_share_message

Suas listas pessoais (chave Bearer)

• 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

Seus dados de compra e planejamento (chave Bearer)

• get_recurring_purchases
• get_monthly_essentials
• get_shopping_plan
• list_future_purchases
• add_to_plan / remove_from_plan

Só no dispositivo (servidor local: página, abas, favoritos e histórico)

• get_current_page
• list_tabs
• get_favorites
• get_history
• list_page_tools
• call_page_tool

Configurar · Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "lyra": {
      "url": "https://lyrasearch.com/mcp",
      "headers": {
        "Authorization": "Bearer lyra_YOUR_LICENSE_KEY_HERE"
      }
    }
  }
}

O cabeçalho Authorization é opcional, só precisa pras ferramentas de lista pessoal e submissão. Gere uma chave em /billing.

Configurar · Cursor / Zed / Continue

Esses editores suportam MCP via HTTP streaming. Adicione isso na configuração MCP do seu editor:

{
  "lyra": {
    "transport": "http",
    "url": "https://lyrasearch.com/mcp"
  }
}

Configurar · ChatGPT (GPT personalizado)

O ChatGPT ainda não fala MCP nativamente, mas dá pra envolver nossos endpoints como uma Action de GPT customizado. Use nossa spec OpenAPI 3 e importe direto no GPT builder.

Teste rápido (curl)

Lista todas as ferramentas sem autenticação:

curl -X POST https://lyrasearch.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Verifica um domínio:

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"}
  }}'

Submete um domínio pra bloquear (com chave de licença):

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"}
  }}'

Idiomas

Toda ferramenta aceita um argumento locale. Valores suportados: en, pt-BR, es, zh-CN, zh-TW, hi, ar, fr, bn, ru, id, ur, de, ja, vi, tr, ko, it, pl, nl, he.

Quando omitido, o servidor usa en como padrão. Os rótulos de categoria na resposta são traduzidos; nomes de marca e identificadores de domínio permanecem canônicos.

Ecossistema

O servidor MCP é uma das quatro superfícies da Lyra. Todas consomem as mesmas listas curadas:

• Extensão de navegador (Chrome, Edge, Brave): filtra em tempo real dentro do navegador do usuário
• App web (lyrasearch.com): Lyra Search com login + cota de 20/dia
• API REST pública (/api/docs): mesmos dados via endpoints JSON GET
• Servidor MCP (você está aqui): ferramentas programáveis pra agentes de IA