AstrologyAPI MCP. Synthesize complex celestial predictions into simple answers.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
AstrologyAPI MCP Server connects your AI agent to global astrological data. It gives you daily horoscopes, detailed birth charts, and numerology reports from a single source.
Your agent calculates planetary positions, analyzes compatibility, and checks specific celestial cycles without you jumping between multiple spiritual apps or websites.
What your AI agents can do
Check sade sati
Checks the current status of the Sade Sati planetary cycle.
Get ashtakvarga score
Calculates the Ashtakvarga score based on provided birth data.
Get basic panchang
Retrieves the basic daily panchang details.
Your agent retrieves a full daily horoscope, covering personal, health, and career predictions for any specified zodiac sign.
Your agent determines the exact celestial location of planets based on a specific date, time, and geographic coordinate.
Your agent calculates the specific zodiac house placements for a given birth chart, defining life areas.
Your agent analyzes the compatibility between two individuals by comparing their respective birth metadata.
Your agent creates a detailed numerology report using a person's name and birth date.
Your agent verifies the status of specific planetary cycles, such as Sade Sati, based on the required birth data.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
AstrologyAPI MCP Server: 8 Tools for Celestial Data
Use these 8 tools to calculate planetary scores, get daily predictions, and analyze detailed planetary positions with structured data.
019d8418check sade sati
Checks the current status of the Sade Sati planetary cycle.
019d8418get ashtakvarga score
Calculates the Ashtakvarga score based on provided birth data.
019d8418get basic panchang
Retrieves the basic daily panchang details.
019d8418get daily prediction
Gets the full daily horoscope for a specific zodiac sign.
019d8418get house positions
Calculates the zodiac house placements for a given birth chart.
019d8418get matchmaking details
Analyzes the compatibility between two individuals using their birth data.
019d8418get planets positions
Determines the exact placement of planets in a birth chart.
019d8418get yoga analysis
Analyzes specific planetary combinations (Yogas) in the chart.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with AstrologyAPI, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Your AI client connects to the AstrologyAPI MCP Server, giving your agent access to deep astrological data. You'll use it to get daily horoscopes, detailed birth charts, and numerology reports without jumping between different apps. Your agent calculates planetary positions, analyzes compatibility, and checks specific celestial cycles—all from one place.
Daily Horoscopes: Your agent uses get_daily_prediction to pull the full daily horoscope for any zodiac sign, covering personal, health, and career predictions.
Birth Chart Calculations: To map out your life areas, your agent first runs get_house_positions to calculate the zodiac house placements for a birth chart. You can then determine the exact celestial location of every planet using get_planets_positions with just a date, time, and geographic coordinate.
Compatibility & Analysis: You can analyze how two people fit together using get_matchmaking_details, which compares their birth data. For deeper dives, your agent checks specific planetary combinations with get_yoga_analysis and calculates the Ashtakvarga score using get_ashtakvarga_score.
Advanced Insights: Your agent checks the current status of cycles like Sade Sati with check_sade_sati, and it can pull the basic daily panchang details with get_basic_panchang.
Numerology: You can generate a detailed numerology report using a person's name and birth date.
How AstrologyAPI MCP Works
- 1 Subscribe to the AstrologyAPI MCP Server and input your unique API Key.
- 2 Connect the server to your AI client (like Claude or Cursor).
- 3 Ask your agent a question, like 'What are the career predictions for Gemini?' The agent runs the necessary tools and returns the structured data.
The bottom line is, your AI client runs the complex calculations and gives you a single, readable answer, no matter how many data points are involved.
Who Is AstrologyAPI MCP For?
Anyone who needs structured, complex data interpretation—from wellness apps to spiritual research. Use this if you work with birth data, predictions, or life cycle analysis. You're the person who needs to synthesize multiple data streams (e.g., planetary positions + life area + timing) to give a full answer, not just a list of numbers.
Integrate professional-grade astrological calculations into an AI-driven user routine, calculating birth charts and daily readings without managing the underlying math.
Automate the gathering of daily predictions and celestial trends, using natural language prompts to generate structured content for articles or emails.
Perform deep data audits, checking compatibility between subjects or calculating specific planetary yogas for research papers.
What Changes When You Connect
- Get daily forecasts instantly. Instead of manually checking multiple sources for your zodiac sign, your agent uses
get_daily_predictionto pull comprehensive personal, health, and career insights in one go. - Build accurate charts fast. Calculate precise planetary and house positions using
get_planets_positionsandget_house_positionswith just the date, time, and location. No more manual star map cross-referencing. - Deep dive into relationships. Use
get_matchmaking_detailsto run detailed compatibility analysis between two people, giving you a structured comparison that would otherwise take hours of manual cross-referencing. - Check life cycles in real-time. Need to know if Sade Sati is active? Run
check_sade_satito get an immediate status update without needing a separate spiritual calculator website. - Model complex concepts. Analyzing planetary yogas (
get_yoga_analysis) or calculating Ashtakvarga scores (get_ashtakvarga_score) is now a single command, giving you deep technical data points for your application. - Automate content creation. Run
get_basic_panchangto get foundational daily data, which you can then use to populate content pipelines for daily horoscopes across all signs.
Real-World Use Cases
A User Needs a Daily Reading
A user asks their agent, 'What's my outlook for the week?' The agent runs get_daily_prediction for their sign. It then runs get_basic_panchang to add context and sends a single, unified answer detailing their predictions.
Comparing Two People's Charts
A relationship counselor needs to assess compatibility. They input two sets of birth data and call get_matchmaking_details. The agent returns a structured compatibility report, allowing the counselor to focus on interpretation instead of data gathering.
Building a Wellness App Feature
A developer needs a feature that shows planetary transits. They call get_planets_positions and get_house_positions to get the core coordinates. They can then cross-reference this with get_yoga_analysis to show the user what the celestial interaction means.
Deep Research on Life Cycles
A spiritual researcher needs to check multiple life cycle markers. They run check_sade_sati to check the cycle, then get_ashtakvarga_score for a score, and finally get_basic_panchang for the day's context. All three results are delivered together for a full audit.
The Tradeoffs
Treating the API like a search engine
Asking the agent, 'Tell me about planets, houses, and compatibility.' The agent runs all tools and returns 8 separate data blocks, leaving the user to figure out the connections.
→
Instead, ask a specific, complex question: 'Calculate my compatibility with John Doe and what the house positions suggest for my career this month.' This forces the agent to combine get_matchmaking_details, get_house_positions, and get_planets_positions into a single narrative.
Skipping necessary context data
Trying to run get_yoga_analysis but forgetting to provide the full birth metadata (date, time, location). The tool fails or returns incomplete data, forcing the user to restart the query.
→
Always establish the full birth metadata first. Use get_planets_positions to verify the core chart data, then pass that context to get_yoga_analysis to ensure the interpretation is based on the correct planetary placements.
Using tools in isolation
Calling get_daily_prediction and then ignoring the date context provided by get_basic_panchang. The user's prediction might be based on an old date, leading to misleading advice.
→
Always anchor your query to the current day. Start by calling get_basic_panchang to confirm the date and general cycle, then follow up with get_daily_prediction to ensure the forecast matches the current day's context.
When It Fits, When It Doesn't
Use this server if your goal is interpretation: you need to know why something is happening, not just what the numbers are. Use it when you need to correlate planetary positions (via get_planets_positions) with specific life areas (via get_house_positions) and overlay that with a time constraint (via get_daily_prediction).
Don't use this if you just need a simple lookup (e.g., checking a current global stock price). For simple lookups, a dedicated, single-function API is cleaner. If you only need to know the general panchang details, get_basic_panchang is enough, but if you need to know the meaning of those details, you need the full suite of tools.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by AstrologyAPI. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Reading a full birth chart shouldn't require 12 different websites.
Today, generating a full reading means jumping between sites: one for the basic daily horoscope, another for planetary positions, a third for houses, and maybe a fourth just for numerology. You spend time copying dates and locations, and then you have to manually stitch all the different data points together to make sense of it.
With the AstrologyAPI MCP Server, your agent handles the whole process. You ask for a full reading, and the agent runs `get_planets_positions`, `get_house_positions`, and `get_daily_prediction` automatically. You get one complete, structured answer.
Get Advanced Analysis with AstrologyAPI MCP Server
Manual audits require running separate checks for Sade Sati, analyzing planetary combinations, and calculating compatibility. You have to manage the inputs and the outputs for every single tool, which is a massive time sink.
Now, your agent can coordinate these complex checks. You ask, 'What are my relationship prospects?' The agent calls `get_matchmaking_details` and `get_yoga_analysis` simultaneously, giving you a single, actionable report.
Common Questions About AstrologyAPI MCP
How do I use the get_daily_prediction tool? +
You simply ask your agent for the prediction, specifying the zodiac sign (e.g., 'What is the daily prediction for Scorpio?'). The agent handles the API call and delivers the full forecast.
Can I get a birth chart using get_planets_positions? +
Yes. You provide the full birth metadata (date, time, location), and the agent returns the exact celestial coordinates for all planets in that chart.
Does get_matchmaking_details only work for romantic partners? +
No. You can analyze compatibility for any two people by providing their respective birth data. The tool focuses on general compatibility across various life aspects.
What is the difference between get_house_positions and get_planets_positions? +
Planets positions show where the celestial bodies are. House positions map those bodies to specific areas of life (like career or family) based on the chart structure.
How do I check my Sade Sati status using check_sade_sati? +
Just ask your agent to 'Check my Sade Sati status.' You must provide the necessary birth data, and the tool returns the current status of the cycle.
What data does get_basic_panchang provide, and how do I use it? +
It provides the core daily astronomical details (Tithi, Nakshatra, etc.). This data helps establish the foundational context for any astrological reading, acting as a reliable daily reference point.
Do I need to worry about complex data when I use get_yoga_analysis? +
No, the tool handles the complexity of planetary combinations. You simply provide the necessary birth metadata, and it returns a clear analysis of the specialized planetary yogas.
Are there limitations or rate limits when calling get_ashtakvarga_score? +
The service enforces standard API rate limits. Monitor your usage and implement appropriate caching on your end to prevent throttling during high-volume calls.
How do I find my AstrologyAPI User ID and Key? +
Log in to the AstrologyAPI Dashboard, 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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Indy
Manage your freelance business with proposals, contracts, time tracking, and invoicing that covers the entire client lifecycle.
Flow
Manage projects, tasks, and team collaboration via AI agents with Flow (getflow.com).
Fathom
Manage AI meeting notes via Fathom — list and search meetings, retrieve transcripts and summaries, and track action items directly from any AI agent.
You might also like
Airbyte
Monitor your Airbyte data pipelines via AI — track sync jobs, list sources, and check connections instantly.
AdaptiveWork (Clarizen)
Enterprise project management — manage projects, tasks, resources, and portfolios via AI.
Songkick Alternative
Find concerts and live music events via Songkick — search artists, venues, and locations to track upcoming performances directly from your AI agent.