GnistAI GnistAI
Log in

Horoscopes

Zodiac sign information and deterministic daily horoscope readings — sign lookup, birthday-to-sign, compatibility, and daily fortunes.

Overview   |   MCP Docs   |   API Docs   |   OpenAPI   |   Playground   |   Tutorial   |   Toolkits   |   Home
status: healthy status status healthy healthy tools: 7 tools tools 7 7 Entertainment

Data source: In-memory curated collection

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/horoscopes/
claude_desktop_config.json
{
  "mcpServers": {
    "gnist-horoscopes": {
      "url": "https://context.gnist.ai/mcp/horoscopes/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}
Shell
curl -X POST "https://context.gnist.ai/mcp/horoscopes/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_zodiac_sign", "arguments": {"name": "example"}}}'

API REST API

API Root https://context.gnist.ai/rest/horoscopes/

7 endpoints available:

Shell
curl "https://context.gnist.ai/rest/horoscopes/get_zodiac_sign?name=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/horoscopes/get_zodiac_sign",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "name": "example"
},
)
print(resp.json())

OpenAPI Spec  ·  Full API Docs

CLI Command Line

Command gc horoscopes

CLI documentation will be available when the GnistAI SDK is published.

Install
pip install gnistai

Available Tools (7)

list_zodiac_signs
List all 12 zodiac signs with their details.
get_zodiac_sign
Get detailed information about a specific zodiac sign.
ParameterTypeRequiredDescription
namestringrequiredZodiac sign name (e.g. Aries, Taurus, Gemini). Case-insensitive.
get_daily_horoscope
Get the daily horoscope for a zodiac sign.
ParameterTypeRequiredDescription
signstringrequiredZodiac sign name (e.g. Leo, Scorpio). Case-insensitive.
dateanyoptionalDate in YYYY-MM-DD format. Defaults to today.
get_zodiac_sign_by_birthday
Determine which zodiac sign a person is based on their birthday.
ParameterTypeRequiredDescription
monthintegerrequiredBirth month (1-12).
dayintegerrequiredBirth day (1-31).
check_zodiac_compatibility
Check astrological compatibility between two zodiac signs.
ParameterTypeRequiredDescription
sign1stringrequiredFirst zodiac sign name. Case-insensitive.
sign2stringrequiredSecond zodiac sign name. Case-insensitive.
list_astrological_elements
List the four classical elements used in astrology.
report_feedback
Report a bug, feature request, or general feedback for this data source.
ParameterTypeRequiredDescription
feedbackstringrequired
feedback_typestringoptional (default: "general")

Related