Genius MCP Server

Name: Genius MCP Server
Author: federicogarciav

@federicogarciav

リポジトリ

Genius MCP Server について

An MCP server that brings the power of Genius into your AI assistant.

#music #genius #mcp #lyricsgenius

基本情報

カテゴリ

その他

トランスポート

stdio

公開者

federicogarciav

投稿者

federicogarciav

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "genius": {
      "command": "python",
      "args": [
        "/absolute/path/to/genius-mcp/main.py"
      ],
      "env": {
        "GENIUS_ACCESS_TOKEN": "your_token_here",
        "STREAMABLE_HTTP": "false"
      }
    }
  }
}

ツール

Search Genius for songs matching a query. Returns song IDs, titles, artists, and annotation counts.

Fetch full metadata and editorial description for a song by its Genius ID.

Fetch all annotations for a song, optionally filtered by trust level (`artist_verified`, `accepted`, `unreviewed`).

Fetch the full text and metadata of a single annotation by its ID.

Fetch user-submitted questions and answers for a song, with pagination. Only questions that have an accepted answer are returned.

Fetch the musical relationships for a song — what it samples, interpolates, covers, remixes, or translates, and which later songs sampled or covered it. Only relationship types with at least one linked song are returned.

Fetch writing and production credits for a song: writers, producers, featured artists, and custom performance roles (e.g. mixing engineer, recording studio, label).

Search Genius for an artist by name. Returns artist IDs and basic profile info.

Fetch full profile and editorial bio for an artist by their Genius ID.

List songs by an artist, sortable by `popularity` or `release_date`, with pagination.

Retrieve the full discography of an artist as a paginated list of albums with album IDs.

Search Genius for albums matching a query. Returns album IDs, names, artist names, and release dates.

Fetch metadata, full ordered tracklist, and cover art list for an album by its Genius album ID. Each track includes its song ID for chaining into other tools. The first cover art is always the main album cover; annotated artworks include an `annotation_id`.

Fetch the full annotation written on a specific album cover art image — body text, trust level, authors, and vote count. Requires `cover_art_id` and `album_id` (both available from `get_album_details`). Only call for cover arts that have an `annotation_id`.

概要

What is Genius MCP Server?

An MCP server that brings the power of Genius into your AI assistant. It lets AI clients query songs, artists, lyrics annotations, album artwork annotations, song relationships, credits, and editorial knowledge through a clean set of tools and prompts.

How to use Genius MCP Server?

Obtain a Genius API Client Access Token from https://genius.com/api-clients, set it as GENIUS_ACCESS_TOKEN in .env, and choose a transport mode (STREAMABLE_HTTP for HTTP or stdio for desktop). Run with Python 3.11+ or Docker. Connect via claude mcp add for Claude Code or add a mcpServers entry in claude_desktop_config.json for Claude Desktop.

Key features of Genius MCP Server

Search songs and artists by name
Fetch full song metadata and editorial descriptions
Retrieve artist profiles and discography
Read lyric annotations with trust levels
Explore song relationships and credits
Run pre-built analysis prompts (analyze-song, artist-deep-dive)

Use cases of Genius MCP Server

Analyze the meaning and cultural context of a specific song
Deep‑dive into an artist’s biography, style, and discography
Research song credits, samples, and interpolations
Study album cover art annotations and symbolism
Integrate Genius music knowledge into AI‑powered writing or research tools

FAQ from Genius MCP Server

How do I get a Genius API token?

Go to https://genius.com/api-clients, sign in, create a new API client, and copy the Client Access Token.

What transport modes are supported?

The server supports Streamable HTTP (default, for remote clients) and stdio (for local desktop tools like Claude Desktop). Set STREAMABLE_HTTP in .env to true or false.

Which parts of the API are stable?

Tools labeled “Official API” use the documented api.genius.com endpoint. Tools using lyricsgenius (e.g., get_song_questions_and_answers, get_artist_albums, search_album, get_cover_art_annotations) access an undocumented public API and may change without notice.

What do annotation trust levels mean?

artist_verified (confirmed by the artist), accepted (reviewed by Genius editorial staff), and unreviewed (community‑submitted, not yet reviewed). The get_song_annotations tool can filter by trust level.

Can I run the server with Docker?

Yes. For Streamable HTTP use docker compose up --build. For stdio set STREAMABLE_HTTP=false and run docker run --rm -i --env-file .env $(docker build -q .).