lookup
Pack: bookbrainz · Endpoint: https://gateway.pipeworx.io/bookbrainz/mcp
Fetch a single entity by BookBrainz UUID (bbid).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
type | string | yes | work | edition | author | publisher | series | edition-group |
bbid | string | yes | BookBrainz UUID |
includes | string | no | Comma-sep optional sub-resources (aliases, relationships, identifiers, …) |
Example call
curl -X POST https://gateway.pipeworx.io/bookbrainz/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"lookup","arguments":{}}}'Response shape
| Field | Type | Description |
|---|---|---|
bbid | string | BookBrainz unique identifier |
type | string | Entity type (work, edition, author, etc.) |
name | string | Primary name of the entity |
aliases | array | Alternative names for the entity |
relationships | array | Related entities and relationships |
identifiers | array | External identifiers (ISBN, etc.) |
Full JSON Schema
{
"type": "object",
"description": "Single entity details from BookBrainz",
"properties": {
"bbid": {
"type": "string",
"description": "BookBrainz unique identifier"
},
"type": {
"type": "string",
"description": "Entity type (work, edition, author, etc.)"
},
"name": {
"type": "string",
"description": "Primary name of the entity"
},
"aliases": {
"type": "array",
"description": "Alternative names for the entity",
"items": {
"type": "object"
}
},
"relationships": {
"type": "array",
"description": "Related entities and relationships",
"items": {
"type": "object"
}
},
"identifiers": {
"type": "array",
"description": "External identifiers (ISBN, etc.)",
"items": {
"type": "object"
}
}
}
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"bookbrainz": {
"url": "https://gateway.pipeworx.io/bookbrainz/mcp"
}
}
}See Getting Started for client-specific install steps.