Lyrenth

Servidor MCP de Lyrenth

Lee la web a través del índice de Lyrenth desde cualquier cliente MCP.

Expone tres herramientas:

• read_url convierte una página web pública en un AIDocument limpio: Markdown estable más título, descripción y estructura, con la navegación y el contenido repetitivo eliminados. Tu agente lee contenido limpio y de bajo consumo de tokens en lugar de HTML crudo, y cada resultado muestra cuántos tokens ahorró en comparación con la página original.
• read_urls hace lo mismo para hasta 20 URLs en una sola llamada por lotes.
• check_usage informa sobre tu nivel de plan y el uso de créditos.

Las lecturas se resuelven a través de la caché entre llamadas de Lyrenth y, para dominios verificados, devuelven la versión canónica del editor.

Cada herramienta declara las cuatro anotaciones de herramientas MCP (solo lectura, no destructiva, idempotente y mundo abierto o cerrado) como booleanos explícitos, y el transporte HTTP incluye una suite de 14 pruebas que cubre su postura de seguridad.

Alojado, sin instalación

Si tu cliente MCP admite servidores HTTP remotos con una cabecera personalizada (los conectores remotos de Claude y Cursor lo hacen), no hay nada que ejecutar:

• URL: https://api.lyrenth.com/mcp
• Cabecera: Authorization: Bearer aiwk_your_key_here

Las mismas tres herramientas, la misma clave. La ruta npx a continuación es para clientes que hablan MCP sobre stdio y para quienes prefieren un proceso local.

Configuración

1. Obtén una clave API gratuita en https://lyrenth.com/signup (2,000 lecturas/mes, sin tarjeta).
2. Añade el servidor a tu cliente MCP.

Claude Desktop (un clic)

Descarga lyrenth-mcp.mcpb desde la última versión y ábrela. Claude Desktop instala el servidor y solicita tu clave API; no hay archivo de configuración que editar. El paquete incluye el mismo código que el paquete npm.

Para compilarlo tú mismo: ./scripts/build-mcpb.sh.

Claude Desktop / Cursor (configuración manual)

Añade a tu configuración MCP (Claude Desktop: claude_desktop_config.json):

{
  "mcpServers": {
    "lyrenth": {
      "command": "npx",
      "args": ["-y", "lyrenth-mcp"],
      "env": { "LYRENTH_API_KEY": "aiwk_your_key_here" }
    }
  }
}

Claude Code

claude mcp add lyrenth -e LYRENTH_API_KEY=aiwk_your_key_here -- npx -y lyrenth-mcp

Luego pide a tu asistente que lea una página, por ejemplo: "Lee https://example.com/article y resúmela." Llamará a read_url y recibirá el AIDocument limpio.

Herramientas

Herramienta	Argumentos	Devuelve
read_url	url (cadena, obligatorio), fresh (booleano, opcional), max_tokens (entero, opcional)	La página como un AIDocument limpio: una cabecera breve de procedencia (recuento de tokens + cuánto más pequeño que el HTML crudo) más el cuerpo en Markdown. fresh: true fuerza una nueva obtención en lugar de la copia en caché; max_tokens limita el cuerpo a tu presupuesto de contexto, recortado en un límite limpio de párrafo u oración.
read_urls	urls (matriz de 1-20 cadenas, obligatorio), fresh (booleano, opcional), max_tokens (entero, opcional)	Hasta 20 páginas en una sola llamada, cada una como un AIDocument limpio, con aislamiento de errores por URL (una URL fallida se informa y no bloquea a las demás). Se factura un crédito por cada URL leída correctamente.
check_usage	ninguno	Tu nivel de plan, créditos usados contra tu límite mensual, créditos restantes y la fecha de reinicio.

Configuración

Variable de entorno	Obligatoria	Predeterminado	Notas
LYRENTH_API_KEY	sí	ninguna	Clave gratuita en https://lyrenth.com/signup
LYRENTH_API_URL	no	https://api.lyrenth.com	Anulación para staging o autoalojamiento

Por qué leer a través de Lyrenth

• Más limpio, más barato. Una forma estable de AIDocument por URL; muchos menos tokens que el HTML crudo para un modelo.
• En caché entre llamadas. La misma URL obtenida por muchos agentes se reduce a un número mínimo de obtenciones de origen, por lo que es rápida y respetuosa con el origen.
• Canónico cuando está verificado. Cuando el propietario de un sitio ha verificado con Lyrenth, obtienes la versión que ellos crearon, mantenida actualizada por su señal de cambios.

Privacidad

El servidor envía exactamente dos cosas a la API de Lyrenth (api.lyrenth.com): las URLs que le pides leer y tu clave API para autenticar y medir la llamada. Nada más sale de tu máquina: ningún contenido de página que tengas localmente, ningún contexto de conversación, ninguna telemetría. Cómo Lyrenth maneja las páginas obtenidas y los datos de cuenta está cubierto por la política de privacidad: https://www.lyrenth.com/privacy.

Licencia

MIT. Ver LICENSE.

Compilación local

npm install
npm run build
LYRENTH_API_KEY=aiwk_... node dist/index.js   # speaks MCP over stdio

Parte del proyecto Lyrenth. El formato AIDocument es un contrato abierto; ver https://lyrenth.com/llms-full.txt.