{"openapi":"3.0.3","info":{"title":"Gnist Context — Horoscopes","description":"Zodiac sign information and deterministic daily horoscope readings — sign lookup, birthday-to-sign, compatibility, and daily fortunes.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/horoscopes/`\n- **Toolkit page:** `/toolkits/horoscopes`\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/horoscopes/list_zodiac_signs":{"post":{"tags":["Entertainment"],"summary":"list_zodiac_signs","description":"List all 12 zodiac signs with their details.\n\nReturns every sign's name, symbol, element, quality, ruling planet, date range,\npersonality traits, and compatible signs.","operationId":"horoscopes_list_zodiac_signs","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/horoscopes/get_zodiac_sign":{"post":{"tags":["Entertainment"],"summary":"get_zodiac_sign","description":"Get detailed information about a specific zodiac sign.\n\nReturns the sign's symbol, element, quality, ruling planet, date range,\npersonality traits, and compatible signs.","operationId":"horoscopes_get_zodiac_sign","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":{"name":{"description":"Zodiac sign name (e.g. Aries, Taurus, Gemini). Case-insensitive.","type":"string"}},"required":["name"],"type":"object"}}}}}},"/rest/horoscopes/get_daily_horoscope":{"post":{"tags":["Entertainment"],"summary":"get_daily_horoscope","description":"Get the daily horoscope for a zodiac sign.\n\nReturns a horoscope reading, lucky number, lucky color, and mood for the day.\nThe reading is deterministic — the same sign and date always produce the same result.","operationId":"horoscopes_get_daily_horoscope","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":{"sign":{"description":"Zodiac sign name (e.g. Leo, Scorpio). Case-insensitive.","type":"string"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date in YYYY-MM-DD format. Defaults to today."}},"required":["sign"],"type":"object"}}}}}},"/rest/horoscopes/get_zodiac_sign_by_birthday":{"post":{"tags":["Entertainment"],"summary":"get_zodiac_sign_by_birthday","description":"Determine which zodiac sign a person is based on their birthday.\n\nTakes a month and day and returns the corresponding zodiac sign with full details.","operationId":"horoscopes_get_zodiac_sign_by_birthday","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":{"month":{"description":"Birth month (1-12).","type":"integer"},"day":{"description":"Birth day (1-31).","type":"integer"}},"required":["month","day"],"type":"object"}}}}}},"/rest/horoscopes/check_zodiac_compatibility":{"post":{"tags":["Entertainment"],"summary":"check_zodiac_compatibility","description":"Check astrological compatibility between two zodiac signs.\n\nReturns a compatibility score (0-100) and description based on element pairings\nand traditional astrological compatibility.","operationId":"horoscopes_check_zodiac_compatibility","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":{"sign1":{"description":"First zodiac sign name. Case-insensitive.","type":"string"},"sign2":{"description":"Second zodiac sign name. Case-insensitive.","type":"string"}},"required":["sign1","sign2"],"type":"object"}}}}}},"/rest/horoscopes/list_astrological_elements":{"post":{"tags":["Entertainment"],"summary":"list_astrological_elements","description":"List the four classical elements used in astrology.\n\nThe elements are Fire, Earth, Air, and Water. Each zodiac sign belongs to one element.","operationId":"horoscopes_list_astrological_elements","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/horoscopes/report_feedback":{"post":{"tags":["Entertainment"],"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":"horoscopes_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":"Entertainment","description":"Data sources: Entertainment"}],"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."}}}}