`search_releases`

Pack: musicbrainz · Endpoint: https://gateway.pipeworx.io/musicbrainz/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/search_releases for the schema, then POST the same URL with its arguments for the data.

Search for albums and releases by title or artist name. Returns release IDs, titles, artists, release dates, and formats.

Parameters

Name	Type	Required	Description
`query`	string	yes	Release title or search query.
`limit`	number	no	Maximum number of results to return. Defaults to 10.

Example call

Arguments

{
  "query": "Abbey Road"
}

curl

curl -X POST https://gateway.pipeworx.io/musicbrainz/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_releases","arguments":{"query":"Abbey Road"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_releases', {
  "query": "Abbey Road"
});

More examples

{
  "query": "Pink Floyd The Wall",
  "limit": 15
}

Response shape

Always returns: total, releases

Field	Type	Description
`total`	number	Total number of matching releases
`releases`	array	List of matching releases

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total number of matching releases"
    },
    "releases": {
      "type": "array",
      "description": "List of matching releases",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "MusicBrainz release ID"
          },
          "title": {
            "type": "string",
            "description": "Release title"
          },
          "date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Release date (YYYY-MM-DD)"
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Release status"
          },
          "artist_credit": {
            "type": "array",
            "description": "Artist credits for release",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Artist name as credited"
                },
                "artist_id": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "MusicBrainz artist ID"
                }
              }
            }
          },
          "score": {
            "type": [
              "number",
              "null"
            ],
            "description": "Search result relevance score"
          }
        },
        "required": [
          "id",
          "title"
        ]
      }
    }
  },
  "required": [
    "total",
    "releases"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "musicbrainz": {
      "url": "https://gateway.pipeworx.io/musicbrainz/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_releases