# AstrologyAPI MCP > AstrologyAPI lets your agent calculate complex celestial data points, generating everything from daily horoscopes to detailed birth charts and numerology reports. You can run compatibility analyses between people or analyze planetary movements for a specific date of birth. This MCP handles the underlying calculations required for spiritual research and personal growth audits using standardized astrological metrics. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** horoscope, numerology, birth-charts, celestial-data, spiritual-analytics ## Description Your agent connects directly to AstrologyAPI to handle complex celestial data points, bypassing the need to jump between multiple astrology websites or specialized apps. Instead of manual lookups, your AI client fetches personalized predictions instantly. You can get daily horoscopes for any zodiac sign and calculate planetary positions using specific birth details—date, time, and location. This also lets you run detailed compatibility analyses based on two people's metadata. If you need a numerology report or want to check a person's Sade Sati status, it all comes from one source. Connecting this MCP through the Vinkius catalog makes sure your agent always has access to professional-grade astrological data without you worrying about API keys or endpoint management. ## Tools ### check_sade_sati Checks if a person is currently undergoing the Sade Sati planetary period. ### get_ashtakvarga_score Calculates specific astrological points used in chart analysis called ashtakvarga scores. ### get_basic_panchang Retrieves basic daily panchang details, which are fundamental calendar readings for astrology. ### get_daily_prediction Fetches the full horoscope prediction for a given zodiac sign for today's date. ### get_house_positions Determines where planets fall within the twelve zodiac houses based on birth coordinates. ### get_matchmaking_details Analyzes and reports on the compatibility between two individuals using their respective birth charts. ### get_planets_positions Calculates the exact zodiac placement of every planet for a specific date, time, and location. ### get_yoga_analysis Analyzes specialized planetary combinations (yogas) within a birth chart to identify unique astrological patterns. ## Prompt Examples **Prompt:** ``` Show me the daily prediction for 'Scorpio'. ``` **Response:** ``` I've retrieved the daily prediction for Scorpio. Today, you should focus on personal communication and emotional balance. Your health outlook is stable, and there are positive trends in your career. Would you like me to check your numerology report for today as well? ``` **Prompt:** ``` Get the birth chart planets for: Born 12 Oct 1990, 14:30 in London (Lat: 51.5, Lon: -0.12, TZ: 1). ``` **Response:** ``` I've calculated the planetary positions for that birth metadata. The Sun was in Libra, the Moon was in Cancer, and Mars was in Gemini. Should I also check the house positions or identify any specialized yogas in this chart? ``` **Prompt:** ``` Generate a numerology report for 'John Doe' born on 15 Jan 1985. ``` **Response:** ``` I've generated the numerology report for John Doe. Your Destiny Number is 3, reflecting creativity and self-expression. Your Radical Number is 6. Would you like me to provide a detailed explanation of what these numbers mean for your personal growth? ``` ## Capabilities ### Generate daily predictions It pulls today’s horoscope, covering personal life, career outlook, and health advice for any sign. ### Calculate natal chart details You can define a person's birth metadata to get precise planetary and house positions in their zodiac chart. ### Analyze relationships It performs detailed compatibility checks between two individuals using both of their birth data points. ### Determine life cycles You can check the status of specific astrological periods, like Sade Sati, and analyze planetary alignments (yogas). ### Create numerology reports It generates a full report using just a name and birth date to identify core life numbers. ## Use Cases ### Analyzing a relationship for a client A therapist wants to understand the dynamics between two clients. They ask their agent to run `get_matchmaking_details` using both birth charts, getting an immediate compatibility report without leaving the chat interface. ### Creating a daily content feed A digital wellness company needs 12 distinct horoscope readings for social media. They call `get_daily_prediction` repeatedly for all signs (Aries through Pisces), batching out the entire day's celestial data in one go. ### Validating a historical chart reading An academic researcher needs to confirm planetary alignments from 1985. They use `get_planets_positions` and follow up with `get_yoga_analysis` to check for specific patterns, validating the data against known astrological texts. ### Generating personalized client profiles A coaching service needs a quick profile. They input a name and birth date, calling the numerology functions to generate a comprehensive report that outlines the person's core life numbers. ## Benefits - Get a full scope of predictions for any zodiac sign by using `get_daily_prediction`. This single call covers personal, career, and health forecasts, eliminating the need to consult multiple daily reading sources. - Ground your analysis in precise data by calling `get_planets_positions` first. You get accurate planetary placements based on specific birth coordinates before running any other calculation like `get_yoga_analysis`. - Stop guessing at compatibility. Use `get_matchmaking_details` to analyze the relationship between two people, providing a detailed report that goes beyond simple sign matching. - Automate complex life cycle tracking by checking Sade Sati status with `check_sade_sati`. This saves time compared to manually calculating planetary transits for an entire period. - Understand how different life areas are affected by calling `get_house_positions`. Knowing which houses are involved helps pinpoint whether a prediction relates to career, family, or health. ## How It Works The bottom line is your agent sends a natural language query, and this MCP handles all the underlying complex astronomical math to return clean data for you to use. 1. You configure your AI client with the required User ID and API Key for AstrologyAPI. 2. Your agent determines which specific astrological calculation is needed, such as running `get_planets_positions` or fetching a daily horoscope using `get_daily_prediction`. 3. The MCP executes the request against the API and returns structured data detailing the required celestial analysis. ## Frequently Asked Questions **How do I check Sade Sati status using the `check_sade_sati` tool?** You provide the required birth metadata (date, time, location). The `check_sade_sati` function returns a clear determination of whether or not the individual is currently transiting that planetary period. **What does `get_matchmaking_details` analyze?** `get_matchmaking_details` performs an in-depth compatibility analysis between two people. It uses both of their birth charts to give a detailed report on their relationship potential. **Do I need to use `get_planets_positions` before other tools?** It's best practice. Calling `get_planets_positions` first establishes the accurate baseline for every planet in a chart, ensuring that subsequent calculations like `get_yoga_analysis` are based on the correct data set. **What if I only want today's horoscope? Should I use `get_daily_prediction`?** Yes. If your goal is just a general, day-specific forecast for a sign, `get_daily_prediction` is the most direct tool and will deliver the full daily reading without needing detailed birth coordinates. **What geographical data does the `get_house_positions` tool need?** It requires a precise date, time, and geographic location. Providing these inputs ensures accurate house calculations for your birth chart analysis. **Can I use `get_ashtakvarga_score` along with other tools?** Yes, you can chain the calculations. You pass data from one tool's output to another for a more comprehensive and multi-faceted astrological reading. **What specific details does `get_basic_panchang` provide?** This tool retrieves the core Panchang components for any given day. You get essential Hindu calendar data like Tithi, Nakshatra, and Karana. **If I give an invalid date to `get_planets_positions`, what happens?** The system returns a specific error detailing the issue immediately. This helps you correct unsupported formats or impossible birth data. **How do I find my AstrologyAPI User ID and Key?** Log in to the [AstrologyAPI Dashboard](https://astrologyapi.com/), navigate to the 'API Settings' or 'My Account' section, and copy your unique User ID and API Key. **What is the coordinate format for birth charts?** AstrologyAPI requires numeric Latitude and Longitude. For example, London is approximately `lat: 51.5` and `lon: -0.12`. You should also provide the correct timezone offset (e.g., `0` for London). **Does the API support Vedic astrology?** Yes! AstrologyAPI is a leader in Vedic calculations. Tools like `get_basic_panchang` and `get_yoga_analysis` provide deep insights based on traditional Vedic principles.