{"_id":"@cyanheads/musicbrainz-mcp-server","_rev":"9-f10396aa801af9cab75f89f4839aceca","name":"@cyanheads/musicbrainz-mcp-server","dist-tags":{"latest":"0.1.8"},"versions":{"0.1.0":{"name":"@cyanheads/musicbrainz-mcp-server","version":"0.1.0","keywords":["musicbrainz","cover-art-archive","music-metadata","discography","mbid","isrc","iswc","music","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/musicbrainz-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/musicbrainz-mcp-server@0.1.0","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/musicbrainz-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/musicbrainz-mcp-server/issues"},"bin":{"musicbrainz-mcp-server":"dist/index.js"},"dist":{"shasum":"26c90cd5ea5d92e9e3e9eb8b86091bce443ca2c7","tarball":"https://registry.npmjs.org/@cyanheads/musicbrainz-mcp-server/-/musicbrainz-mcp-server-0.1.0.tgz","fileCount":89,"integrity":"sha512-Z+myFsP2uaAHq/Rd8w9F369AWIVKh3AcULoUwehuiQ/NjeIEQKXh0p4f1WvH6UuFrshC3N159ca05lCWMfUhng==","signatures":[{"sig":"MEQCIBPiZ3HKZhlFQRcSFq7P/Nic/CKK82ievv+eMpqdWHU2AiAxVKhmiqNuzBApv1byqjej7ClbNwkUGgPz5HUMrpz7zQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":443810},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"26c90cd5ea5d92e9e3e9eb8b86091bce443ca2c7","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/musicbrainz-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/musicbrainz-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/musicbrainz-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-Z+myFsP2uaAHq/Rd8w9F369AWIVKh3AcULoUwehuiQ/NjeIEQKXh0p4f1WvH6UuFrshC3N159ca05lCWMfUhng==","repository":{"url":"git+https://github.com/cyanheads/musicbrainz-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.2","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.8","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"25.9.3","@biomejs/biome":"2.5.0"},"_npmOperationalInternal":{"tmp":"tmp/musicbrainz-mcp-server_0.1.0_1781373248536_0.4654441563863556","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@cyanheads/musicbrainz-mcp-server","version":"0.1.1","keywords":["musicbrainz","cover-art-archive","music-metadata","discography","mbid","isrc","iswc","music","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":{"url":"https://github.com/cyanheads/musicbrainz-mcp-server#readme","name":"cyanheads","email":"casey@caseyjhand.com"},"license":"Apache-2.0","_id":"@cyanheads/musicbrainz-mcp-server@0.1.1","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/musicbrainz-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/musicbrainz-mcp-server/issues"},"bin":{"musicbrainz-mcp-server":"dist/index.js"},"dist":{"shasum":"667c510d09574c0ff2307a5b1481d6a5844d4274","tarball":"https://registry.npmjs.org/@cyanheads/musicbrainz-mcp-server/-/musicbrainz-mcp-server-0.1.1.tgz","fileCount":90,"integrity":"sha512-Slgd0xzvpDEvmrX9mQWYTgZuTtmT2Oz2MCmuea2Nymego+Ot/D94cP8FxTNZ1padQifoDfJkbiv7UDJ7AfKFKw==","signatures":[{"sig":"MEQCIBNz4ND2oEWp1bTzuRuCq8gxfDBRMOC7aV1xeLe8La7zAiB4ZR1uObQUCOgvPVBv18zAYoA5lR4gnif/qSfeHEdWuA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":444276},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"gitHead":"e1ed8692b550c7151a49eca0825ee4d47cbb38ff","mcpName":"io.github.cyanheads/musicbrainz-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/musicbrainz-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/musicbrainz-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"repository":{"url":"git+https://github.com/cyanheads/musicbrainz-mcp-server.git","type":"git"},"_npmVersion":"11.12.1","description":"Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.2","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.8","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"25.9.3","@biomejs/biome":"2.5.0"},"_npmOperationalInternal":{"tmp":"tmp/musicbrainz-mcp-server_0.1.1_1781433589603_0.9442784133478515","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@cyanheads/musicbrainz-mcp-server","version":"0.1.2","keywords":["musicbrainz","cover-art-archive","music-metadata","discography","mbid","isrc","iswc","music","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/musicbrainz-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/musicbrainz-mcp-server@0.1.2","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/musicbrainz-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/musicbrainz-mcp-server/issues"},"bin":{"musicbrainz-mcp-server":"dist/index.js"},"dist":{"shasum":"be77185574ac38b5ec8818c62d369144c61c4b8f","tarball":"https://registry.npmjs.org/@cyanheads/musicbrainz-mcp-server/-/musicbrainz-mcp-server-0.1.2.tgz","fileCount":91,"integrity":"sha512-X/t1zOQG6yp61z7RXaOqrhGo9CCNs2mBN5xEUJJLIalRzl+BceU8i6IP0UPcMHOf+3qjLL0wSlsevEwf6ofH9A==","signatures":[{"sig":"MEUCIAQdiJ1O0gt67QMzb0DuFIe7ynp4ti7+GFYDiXK28+5IAiEAxffaqZPePvH3Y5lI3zyRSulJDTKPAmh+E/C7WzE28Hs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":446382},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"be77185574ac38b5ec8818c62d369144c61c4b8f","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/musicbrainz-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/musicbrainz-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/musicbrainz-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-X/t1zOQG6yp61z7RXaOqrhGo9CCNs2mBN5xEUJJLIalRzl+BceU8i6IP0UPcMHOf+3qjLL0wSlsevEwf6ofH9A==","repository":{"url":"git+https://github.com/cyanheads/musicbrainz-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.2","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.9","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"25.9.3","@biomejs/biome":"2.5.0"},"_npmOperationalInternal":{"tmp":"tmp/musicbrainz-mcp-server_0.1.2_1781544799364_0.9427777261210488","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@cyanheads/musicbrainz-mcp-server","version":"0.1.3","keywords":["musicbrainz","cover-art-archive","music-metadata","discography","mbid","isrc","iswc","music","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/musicbrainz-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/musicbrainz-mcp-server@0.1.3","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/musicbrainz-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/musicbrainz-mcp-server/issues"},"bin":{"musicbrainz-mcp-server":"dist/index.js"},"dist":{"shasum":"3bdc08067fe89573ec027b44a6eec66e38f9d911","tarball":"https://registry.npmjs.org/@cyanheads/musicbrainz-mcp-server/-/musicbrainz-mcp-server-0.1.3.tgz","fileCount":92,"integrity":"sha512-mRlduo72rto64dP3YXqZuLQfPiGQsNn6xb9qA0ppIcfXkfuVNkcLq4GuojbpFSFmtg8FKIhL3bw7H+wHA3rjMg==","signatures":[{"sig":"MEYCIQDNKkks76SJuY1oAnR4kccTr6tqNBUkzdNRNVMxrLoJvgIhANj8T1c1nWI8SeIxy1nM2KFvs5GtS1St/hQ0EPDkT9z3","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":448479},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"3bdc08067fe89573ec027b44a6eec66e38f9d911","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/musicbrainz-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/musicbrainz-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/musicbrainz-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-mRlduo72rto64dP3YXqZuLQfPiGQsNn6xb9qA0ppIcfXkfuVNkcLq4GuojbpFSFmtg8FKIhL3bw7H+wHA3rjMg==","repository":{"url":"git+https://github.com/cyanheads/musicbrainz-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.2","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.9","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"25.9.3","@biomejs/biome":"2.5.0"},"_npmOperationalInternal":{"tmp":"tmp/musicbrainz-mcp-server_0.1.3_1781924133436_0.5560365005279944","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@cyanheads/musicbrainz-mcp-server","version":"0.1.4","keywords":["musicbrainz","cover-art-archive","music-metadata","discography","mbid","isrc","iswc","music","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/musicbrainz-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/musicbrainz-mcp-server@0.1.4","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/musicbrainz-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/musicbrainz-mcp-server/issues"},"bin":{"musicbrainz-mcp-server":"dist/index.js"},"dist":{"shasum":"fbee582439544e7971fb07f2e8bd8fd6a5f71a06","tarball":"https://registry.npmjs.org/@cyanheads/musicbrainz-mcp-server/-/musicbrainz-mcp-server-0.1.4.tgz","fileCount":93,"integrity":"sha512-3ukp7WY9+IDpj+ZaFD55nEkSHci/9CiqIQCbbNz34E3vQdNE2ScnZWN1YoEU6M0o1e0jX6BfLm1tk32JzaNipQ==","signatures":[{"sig":"MEQCIAklanoT2lVQQxaaJo9orgOMQVJdNIA3r5ko3A6wUrRsAiAS2qngitX9MYOwObvxurHzbF4Il+pt6fUbBvx2d6bczg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":450526},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"fbee582439544e7971fb07f2e8bd8fd6a5f71a06","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/musicbrainz-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/musicbrainz-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/musicbrainz-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-3ukp7WY9+IDpj+ZaFD55nEkSHci/9CiqIQCbbNz34E3vQdNE2ScnZWN1YoEU6M0o1e0jX6BfLm1tk32JzaNipQ==","repository":{"url":"git+https://github.com/cyanheads/musicbrainz-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.8"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.2","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.9","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"26.0.0","@biomejs/biome":"2.5.0"},"_npmOperationalInternal":{"tmp":"tmp/musicbrainz-mcp-server_0.1.4_1781933198990_0.35092272312440675","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@cyanheads/musicbrainz-mcp-server","version":"0.1.5","keywords":["musicbrainz","cover-art-archive","music-metadata","discography","mbid","isrc","iswc","music","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/musicbrainz-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/musicbrainz-mcp-server@0.1.5","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/musicbrainz-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/musicbrainz-mcp-server/issues"},"bin":{"musicbrainz-mcp-server":"dist/index.js"},"dist":{"shasum":"22e0fc736e7c30f62369cbebf96ff99e48f65a8f","tarball":"https://registry.npmjs.org/@cyanheads/musicbrainz-mcp-server/-/musicbrainz-mcp-server-0.1.5.tgz","fileCount":94,"integrity":"sha512-dnaIWtUbZ8Y9qX9OtaDUeMLxfBQAMMxOw85mX8iHKfLYm5+tn6yXV8rQWvlfV0Zg+ahFYgn3Ygd0dwejUuUY+A==","signatures":[{"sig":"MEYCIQDwG16vMxUHTdi14RzWRrU4p2xGBtxcG19Cm/5saUWgDwIhAOcLI9TEBUwelyDkwzc+HvYVGouYyUdBZhtP0yX4ZcbY","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":452234},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"22e0fc736e7c30f62369cbebf96ff99e48f65a8f","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/musicbrainz-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/musicbrainz-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/musicbrainz-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-dnaIWtUbZ8Y9qX9OtaDUeMLxfBQAMMxOw85mX8iHKfLYm5+tn6yXV8rQWvlfV0Zg+ahFYgn3Ygd0dwejUuUY+A==","repository":{"url":"git+https://github.com/cyanheads/musicbrainz-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.9"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.2","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.9","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"26.0.0","@biomejs/biome":"2.5.0"},"_npmOperationalInternal":{"tmp":"tmp/musicbrainz-mcp-server_0.1.5_1781981400475_0.8973805412245699","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@cyanheads/musicbrainz-mcp-server","version":"0.1.6","keywords":["musicbrainz","cover-art-archive","music-metadata","discography","mbid","isrc","iswc","music","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/musicbrainz-mcp-server@0.1.6","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/musicbrainz-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/musicbrainz-mcp-server/issues"},"bin":{"musicbrainz-mcp-server":"dist/index.js"},"dist":{"shasum":"c6f74247bb773f800c431b77870b9a1f3bd58956","tarball":"https://registry.npmjs.org/@cyanheads/musicbrainz-mcp-server/-/musicbrainz-mcp-server-0.1.6.tgz","fileCount":95,"integrity":"sha512-tOd4SCdxCuvgzOIgyptjluueKYeV1yW3xpIadit3c3dzFeZ7TjpSjaqT6dbUZ8tNOwA15XvCDCXoO179gOsOEg==","signatures":[{"sig":"MEUCIQCz6PJpRrkkcpHpCS8QP+FBA+5LNq8CmH0P/9PE87A0iQIgejYmDx+9Z72kyVwHm9z5HjOOuQ8s9XLUT8GkMNoXuPo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":458956},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"c6f74247bb773f800c431b77870b9a1f3bd58956","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/musicbrainz-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/musicbrainz-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/musicbrainz-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-tOd4SCdxCuvgzOIgyptjluueKYeV1yW3xpIadit3c3dzFeZ7TjpSjaqT6dbUZ8tNOwA15XvCDCXoO179gOsOEg==","repository":{"url":"git+https://github.com/cyanheads/musicbrainz-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.6","vitest":"^4.1.11","depcheck":"^1.4.7","tsc-alias":"^1.9.2","typescript":"^7.0.2","@types/node":"26.2.0","@biomejs/biome":"2.5.9","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/musicbrainz-mcp-server_0.1.6_1787353763341_0.743581110848389","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@cyanheads/musicbrainz-mcp-server","version":"0.1.7","keywords":["musicbrainz","cover-art-archive","music-metadata","discography","mbid","isrc","iswc","music","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/musicbrainz-mcp-server@0.1.7","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/musicbrainz-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/musicbrainz-mcp-server/issues"},"bin":{"musicbrainz-mcp-server":"dist/index.js"},"dist":{"shasum":"8e20469f2979c21884dd5502a6496e416da3a1d0","tarball":"https://registry.npmjs.org/@cyanheads/musicbrainz-mcp-server/-/musicbrainz-mcp-server-0.1.7.tgz","fileCount":96,"integrity":"sha512-qiamDePY6tdEMLR8m6A3XKRRSYuAgcQS11xBeJpujEeISvepjOVvtGvp5NSSvjDJnn9lDlabDbY9Cg0HVXcVvA==","signatures":[{"sig":"MEUCIQD4MseP11x1cm+tvXvmZSQvSUl2cFINcM2nzzsjxNc99wIgJmA/FwppkPFvATun3mgwVuPE3WNo0v2midRsk6rCZKg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIBjhJJeWBnRiRM0fJBshtOem2v2TnB67qbc1ETnn3kjqAiAtn+U1yy805SazWdDOf0JlYWZOyIumcV2D1jCepW9mwA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":467030},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"8e20469f2979c21884dd5502a6496e416da3a1d0","engines":{"bun":">=1.4.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/musicbrainz-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/musicbrainz-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/musicbrainz-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","audit:fix":"bun audit fix","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-qiamDePY6tdEMLR8m6A3XKRRSYuAgcQS11xBeJpujEeISvepjOVvtGvp5NSSvjDJnn9lDlabDbY9Cg0HVXcVvA==","repository":{"url":"git+https://github.com/cyanheads/musicbrainz-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.6.5","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.13.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.9","vitest":"^4.1.11","depcheck":"^1.4.7","tsc-alias":"^1.9.5","typescript":"^7.0.2","@types/node":"26.6.1","@biomejs/biome":"2.5.14","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/musicbrainz-mcp-server_0.1.7_1789918116161_0.6018245425077771","host":"s3://npm-registry-packages-npm-production"}},"0.1.8":{"_id":"@cyanheads/musicbrainz-mcp-server@0.1.8","bin":{"musicbrainz-mcp-server":"dist/index.js"},"bugs":{"url":"https://github.com/cyanheads/musicbrainz-mcp-server/issues"},"dist":{"shasum":"c99526b0a730914beb86bb4c25f885e3050c9ab8","tarball":"https://registry.npmjs.org/@cyanheads/musicbrainz-mcp-server/-/musicbrainz-mcp-server-0.1.8.tgz","fileCount":97,"integrity":"sha512-8oXCBRbHc62EB1cGAZkzR9VxLJcAhIDvp7DjftylDyRo58T2WOet71dywA8XCoL+lS1wVP8P0zW0cD2sk2zyeQ==","signatures":[{"sig":"MEQCIHGlmO9En/4y0O9apIF03fDEfgNJddThkEmUZ2164ov6AiAphbMyThO2ckjOrSJji1SbXnqL4bZBZgiMeSAv48/H0w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDjmcrcKCG6/6/MD/CrTUL4xxxZ9Vy3KavY7gNKhqz0bAIhAKm0gB9cc7w8yJe7khnNXQLIUy6C+cFGHzHAA20KqxSZ"}],"unpackedSize":491677},"main":"dist/index.js","name":"@cyanheads/musicbrainz-mcp-server","type":"module","types":"dist/index.d.ts","author":"Casey Hand (https://caseyjhand.com)","shasum":"c99526b0a730914beb86bb4c25f885e3050c9ab8","engines":{"bun":">=1.4.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"license":"Apache-2.0","mcpName":"io.github.cyanheads/musicbrainz-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/musicbrainz-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/musicbrainz-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","audit:fix":"bun audit fix","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"version":"0.1.8","_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"homepage":"https://github.com/cyanheads/musicbrainz-mcp-server#readme","keywords":["musicbrainz","cover-art-archive","music-metadata","discography","mbid","isrc","iswc","music","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"_integrity":"sha512-8oXCBRbHc62EB1cGAZkzR9VxLJcAhIDvp7DjftylDyRo58T2WOet71dywA8XCoL+lS1wVP8P0zW0cD2sk2zyeQ==","repository":{"url":"git+https://github.com/cyanheads/musicbrainz-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.","directories":{},"maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.6.5","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.13.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.9","vitest":"^5.0.1","depcheck":"^1.4.7","tsc-alias":"^1.9.5","typescript":"^7.0.2","@types/node":"26.6.2","@biomejs/biome":"2.5.14","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/musicbrainz-mcp-server_0.1.8_1790096877126_0.8155375931568065"}}},"time":{"created":"2026-06-13T17:54:08.352Z","modified":"2026-09-22T17:07:57.356Z","0.1.0":"2026-06-13T17:54:08.693Z","0.1.1":"2026-06-14T10:39:49.765Z","0.1.2":"2026-06-15T17:33:19.519Z","0.1.3":"2026-06-20T02:55:33.581Z","0.1.4":"2026-06-20T05:26:39.153Z","0.1.5":"2026-06-20T18:50:00.619Z","0.1.6":"2026-08-21T23:09:23.543Z","0.1.7":"2026-09-20T15:28:36.240Z","0.1.8":"2026-09-22T17:07:57.214Z"},"bugs":{"url":"https://github.com/cyanheads/musicbrainz-mcp-server/issues"},"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","homepage":"https://github.com/cyanheads/musicbrainz-mcp-server#readme","keywords":["musicbrainz","cover-art-archive","music-metadata","discography","mbid","isrc","iswc","music","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"repository":{"url":"git+https://github.com/cyanheads/musicbrainz-mcp-server.git","type":"git"},"description":"Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"readme":"
\n

@cyanheads/musicbrainz-mcp-server

\n

Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.\n

10 Tools • 1 Resource
\n

\n
\n\n
\n\n[![Version](https://img.shields.io/badge/Version-0.1.8-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.0.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.0-blueviolet.svg?style=flat-square)](https://bun.sh/)\n\n
\n\n
\n\n[![Install in Claude Desktop](https://img.shields.io/badge/Install_in-Claude_Desktop-D97757?style=for-the-badge&logo=anthropic&logoColor=white)](https://github.com/cyanheads/musicbrainz-mcp-server/releases/latest/download/musicbrainz-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=musicbrainz-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvbXVzaWNicmFpbnotbWNwLXNlcnZlciJdfQ==) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22musicbrainz-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads/musicbrainz-mcp-server%22%5D%7D)\n\n
\n\n
\n\n[![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-67E8F9?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)\n\n
\n\n
\n\n**Public Hosted Server:** [https://musicbrainz.caseyjhand.com/mcp](https://musicbrainz.caseyjhand.com/mcp)\n\n
\n\n---\n\n## Overview\n\nOpen music metadata over the live MusicBrainz Web Service v2 and the Cover Art Archive. Search by name, look up entities by MBID or a standard identifier (ISRC/ISWC/barcode), browse the complete linked set beyond what the lookup tools embed, and fetch cover art from any MCP client. Runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.\n\n### Tools\n\n| Tool | Description |\n|:---|:---|\n| `musicbrainz_search_entities` | Full-text Lucene search across a MusicBrainz entity type. Returns ranked matches with MBID and a relevance score. |\n| `musicbrainz_get_artist` | Artist profile by MBID — type, life span, discography, relationships, external links. |\n| `musicbrainz_get_release_group` | Release-group (\"the album\" above specific pressings) by MBID — type, first-release date, editions, cover-art availability. |\n| `musicbrainz_get_release` | One edition's full detail by MBID — tracklist, label, catalog number, barcode, packaging. |\n| `musicbrainz_get_recording` | Recording (a specific performance) by MBID — length, ISRCs, releases it appears on, performance relationships. |\n| `musicbrainz_get_work` | Work (a composition) by MBID — type, ISWCs, writer relationships, performing recordings. |\n| `musicbrainz_get_label` | Label by MBID — type, life span, label code, external links. |\n| `musicbrainz_lookup_identifier` | Resolve an ISRC, ISWC, or barcode directly to recordings, works, or releases. |\n| `musicbrainz_browse_entities` | Paginate the complete set of entities linked to a parent MBID — the only complete-enumeration path. |\n| `musicbrainz_get_cover_art` | Cover Art Archive images for a release or release-group MBID. |\n\n### Resources\n\n| Resource | Description |\n|:---|:---|\n| `musicbrainz://{entity_type}/{mbid}` | A single MusicBrainz entity by type and MBID, with default linked sub-resources folded in. |\n\nAll entity data is also reachable via the `get_*` tools, so tool-only clients lose nothing. There is no resource `list()` — the corpus is millions of entities; discovery is via `musicbrainz_search_entities`.\n\n## Capability reference\n\n### `musicbrainz_search_entities` tool\n\n- Searches one entity type per call: artist, release-group, release, recording, work, or label\n- Field-scoped Lucene syntax (e.g. `artist:radiohead AND country:GB`)\n- Surfaces the raw 0–100 relevance `score` per hit (100 = exact); results stay in MusicBrainz score-descending order, not re-ranked\n- Type-specific fields appear only for the relevant entity (ISRCs on recordings, ISWCs on works, artist credit on release-groups/releases/recordings)\n- Pagination via `limit` (1–100, default 25) and `offset`; echoes the effective query and the true upstream total\n- A whitespace-only query fails locally as `blank_query` with a recovery hint; everything else goes upstream exactly as sent, incidental whitespace included\n\n---\n\n### `musicbrainz_get_artist` tool\n\n- Folds discography (release-groups), band-membership / collaboration relationships, aliases, and tags/genres into one request via `inc`\n- External links (Wikidata QID, Discogs, official site) surface as `url-rels` — chainable to `wikidata-mcp-server` and friends; this server does not chase them itself\n- `inc_release_groups` and `inc_relationships` (both default `true`) toggle the expensive sub-resources\n- Discography and relationships are capped at one page (25); for a prolific artist's complete release-group list, use `musicbrainz_browse_entities` (`target_type=release-group`, artist link)\n\n---\n\n### `musicbrainz_get_release_group` tool\n\n- Primary type (Album, Single, EP, Broadcast, Other) and secondary types (Live, Compilation, Soundtrack, …), first-release date, and the artist credit (array plus a display string)\n- Embedded releases (editions) capped at one page (25); `musicbrainz_browse_entities` (`target_type=release`, `link.release-group`) gives the complete set\n- Cover-art availability (image count, front/back) comes from the Cover Art Archive — the art `musicbrainz_get_cover_art` returns for the same MBID — looked up alongside the MusicBrainz record; when that lookup fails the field is omitted with a notice rather than reported as \"no art\"\n- Chain a listed release MBID into `musicbrainz_get_release` for its tracklist\n\n---\n\n### `musicbrainz_get_release` tool\n\n- Tracklist as media → tracks → recordings, each with length and recording MBID (lengths rendered `m:ss`, stored as milliseconds upstream)\n- Label + catalog number, barcode, country, release date, format, packaging, and text representation (language/script)\n- Carries a cover-art availability stub from the WS/2 payload; call `musicbrainz_get_cover_art` with the release MBID for the actual image URLs\n\n---\n\n### `musicbrainz_get_recording` tool\n\n- Length (rendered `m:ss`), ISRCs, artist credits, and the releases it appears on\n- `inc_relationships` (default `true`) toggles performance/production relationships (performer, producer, engineer — each with role and credited-artist MBID) and work-rels linking to the underlying composition\n- External links (url-rels) surface alongside relationships when included\n\n---\n\n### `musicbrainz_get_work` tool\n\n- Type, ISWCs, lyrics languages, aliases, and tags/genres\n- `inc_relationships` (default `true`) toggles writer/composer/lyricist relationships, recording-rels (the recordings that perform it), and external links\n- Recording relationships are returned in full — the work lookup is the one `get_*` tool with no per-page cap\n\n---\n\n### `musicbrainz_get_label` tool\n\n- Type, country, life span, label code (the LC number), area, aliases, tags, and external links\n- Releases are NOT embedded — a major label can have tens of thousands; enumerate them with `musicbrainz_browse_entities` (`target_type=release`, `link.label`)\n\n---\n\n### `musicbrainz_lookup_identifier` tool\n\n- `id_type=isrc` → recordings (a recording-level code, often shared by several recordings)\n- `id_type=iswc` → works (a composition-level code)\n- `id_type=barcode` → releases (UPC/EAN digits; spaces and hyphens are ignored, anything else is rejected as `invalid_identifier`)\n- ISRC and ISWC hit dedicated exact endpoints; barcode is a Lucene search filter, so its results are ranked (exact match scores 100)\n- The output `kind` field discriminates which entity type came back (recordings | works | releases)\n\n---\n\n### `musicbrainz_browse_entities` tool\n\n- Paginates the full linked set: every release-group by an artist, every release on a label, every recording of a work, every release in a release-group\n- Page size `limit` (1–100, default 25); pages arbitrarily deep via `offset`, and `totalCount` is the true upstream total\n- Use it whenever a linked set may exceed a page — the `get_*` tools embed at most one page (25), and a partial list read as complete is a silent correctness gap\n- Provide exactly one `link` MBID matching a valid parent→child relationship for the `target_type`\n\n---\n\n### `musicbrainz_get_cover_art` tool\n\n- Front/back flags, image types, full-resolution URLs, and 250/500/1200px thumbnail URLs\n- Returns an empty image set (not an error) when the entity has no art — absence of art is information\n- The archive answers the same 404 for \"no art\" and for an MBID it has no record of, so that case is checked against MusicBrainz first: a malformed or all-zeros MBID fails as `invalid_mbid`, one matching no release/release-group as `entity_not_found`, and an unreachable check returns the empty set with its existence flagged unconfirmed\n- Art is served at the release level; `entity_type` defaults to `release`, and a release-group MBID resolves to a representative release's art automatically\n- Image URLs are linked, never rehosted — image copyright stays with the rights holders (only the MusicBrainz core metadata is CC0)\n\n---\n\n### `musicbrainz://{entity_type}/{mbid}` resource\n\n- Mirrors the matching `musicbrainz_get_*` tool with the same default `inc` sets, returned as the raw MusicBrainz JSON record\n- `entity_type` ∈ artist, release-group, release, recording, work, label\n- Embedded linked lists are capped at one page, same as the lookup tools — use `musicbrainz_browse_entities` for the complete set\n\n## Features\n\nBuilt on [`@cyanheads/mcp-ts-core`](https://github.com/cyanheads/mcp-ts-core): stdio and Streamable HTTP transports, pluggable auth (`none` / `jwt` / `oauth`), swappable storage (`in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`), structured logging with optional OpenTelemetry tracing.\n\nMusicBrainz-specific:\n\n- Type-safe client over the MusicBrainz Web Service v2 (`musicbrainz.org/ws/2`, JSON) plus the Cover Art Archive\n- Process-wide ~1 req/sec token-bucket rate limiter — concurrent requests serialize to stay under MusicBrainz's per-IP ceiling, so multi-tenant load shares one budget\n- Response caching keyed on the full request (including the `inc` set) — MBIDs are stable and entity data changes slowly, keeping most repeat lookups off the wire\n- `inc`-driven lookups fold discography, relationships, tracklists, and external IDs into a single call rather than serial requests\n- Retry with backoff over the full fetch + parse pipeline; an HTML error page served under load is classified transient, not as a parse error\n\nAgent-friendly output:\n\n- Provenance on search/browse — the effective query is echoed and the true upstream total is reported, so an agent can tell a partial window from a complete result\n- Truncation honesty — `get_*` tools disclose when an embedded linked list is capped at one page and name `musicbrainz_browse_entities` as the complete-enumeration path\n- Discriminated outputs — `musicbrainz_lookup_identifier` returns a `kind`-tagged union (recordings | works | releases) so callers branch on data, not string parsing\n- Raw upstream relevance `score` surfaced as-is (not a fabricated confidence metric), and missing upstream fields are preserved as absent rather than invented\n\n## Getting started\n\n`musicbrainz-mcp-server` is keyless — no API key or account. MusicBrainz does require a descriptive `User-Agent` with a contact and rate-limits to ~1 request/second per IP; the server ships a default contact so it works out of the box, but operators running a shared or hosted instance should set `MUSICBRAINZ_CONTACT` to their own email or URL.\n\n### Public Hosted Instance\n\nA public instance is available at `https://musicbrainz.caseyjhand.com/mcp` — no installation required. Point any MCP client at it via Streamable HTTP, with this client config:\n\n```json\n{\n \"mcpServers\": {\n \"musicbrainz-mcp-server\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://musicbrainz.caseyjhand.com/mcp\"\n }\n }\n}\n```\n\n### Self-Hosted / Local\n\nAdd the following to your MCP client configuration file.\n\n```json\n{\n \"mcpServers\": {\n \"musicbrainz-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"bunx\",\n \"args\": [\"@cyanheads/musicbrainz-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"MCP_LOG_LEVEL\": \"info\",\n \"MUSICBRAINZ_CONTACT\": \"you@example.com\"\n }\n }\n }\n}\n```\n\nOr with npx (no Bun required):\n\n```json\n{\n \"mcpServers\": {\n \"musicbrainz-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@cyanheads/musicbrainz-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"MCP_LOG_LEVEL\": \"info\",\n \"MUSICBRAINZ_CONTACT\": \"you@example.com\"\n }\n }\n }\n}\n```\n\nOr with Docker:\n\n```json\n{\n \"mcpServers\": {\n \"musicbrainz-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"-i\", \"--rm\",\n \"-e\", \"MCP_TRANSPORT_TYPE=stdio\",\n \"-e\", \"MUSICBRAINZ_CONTACT=you@example.com\",\n \"ghcr.io/cyanheads/musicbrainz-mcp-server:latest\"\n ]\n }\n }\n}\n```\n\nFor Streamable HTTP, set the transport and start the server:\n\n```sh\nMCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 MUSICBRAINZ_CONTACT=you@example.com bun run start:http\n# Server listens at http://localhost:3010/mcp\n```\n\n### Prerequisites\n\n- [Bun v1.4.0](https://bun.sh/) or higher (or Node.js v24+).\n- No API key. Optionally set `MUSICBRAINZ_CONTACT` to your email or URL — recommended for any shared or hosted deployment.\n\n### Installation\n\n1. **Clone the repository:**\n\n```sh\ngit clone https://github.com/cyanheads/musicbrainz-mcp-server.git\n```\n\n2. **Navigate into the directory:**\n\n```sh\ncd musicbrainz-mcp-server\n```\n\n3. **Install dependencies:**\n\n```sh\nbun install\n```\n\n4. **Configure environment:**\n\n```sh\ncp .env.example .env\n# edit .env and set MUSICBRAINZ_CONTACT (optional but recommended)\n```\n\n## Configuration\n\nConfiguration is validated at startup via Zod schemas in `src/config/server-config.ts`.\n\n| Variable | Description | Default |\n|:---|:---|:---|\n| `MUSICBRAINZ_CONTACT` | Contact (email or URL) embedded in the mandatory descriptive `User-Agent`. Not start-blocking — a default is provided — but operators of a shared/hosted instance should set their own so MusicBrainz can reach them about traffic. | repo URL |\n| `MUSICBRAINZ_BASE_URL` | MusicBrainz Web Service v2 base URL. Override for a private mirror or `beta.musicbrainz.org`. | `https://musicbrainz.org/ws/2` |\n| `MUSICBRAINZ_RATE_LIMIT_RPS` | Client-side request-per-second ceiling. ~1 is the documented limit; lower it for shared-hosting headroom. | `1` |\n| `MUSICBRAINZ_CACHE_TTL` | Response cache TTL in seconds. MBIDs are stable, so data changes slowly. `0` disables caching. | `86400` |\n| `MUSICBRAINZ_TIMEOUT_MS` | Per-request HTTP timeout in milliseconds. | `30000` |\n| `MUSICBRAINZ_MAX_RETRIES` | Retry attempts for transient upstream failures (503 / 5xx / HTML error page). | `3` |\n| `COVER_ART_BASE_URL` | Cover Art Archive base URL. | `https://coverartarchive.org` |\n| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |\n| `MCP_HTTP_PORT` | Port for the HTTP server. | `3010` |\n| `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth`. | `none` |\n| `MCP_LOG_LEVEL` | Log level (RFC 5424). | `info` |\n| `OTEL_ENABLED` | Enable [OpenTelemetry instrumentation](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry). | `false` |\n\nSee [`.env.example`](./.env.example) for the full list of optional overrides.\n\n### Rate limit and User-Agent\n\nMusicBrainz blocks requests without a descriptive `User-Agent` identifying the application and a contact. This server sends `musicbrainz-mcp-server/ ()`, where `` is `MUSICBRAINZ_CONTACT` — set it to your own email or URL when you deploy. Upstream calls serialize through one process-wide limiter, so on a shared or hosted instance every client draws on the same ~1 req/sec budget and bulk enumeration via `musicbrainz_browse_entities` paces accordingly.\n\n## Running the server\n\n### Local development\n\n- **Build and run:**\n\n ```sh\n # One-time build\n bun run rebuild\n\n # Run the built server\n bun run start:stdio\n # or\n bun run start:http\n ```\n\n- **Run checks and tests:**\n\n ```sh\n bun run devcheck # Lint, format, typecheck, security, packaging\n bun run test # Vitest test suite\n bun run lint:mcp # Validate MCP definitions against the linter rules\n ```\n\n### Docker\n\n```sh\ndocker build -t musicbrainz-mcp-server .\ndocker run --rm -e MUSICBRAINZ_CONTACT=you@example.com -p 3010:3010 musicbrainz-mcp-server\n```\n\nThe Dockerfile defaults to HTTP transport, stateless session mode, and logs to `/var/log/musicbrainz-mcp-server`. OpenTelemetry peer dependencies are installed by default — build with `--build-arg OTEL_ENABLED=false` to omit them.\n\n## Project structure\n\n| Directory | Purpose |\n|:---|:---|\n| `src/index.ts` | `createApp()` entry point — registers tools and the resource, inits both services. |\n| `src/config` | Server-specific environment variable parsing and validation with Zod. |\n| `src/services/musicbrainz` | MusicBrainz WS/2 client — User-Agent, rate limiter, response cache, retry, and domain types. |\n| `src/services/cover-art` | Cover Art Archive client — maps 404 to an empty image set flagged as not found, follows the release-group redirect. |\n| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). Ten read-only tools across search, lookup, browse, and cover art. |\n| `src/mcp-server/resources` | Resource definitions. The `musicbrainz://{entity_type}/{mbid}` entity mirror. |\n| `tests/` | Unit and integration tests mirroring `src/`. |\n\n## Development guide\n\nSee [`CLAUDE.md`/`AGENTS.md`](./CLAUDE.md) for development guidelines and architectural rules. The short version:\n\n- Handlers throw, framework catches — no `try/catch` in tool logic\n- Use `ctx.log` for request-scoped logging, `ctx.state` for tenant-scoped storage\n- Register new tools and resources via the barrels in `src/mcp-server/*/definitions/index.ts`\n- All upstream calls route through the services — never `fetch()` MusicBrainz directly, or you bypass the User-Agent, rate limiter, and cache\n- Wrap external API data: validate raw → normalize to domain type → return output schema; never fabricate missing fields\n\n## Attribution and licensing\n\nMusicBrainz core entity data is released under **CC0** (public-domain dedication) — see the [MusicBrainz license](https://musicbrainz.org/doc/About/Data_License). This server stays on that core metadata and does not fetch annotation text (which carries a different, non-CC0 license). Cover art is served by the [Cover Art Archive](https://coverartarchive.org/), a joint project of MusicBrainz and the Internet Archive; image URLs are linked, never rehosted, and each image's copyright stays with its rights holders. Cite MusicBrainz and the Cover Art Archive in downstream use.\n\n## Contributing\n\nIssues are welcome. Run checks and tests before submitting:\n\n```sh\nbun run devcheck\nbun run test\n```\n\n## License\n\nApache-2.0 — see [LICENSE](./LICENSE) for details.\n","readmeFilename":"README.md"}