{"openapi":"3.0.3","info":{"title":"Gnist Context — MusicBrainz","description":"Music metadata — artist profiles, album discographies, song/recording search.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/musicbrainz/`\n- **Toolkit page:** `/toolkits/musicbrainz`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/musicbrainz/search_artists":{"post":{"tags":["Media"],"summary":"search_artists","description":"Search for music artists by name.\n\nReturns artist names, countries, active years, and genre tags.\n\nArgs:\n    query: Artist name (e.g. \"Radiohead\", \"Miles Davis\", \"a-ha\").\n    limit: Maximum results (1-25, default 10).","operationId":"musicbrainz_search_artists","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"type":"string"},"limit":{"default":10,"type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/musicbrainz/get_artist_info":{"post":{"tags":["Media"],"summary":"get_artist_info","description":"Get detailed information about an artist by MusicBrainz ID.\n\nReturns full artist profile including name, type, country, lifespan, and tags.\n\nArgs:\n    artist_id: MusicBrainz UUID (e.g. \"a74b1b7f-71a5-4011-9441-d0b5e4122711\" for Radiohead).","operationId":"musicbrainz_get_artist_info","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"artist_id":{"type":"string"}},"required":["artist_id"],"type":"object"}}}}}},"/rest/musicbrainz/get_artist_releases":{"post":{"tags":["Media"],"summary":"get_artist_releases","description":"Get albums and releases for an artist.\n\nReturns release titles, dates, countries, and track counts.\n\nArgs:\n    artist_id: MusicBrainz artist UUID.\n    limit: Maximum results (1-100, default 25).","operationId":"musicbrainz_get_artist_releases","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"artist_id":{"type":"string"},"limit":{"default":25,"type":"integer"}},"required":["artist_id"],"type":"object"}}}}}},"/rest/musicbrainz/search_recordings":{"post":{"tags":["Media"],"summary":"search_recordings","description":"Search for songs/recordings by title.\n\nReturns recording titles, artists, duration, and first release dates.\n\nArgs:\n    query: Song or track title (e.g. \"Bohemian Rhapsody\", \"Take On Me\").\n    limit: Maximum results (1-25, default 10).","operationId":"musicbrainz_search_recordings","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"type":"string"},"limit":{"default":10,"type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/musicbrainz/report_feedback":{"post":{"tags":["Media"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"musicbrainz_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Media","description":"Data sources: Media"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}