{"openapi":"3.0.3","info":{"title":"Gnist Context — Cat Breeds","description":"Curated cat breed database — 50+ breeds with temperament, coat type, size, origin, and care characteristics.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/cat-breeds/`\n- **Toolkit page:** `/toolkits/cat-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/cat-breeds/get_cat_breed":{"post":{"tags":["Reference"],"summary":"get_cat_breed","description":"Get detailed information about a specific cat breed by its ID.\n\nReturns breed characteristics including size, weight, temperament, coat type, and compatibility info.","operationId":"cat_breeds_get_cat_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":"Breed ID slug (e.g. 'persian', 'maine-coon', 'russian-blue').","type":"string"}},"required":["breed_id"],"type":"object"}}}}}},"/rest/cat-breeds/list_cat_breeds":{"post":{"tags":["Reference"],"summary":"list_cat_breeds","description":"List cat breeds with optional filters.\n\nFilters can be combined (AND logic). Returns all breeds if no filters are specified.","operationId":"cat_breeds_list_cat_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":{"origin":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by country of origin (e.g. 'United States', 'Thailand'). Omit for all origins."},"size":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by size: Small, Medium, or Large. Omit for all sizes."},"coat_length":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by coat length: Short, Medium, Long, or Hairless. Omit for all types."}},"type":"object"}}}}}},"/rest/cat-breeds/search_cat_breeds":{"post":{"tags":["Reference"],"summary":"search_cat_breeds","description":"Search for cat breeds by keyword.\n\nSearches across breed name, origin, temperament traits, coat length, and description. Case-insensitive.","operationId":"cat_breeds_search_cat_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, origin, temperament, coat type, 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/cat-breeds/get_random_cat_breed":{"post":{"tags":["Reference"],"summary":"get_random_cat_breed","description":"Get a random cat breed.\n\nReturns full details for a randomly selected breed from the database.","operationId":"cat_breeds_get_random_cat_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/cat-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":"cat_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."}}}}