{"openapi":"3.0.3","info":{"title":"Gnist Context — Dog Breeds","description":"Curated dog breed database — search 50+ breeds by group, size, origin, or keyword, with detailed characteristics.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/dog-breeds/`\n- **Toolkit page:** `/toolkits/dog-breeds`\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/dog-breeds/get_dog_breed":{"post":{"tags":["Reference"],"summary":"get_dog_breed","description":"Get detailed information about a specific dog breed.\n\nReturns breed characteristics including size, weight, temperament, coat type, and suitability for families.","operationId":"dog_breeds_get_dog_breed","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":{"breed_id":{"description":"Slug ID of the breed (e.g. 'labrador-retriever', 'german-shepherd').","type":"string"}},"required":["breed_id"],"type":"object"}}}}}},"/rest/dog-breeds/list_dog_breeds":{"post":{"tags":["Reference"],"summary":"list_dog_breeds","description":"List dog breeds with optional filters.\n\nFilters can be combined — for example, list all large breeds from Germany.","operationId":"dog_breeds_list_dog_breeds","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":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"breed_group":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by breed group (e.g. Sporting, Herding, Working, Toy, Terrier, Hound, Non-Sporting)."},"size":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by size (Small, Medium, Large, Giant)."},"origin":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by country of origin (e.g. Germany, Japan, United Kingdom)."}},"type":"object"}}}}}},"/rest/dog-breeds/search_dog_breeds":{"post":{"tags":["Reference"],"summary":"search_dog_breeds","description":"Search dog breeds by keyword.\n\nSearches across breed names, temperament traits, and descriptions. Case-insensitive.","operationId":"dog_breeds_search_dog_breeds","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":{"description":"Search keyword — matches breed name, temperament traits, or description.","type":"string"},"max_results":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of results (default: 20, max: 100)."}},"required":["query"],"type":"object"}}}}}},"/rest/dog-breeds/get_random_dog_breed":{"post":{"tags":["Reference"],"summary":"get_random_dog_breed","description":"Get a random dog breed from the database.\n\nReturns full details for a randomly selected breed — useful for discovery or games.","operationId":"dog_breeds_get_random_dog_breed","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":[]}]}},"/rest/dog-breeds/list_breed_groups":{"post":{"tags":["Reference"],"summary":"list_breed_groups","description":"List all available breed group names.\n\nReturns the group names that can be used to filter breeds (e.g. Sporting, Herding, Working).","operationId":"dog_breeds_list_breed_groups","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":[]}]}},"/rest/dog-breeds/report_feedback":{"post":{"tags":["Reference"],"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":"dog_breeds_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":"Reference","description":"Data sources: Reference"}],"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."}}}}