Last.fm MCP server

lastfm-mcp

An MCP server for the Last.fm API, built on go-lastfm/v2 and the official Go MCP SDK.

It exposes the complete supported Last.fm surface as discoverable MCP tools over:

• stdio, for local desktop and CLI clients;
• Streamable HTTP, for local services and remote deployments.

Read-only tools are enabled by default. Writes, authentication helpers, and unsupported legacy methods require explicit opt-in.

Status

This project is prepared for its initial repository import. The module path is github.com/ndyakov/lastfm-mcp; change it before the first release if the repository will use a different owner or name.

Requirements

• Go 1.25 or later
• A Last.fm API account
• LASTFMAPIKEY
• LASTFMAPISECRET and LASTFMSESSIONKEY only when write tools are enabled

Run with stdio

export LASTFM_API_KEY="your-api-key"
go run ./cmd/lastfm-mcp

Example MCP client configuration:

{
  "mcpServers": {
    "lastfm": {
      "command": "/absolute/path/to/lastfm-mcp",
      "env": {
        "LASTFM_API_KEY": "your-api-key"
      }
    }
  }
}

Never place credentials in a configuration file that will be committed.

Run with Streamable HTTP

export LASTFM_API_KEY="your-api-key"
export LASTFM_MCP_TRANSPORT="http"
export LASTFM_MCP_HTTP_ADDR="127.0.0.1:8080"
go run ./cmd/lastfm-mcp

The MCP endpoint is http://127.0.0.1:8080/mcp; health checks use GET /healthz.

Non-loopback binds are rejected unless LASTFMMCPHTTP_TOKEN is set. Clients then send:

Authorization: Bearer <token>

The server applies Go's cross-origin protection around the MCP endpoint and sets conservative HTTP timeouts. Put TLS and production identity-aware authentication in a trusted reverse proxy.

Configuration

Equivalent command-line flags are available for transport, address, path, and feature gates. Run lastfm-mcp -h for details.

Tool coverage

The default server registers every stable read endpoint supported by go-lastfm/v2:

• album: info, user tags, top tags, search;
• artist: correction, info, similar, user tags, top albums/tracks/tags, search;
• chart: top artists, tracks, tags;
• geo: top artists and tracks;
• library: artists;
• tag: info, similar, top albums/artists/tracks/tags, weekly chart ranges;
• track: correction, info, similar, user tags, top tags, search;
• user: profile, friends, loved and recent tracks, personal tags, top albums/artists/tracks/tags, weekly charts and ranges.

LASTFMENABLEWRITES=true adds album/artist/track tagging, love/unlove, now-playing, and scrobbling. These require an API secret and session key.

Shortened. The full README is on GitHub.