@unclick/lastfm-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+Apache License 2.0
+
+Copyright (c) 2026 UnClick / malamutemayhem
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,39 @@
+# Last.fm MCP by UnClick
+
+Music charts, artist info, similar artists, and top tracks from Last.fm.
+
+> By UnClick. 180+ tools plus persistent agent memory in one install: https://unclick.world
+
+## Install
+
+Installs straight from GitHub, no npm account needed.
+
+```json
+{
+  "mcpServers": {
+    "lastfm": {
+      "command": "npx",
+      "args": ["-y", "https://github.com/malamutemayhem/unclick/releases/download/standalone-mcps-latest/lastfm.tgz"]
+    }
+  }
+}
+```
+
+## Tools
+
+- `lastfm_artist_info`
+- `lastfm_search_artists`
+- `lastfm_top_tracks`
+- `lastfm_similar_artists`
+- `lastfm_chart_top_artists`
+- `lastfm_chart_top_tracks`
+- `lastfm_album_info`
+
+## Want the rest?
+
+This is one connector. [UnClick](https://unclick.world) bundles 180+ tools plus
+persistent cross-session agent memory in a single install.
+
+## License
+
+Apache-2.0

package/dist/index.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+// Last.fm MCP. Standalone MCP server by UnClick.
+// By UnClick. 180+ tools plus persistent agent memory in one install: https://unclick.world
+//
+// Generated from the UnClick connector by scripts/generate-standalone-mcp.mjs.
+// Edit the connector in the UnClick monorepo, not here.
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { lastfmGetArtistInfo, lastfmSearchArtists, lastfmGetTopTracks, lastfmGetSimilarArtists, lastfmGetChartTopArtists, lastfmGetChartTopTracks, lastfmGetAlbumInfo, } from "./lastfm-tool.js";
+const TOOLS = [
+    {
+        name: "lastfm_artist_info",
+        description: "Get Last.fm artist info.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                artist: { type: "string" },
+                api_key: { type: "string" },
+            },
+            required: ["artist"],
+        },
+    },
+    {
+        name: "lastfm_search_artists",
+        description: "Search for artists on Last.fm.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                artist: { type: "string" },
+                limit: { type: "number" },
+                api_key: { type: "string" },
+            },
+            required: ["artist"],
+        },
+    },
+    {
+        name: "lastfm_top_tracks",
+        description: "Get top tracks for an artist on Last.fm.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                artist: { type: "string" },
+                limit: { type: "number" },
+                api_key: { type: "string" },
+            },
+            required: ["artist"],
+        },
+    },
+    {
+        name: "lastfm_similar_artists",
+        description: "Get similar artists on Last.fm.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                artist: { type: "string" },
+                limit: { type: "number" },
+                api_key: { type: "string" },
+            },
+            required: ["artist"],
+        },
+    },
+    {
+        name: "lastfm_chart_top_artists",
+        description: "Get the Last.fm chart of top artists.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                limit: { type: "number" },
+                api_key: { type: "string" },
+            },
+        },
+    },
+    {
+        name: "lastfm_chart_top_tracks",
+        description: "Get the Last.fm chart of top tracks.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                limit: { type: "number" },
+                api_key: { type: "string" },
+            },
+        },
+    },
+    {
+        name: "lastfm_album_info",
+        description: "Get album info from Last.fm.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                artist: { type: "string" },
+                album: { type: "string" },
+                api_key: { type: "string" },
+            },
+            required: ["artist", "album"],
+        },
+    }
+];
+const HANDLERS = {
+    lastfm_artist_info: (args) => lastfmGetArtistInfo(args),
+    lastfm_search_artists: (args) => lastfmSearchArtists(args),
+    lastfm_top_tracks: (args) => lastfmGetTopTracks(args),
+    lastfm_similar_artists: (args) => lastfmGetSimilarArtists(args),
+    lastfm_chart_top_artists: (args) => lastfmGetChartTopArtists(args),
+    lastfm_chart_top_tracks: (args) => lastfmGetChartTopTracks(args),
+    lastfm_album_info: (args) => lastfmGetAlbumInfo(args),
+};
+const server = new Server({ name: "io.github.malamutemayhem/lastfm", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const handler = HANDLERS[req.params.name];
+    if (!handler) {
+        return { content: [{ type: "text", text: `Unknown tool: ${req.params.name}` }], isError: true };
+    }
+    try {
+        const result = await handler((req.params.arguments ?? {}));
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: message }], isError: true };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    process.stderr.write(`[lastfm-mcp] fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});

package/dist/lastfm-tool.js

@@ -0,0 +1,168 @@
+// ── Last.fm API tool ────────────────────────────────────────────────────────────
+// Unlimited free read access. No OAuth needed for read operations.
+// Docs: https://www.last.fm/api
+// Env var: LASTFM_API_KEY
+const LASTFM_BASE = "https://ws.audioscrobbler.com/2.0";
+async function lastfmGet(apiKey, method, params) {
+    const qs = new URLSearchParams({
+        method,
+        api_key: apiKey,
+        format: "json",
+    });
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== "")
+            qs.set(k, String(v));
+    }
+    const res = await fetch(`${LASTFM_BASE}/?${qs}`);
+    if (!res.ok)
+        throw new Error(`Last.fm API HTTP ${res.status}: ${res.statusText}`);
+    const json = await res.json();
+    if (json.error)
+        throw new Error(`Last.fm error ${json.error}: ${json.message}`);
+    return json;
+}
+function getApiKey(args) {
+    const key = String(args.api_key ?? process.env.LASTFM_API_KEY ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required (or set LASTFM_API_KEY env var).");
+    return key;
+}
+// ── Tool functions ─────────────────────────────────────────────────────────────
+export async function lastfmGetArtistInfo(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const artist = String(args.artist ?? "").trim();
+        if (!artist)
+            return { error: "artist is required." };
+        const params = { artist };
+        if (args.lang)
+            params.lang = String(args.lang);
+        const data = await lastfmGet(apiKey, "artist.getinfo", params);
+        return data.artist ?? data;
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+export async function lastfmSearchArtists(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const query = String(args.query ?? "").trim();
+        if (!query)
+            return { error: "query is required." };
+        const params = { artist: query };
+        if (args.limit)
+            params.limit = Number(args.limit);
+        if (args.page)
+            params.page = Number(args.page);
+        const data = await lastfmGet(apiKey, "artist.search", params);
+        const results = data.results;
+        const matches = results?.artistmatches?.artist;
+        return {
+            total: results?.["opensearch:totalResults"],
+            artists: Array.isArray(matches) ? matches : matches ? [matches] : [],
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+export async function lastfmGetTopTracks(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const artist = String(args.artist ?? "").trim();
+        if (!artist)
+            return { error: "artist is required." };
+        const params = { artist };
+        if (args.limit)
+            params.limit = Number(args.limit);
+        if (args.page)
+            params.page = Number(args.page);
+        const data = await lastfmGet(apiKey, "artist.gettoptracks", params);
+        const toptracks = data.toptracks;
+        return {
+            artist,
+            tracks: toptracks?.track ?? [],
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+export async function lastfmGetSimilarArtists(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const artist = String(args.artist ?? "").trim();
+        if (!artist)
+            return { error: "artist is required." };
+        const params = { artist };
+        if (args.limit)
+            params.limit = Number(args.limit);
+        const data = await lastfmGet(apiKey, "artist.getsimilar", params);
+        const similar = data.similarartists;
+        return {
+            artist,
+            similar_artists: similar?.artist ?? [],
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+export async function lastfmGetChartTopArtists(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const params = {};
+        if (args.limit)
+            params.limit = Number(args.limit);
+        if (args.page)
+            params.page = Number(args.page);
+        const data = await lastfmGet(apiKey, "chart.gettopartists", params);
+        const artists = data.artists;
+        return {
+            artists: artists?.artist ?? [],
+            total: artists?.["@attr"]?.total,
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+export async function lastfmGetChartTopTracks(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const params = {};
+        if (args.limit)
+            params.limit = Number(args.limit);
+        if (args.page)
+            params.page = Number(args.page);
+        const data = await lastfmGet(apiKey, "chart.gettoptracks", params);
+        const tracks = data.tracks;
+        return {
+            tracks: tracks?.track ?? [],
+            total: tracks?.["@attr"]?.total,
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+export async function lastfmGetAlbumInfo(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const artist = String(args.artist ?? "").trim();
+        const album = String(args.album ?? "").trim();
+        if (!artist)
+            return { error: "artist is required." };
+        if (!album)
+            return { error: "album is required." };
+        const params = { artist, album };
+        if (args.lang)
+            params.lang = String(args.lang);
+        const data = await lastfmGet(apiKey, "album.getinfo", params);
+        return data.album ?? data;
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@unclick/lastfm-mcp",
+  "version": "0.1.0",
+  "mcpName": "io.github.malamutemayhem/lastfm",
+  "description": "Music charts, artist info, similar artists, and top tracks from Last.fm. By UnClick (https://unclick.world).",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "unclick",
+    "lastfm",
+    "music",
+    "charts"
+  ],
+  "author": "UnClick (https://unclick.world)",
+  "type": "module",
+  "bin": {
+    "lastfm-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.15.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "@types/node": "^22.0.0"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/malamutemayhem/unclick.git",
+    "directory": "packages/standalone/lastfm-mcp"
+  },
+  "homepage": "https://unclick.world"
+}

package/server.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.malamutemayhem/lastfm",
+  "title": "Last.fm MCP by UnClick",
+  "description": "Music charts, artist info, similar artists, and top tracks from Last.fm. By UnClick.",
+  "version": "0.1.0",
+  "websiteUrl": "https://unclick.world",
+  "icons": [
+    {
+      "src": "https://unclick.world/favicon.png",
+      "mimeType": "image/png",
+      "sizes": [
+        "512x512"
+      ]
+    }
+  ],
+  "repository": {
+    "url": "https://github.com/malamutemayhem/unclick.git",
+    "source": "github",
+    "subfolder": "packages/standalone/lastfm-mcp"
+  },
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@unclick/lastfm-mcp",
+      "version": "0.1.0",
+      "runtimeHint": "npx",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}