# AstrologyAPI MCP for AI Agents AI Agent Connect

> AstrologyAPI gives your AI agent the ability to pull real-time astrological data. You can get daily horoscopes, calculate birth charts, and run numerology reports or compatibility checks without leaving your chat window. It turns your agent into a personal celestial guide.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_3ug39IyyzqLBiPQgO2FViFnzlKymV005zYkOevrz/ai-agent-connect
- **Tags:** horoscope, numerology, birth-charts, celestial-data, spiritual-analytics

## Description

Imagine asking your agent for a breakdown of your birth chart and getting an instant analysis of your planetary positions without leaving your chat. This Connector connects your AI client to a global astrology platform, letting you handle complex spiritual data through plain conversation. You don't have to juggle multiple tabs, search through different websites, or manually calculate house positions anymore. You can check daily horoscopes for any sign, run compatibility tests between people, or look up specific spiritual markers like Sade Sati. It's a way to bring professional-grade astrology into your daily routine. Whether you are looking for a quick daily update or a deep dive into your personal growth, your agent acts as a real-time coordinator for all your celestial data. Because Vinkius hosts this and thousands of other tools, you can set this up once and have your agent ready to handle your spiritual wellness needs whenever you ask. You get the same accuracy as a professional service but with the speed of a chat interface. This means you can spend less time on the math and more time on the actual insights.

## Tools

### check_sade_sati
Check if someone is currently in the Sade Sati period. It helps you understand specific spiritual influences quickly.

### get_daily_prediction
Get a daily horoscope for any zodiac sign. This covers health, career, and personal life outlooks.

### get_house_positions
Find out which zodiac houses your planets fall into. This is a key step for building a full birth chart.

### get_matchmaking_details
Run a compatibility analysis between two people. Use birth metadata to see how well two individuals align.

### get_ashtakvarga_score
Calculate ashtakvarga points for a birth chart. This provides deeper technical data for traditional astrology.

### get_basic_panchang
Pull the daily panchang details. It gives you a quick snapshot of the current astrological calendar.

### get_planets_positions
Retrieve the exact planetary positions for a specific birth date and time. It's the foundation for any birth chart analysis.

### get_yoga_analysis
Identify and analyze specialized planetary yogas. This helps find unique spiritual configurations in a chart.

## Prompt Examples

**Prompt:** 
```
What's my horoscope for today as a Leo?
```

**Response:** 
```
**Today's Leo Outlook**

*   **General:** Focus on personal communication and emotional balance.
*   **Health:** Your health outlook is stable. Keep up your current routine.
*   **Career:** There are positive trends in your career. A good day for networking.

Would you like me to check your numerology report for today as well?
```

**Prompt:** 
```
Can you check if I'm in Sade Sati? I was born Oct 12, 1990, in London.
```

**Response:** 
```
I've checked your birth metadata for October 12, 1990, in London.

*   **Sade Sati Status:** You are not currently in a Sade Sati period.
*   **Planetary Positions:** Your Sun was in Libra and your Moon was in Cancer.

Would you like me to identify any specialized yogas or calculate your house positions?
```

**Prompt:** 
```
Compare my birth chart with a friend's for compatibility. I was born in 1990, they were born in 1985.
```

**Response:** 
```
I've analyzed the compatibility between your birth data (1990) and your friend's (1985).

**Match Summary**
*   **Compatibility Score:** 84%
*   **Key Strengths:** Strong emotional alignment and shared career goals.
*   **Areas for Growth:** Differing approaches to communication styles.

Would you like a more detailed breakdown of the planetary yogas for either of you?
```

## Capabilities

### Get daily horoscopes
Pull personal, health, and career predictions for any zodiac sign.

### Calculate birth charts
Find precise planetary and house positions from birth metadata.

### Run compatibility checks
Analyze how well two people match based on their birth details.

### View daily Panchang
Access basic daily astrological details and calendar info.

### Check Sade Sati status
See if a specific individual is currently under this spiritual period.

### Generate numerology reports
Get destiny and radical numbers based on names and birth dates.

### Identify planetary yogas
Analyze specialized planetary combinations in a birth chart.

### Get ashtakvarga scores
Calculate specific points for deeper astrological analysis.

## Use Cases

### Tracking daily zodiac trends
A spiritual researcher wants to see the daily horoscope for all 12 signs at once to track celestial trends.

### Building a custom birth chart
A wellness app developer wants to pull planetary positions for a user's birth date to show a custom chart.

### Checking relationship compatibility
A couple wants to know their compatibility score based on their birth times and locations.

### Verifying spiritual periods
A user wants to know if they are currently in a Sade Sati period to plan their spiritual practice.

## Benefits

- You get daily horoscopes for every sign instantly using get_daily_prediction so you never miss a trend.
- You build precise birth charts using get_planets_positions and get_house_positions without doing manual math.
- You run deep compatibility checks with get_matchmaking_details to see how people align.
- You access specific spiritual markers like Sade Sati with check_sade_sati for targeted insights.
- You generate numerology reports using name and birth data to find destiny numbers quickly.
- You analyze complex planetary yogas with get_yoga_analysis for a more professional reading.

## How It Works

The bottom line is you get instant, accurate astrological data in your chat without any manual calculations.

1. Subscribe to the AstrologyAPI MCP on Vinkius.
2. Add your AstrologyAPI.com User ID and API Key to your client settings.
3. Ask your agent to pull a horoscope or calculate a birth chart.

## Frequently Asked Questions

**Can AstrologyAPI generate a full birth chart?**
Yes, it can pull all planetary and house positions based on your birth date, time, and location.

**How do I get daily horoscopes with AstrologyAPI?**
You can ask your agent for the daily prediction of any zodiac sign to get health and career updates.

**Does AstrologyAPI do numerology?**
Yes, it can generate reports including your destiny and radical numbers based on your name and birth date.

**Can I check compatibility between two people using AstrologyAPI?**
You can use it to run a detailed analysis of how two individuals match based on their birth metadata.

**What is Sade Sati and can AstrologyAPI check it?**
Sade Sati is a spiritual period in Vedic astrology. This Connector can check if someone is currently affected by it.

**Can AstrologyAPI give me my planetary yogas?**
Yes, it can analyze your chart to identify specific planetary yogas for deeper spiritual insights.

**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.