# io.github.smeet666/mcp-lrclib (npm · mcp-lrclib)

Search tracks on LRCLIB and fetch plain or time-synced (LRC) lyrics. No API key.

- Trust score: 74/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `mcp-lrclib`: 74/100 (this document), [markdown](https://verifymcp.io/servers/smeet666-mcp-lrclib/mcp-lrclib.md), [page](https://verifymcp.io/servers/smeet666-mcp-lrclib/mcp-lrclib)

## Channel facts

- Registry: `npm`
- Package: `mcp-lrclib`
- Version: `1.0.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to smeet666/mcp-lrclib).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 69/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 792 tokens (~264/item across 3 items; 3 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add smeet666-mcp-lrclib -- npx -y mcp-lrclib
```

### Codex

```bash
codex mcp add smeet666-mcp-lrclib -- npx -y mcp-lrclib
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "smeet666-mcp-lrclib": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-lrclib"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add smeet666-mcp-lrclib --command npx --arg -y --arg mcp-lrclib
```

### Hermes

```yaml
mcp_servers:
  smeet666-mcp-lrclib:
    command: "npx"
    args: ["-y", "mcp-lrclib"]
```

### Other

```json
{
  "mcpServers": {
    "smeet666-mcp-lrclib": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-lrclib"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 74)

First indexed and scored.

## MCP tools (3)

### `search_tracks` (~246 tokens)

Search tracks

Search LRCLIB for tracks by title, artist or album, and get the id needed to fetch lyrics with get_lyrics. Give either 'query' as free text, or 'track_name' and 'artist_name' separately for a narrower search. Results carry metadata only: title, artist, album, duration, and whether plain and time-synced lyrics exist. Use 'duration_seconds' and 'album_name' in the results to tell releases and re-recordings of the same song apart, and 'has_synced_lyrics' to know whether karaoke-style timed lyrics are available before fetching them. LRCLIB indexes tracks by their metadata, so it cannot search for a word appearing inside the lyrics.

Input parameters:

- `album_name` (string): Album name, to narrow a structured search.
- `artist_name` (string): Artist name, for a structured search.
- `limit` (integer): Maximum tracks to return. LRCLIB returns up to 20 per search.
- `query` (string): Free-text search, for example 'nino ferrer le sud'. Use this or the fields below.
- `track_name` (string): Song title, for a structured search.

Output parameters:

- `notes` (array)
- `result_count` (integer)
- `results` (array)
- `source` (string)
- `total_available` (integer): Tracks LRCLIB returned before applying 'limit'.

### `get_lyrics` (~346 tokens)

Get lyrics

Fetch the lyrics of one track from LRCLIB, given the id returned by search_tracks, or an exact artist and title. Set 'format' to "synced" for karaoke-style lyrics with a timestamp on every line, "plain" for the text alone, or "both". Check 'has_synced_lyrics' in the search results first: not every track has timed lyrics. Lyrics can be long, so the text is truncated by default: check 'truncated' and call again with 'offset' set to 'next_offset' to continue reading. Instrumental tracks come back with status "instrumental" and no text, which is a valid answer, so do not retry them. Always cite 'attribution' when showing lyrics to a user.

Input parameters:

- `album_name` (string): Album name, to pick between releases.
- `artist_name` (string): Artist name, matched exactly by LRCLIB. Required when 'id' is absent.
- `duration_seconds` (number): Track duration, to pick between versions of differing length.
- `format` (string): 'plain' returns the text only. 'synced' returns LRC text plus a parsed list of timestamped lines. 'both' returns each of them.
- `id` (integer): LRCLIB track id, as returned by search_tracks. Preferred over the name fields.
- `max_chars` (integer): Maximum characters of lyrics text to return in this call.
- `offset` (integer): Character offset to resume from, for lyrics longer than max_chars.
- `track_name` (string): Song title, matched exactly by LRCLIB. Required when 'id' is absent.

Output parameters:

- `attribution` (string)
- `next_offset`
- `notes` (array)
- `offset` (integer)
- `plain_lyrics` (string|null)
- `returned_chars` (integer)
- `source` (string)
- `status` (string)
- `synced_lines`: Parsed timestamped lines.
- `synced_lines_truncated` (boolean)
- `synced_lyrics` (string|null): Raw LRC text, one timestamp per line.
- `total_chars` (integer)
- `track` (object)
- `truncated` (boolean)

### `get_track` (~95 tokens)

Get track metadata

Look up one LRCLIB track by its id and return its metadata without the lyrics: title, artist, album, duration, and whether plain and time-synced lyrics exist. Use this to confirm you have the right release or version before calling get_lyrics, or to check whether timed lyrics exist for a track id you already hold.

Input parameters:

- `id` (integer, required): LRCLIB track id, as returned by search_tracks.

Output parameters:

- `duration_formatted` (string|null): Duration as m:ss, when known.
- `notes` (array)
- `source` (string)
- `track` (object)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/smeet666-mcp-lrclib/mcp-lrclib#diagnostics

## Score history

- 2026-08-03: 74

## Links

- npm package: https://www.npmjs.com/package/mcp-lrclib
- Socket report: https://socket.dev/npm/package/mcp-lrclib
- Repository: https://github.com/smeet666/mcp-lrclib
- Changelog RSS feed: https://verifymcp.io/servers/smeet666-mcp-lrclib/mcp-lrclib/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/smeet666-mcp-lrclib/mcp-lrclib/changelog.json
- HTML version of this page: https://verifymcp.io/servers/smeet666-mcp-lrclib/mcp-lrclib