@pipeworx/genius

Genius MCP — metadatos de canciones / artistas / álbumes, búsqueda y descripciones de anotaciones de Genius. El texto de las letras no lo devuelve la API de Genius (licencias) — este paquete devuelve títulos, IDs, estadísticas, URLs de páginas de Genius y descripciones "about".

Parte de Pipeworx — una puerta de enlace MCP que conecta agentes de IA a 1476+ fuentes de datos en vivo.

Herramientas

• search(query, limit?) — búsqueda por palabras clave; devuelve coincidencias de metadatos de canciones

• get_song(id) — metadatos de la canción (título, artista, álbum, fecha de lanzamiento, visitas, about)

• get_artist(id) — metadatos del artista (nombre, seguidores, nombres alternativos, about)

• artist_songs(artist_id, limit?) — canciones de un artista, ordenadas por popularidad

_apiKey es opcional en cada herramienta — omítelo para usar la clave de la plataforma.

Related MCP server: mcp-lyrics-ovh

Autenticación

• Clave de la plataforma: inyectada por la puerta de enlace cuando se omite _apiKey.

• BYO: pasa _apiKey=<token> tras registrar un Client Access Token gratuito en https://genius.com/api-clients.

Se envía como Authorization: Bearer <token> en cada solicitud.

Fuente de datos

https://api.genius.com — token de acceso Bearer.

Inicio rápido

Añade a tu cliente MCP (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "genius": {
      "url": "https://gateway.pipeworx.io/genius/mcp"
    }
  }
}

Qué ofrece realmente este endpoint

tools/list en https://gateway.pipeworx.io/genius/mcp devuelve las herramientas de la tabla anterior más las meta-herramientas compartidas de Pipeworx — ask_pipeworx, discover_tools, search_within, remember/recall y el resto del conjunto de toda la puerta de enlace. Por lo tanto, el número de herramientas que ves es mayor que el de esta tabla: un endpoint de un solo paquete enumera actualmente unas 30 herramientas compartidas junto con las propias del paquete. La respuesta initialize de la conexión indica su alcance exacto y es la respuesta autoritativa para un día determinado.

Esto es deliberado, no una multiplexación accidental. Las meta-herramientas son lo que permiten a una conexión acotada responder una pregunta que este paquete no cubre — a través de ask_pipeworx, que enruta por todo el catálogo — sin que añadas un segundo servidor MCP. Actualmente no hay forma de montar un endpoint de paquete sin ellas; si los esquemas extra te cuestan más contexto de lo que vale el enrutamiento, conéctate a la puerta de enlace completa en lugar de a varios endpoints de paquete.

O conéctate a la puerta de enlace completa de Pipeworx para tener listadas directamente las herramientas de todos los paquetes, en lugar de solo las de este:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

Ambas URLs llegan a la misma puerta de enlace y a las mismas 1476+ fuentes de datos. La única diferencia es de qué paquete se listan las herramientas directamente; ask_pipeworx llega a todas desde cualquiera de las dos.

Uso con ask_pipeworx

En lugar de llamar a las herramientas directamente, puedes hacer preguntas en inglés sencillo — esto funciona tanto en el endpoint del paquete anterior como en la puerta de enlace completa:

ask_pipeworx({ question: "your question about Genius data" })

La puerta de enlace elige la herramienta adecuada y rellena los argumentos automáticamente.

Más

• Documentación y guías

• pipeworx.io

Licencia

MIT