# Genius MCP

An MCP server for the official [Genius API](https://docs.genius.com/). It gives MCP clients searchable Genius song and artist metadata plus annotations.

## Tools

- `search` — search songs and other Genius documents.
- `get_song` — fetch song metadata and editorial description by Genius song ID.
- `get_artist` — fetch an artist profile and biography by Genius artist ID.
- `list_artist_songs` — list an artist's catalog, sorted by title or popularity.
- `get_annotations` — fetch annotations attached to a song, including lyric explanations when Genius exposes them.

The server deliberately uses the official API. It does not scrape or reproduce full copyrighted lyric text.

## Setup

Create a Genius API client at [genius.com/api-clients](https://genius.com/api-clients), then set the client access token:

```powershell
$env:GENIUS_ACCESS_TOKEN = "your-token"
npm install
npm run build
```

Run over stdio:

```powershell
npm start
```

## MCP client configuration

```json
{
  "mcpServers": {
    "genius": {
      "command": "node",
      "args": ["C:/path/to/genius-mcp/dist/index.js"],
      "env": {
        "GENIUS_ACCESS_TOKEN": "your-token"
      }
    }
  }
}
```

## Development

```powershell
npm run check
npm run smoke
```

## License

MIT