Give Your AI Astrology Superpowers
Professional astrology for Claude, ChatGPT, n8n workflows, and AI agents. Build chatbots, automate horoscopes, create intelligent assistants - all with 16 professional tools.
Works seamlessly with
+ Cursor, Make, Telegram, WhatsApp, Slack, and any MCP-compatible client
Enterprise MCP Performance
Production-ready astrology for AI assistants, chatbots, and automation
Quick Setup: Add to Your AI in 30 Seconds
Just paste this config into your MCP client settings
{
"mcpServers": {
"astrology-basic": {
"url": "https://mcp.astrology-api.io/basic/mcp"
},
"astrology-astrocartography": {
"url": "https://mcp.astrology-api.io/astrocartography/mcp"
}
}
}Basic Namespace
Core astrology calculations
- ✓ Natal Charts
- ✓ Transit Analysis
- ✓ Synastry
- ✓ Composite Charts
Astrocartography Namespace
Location-based astrology
- ✓ Relocation Analysis
- ✓ Power Zone Mapping
- ✓ Paran Lines
- ✓ +9 More Tools
Claude Desktop & Claude Code
Connect our MCP server and Claude becomes an expert astrologer who can calculate real charts, not just talk about astrology.
Personal Astrology Assistant
Ask Claude about your daily transits, upcoming challenges, or best timing for important decisions. Get personalized insights based on your actual birth chart, not generic sun-sign predictions.
"What transits are affecting my career this month? I was born March 15, 1990 at 2:30 PM in Chicago."
Relationship Compatibility Analysis
Analyze synastry between you and your partner, friends, or business associates. Claude calculates the actual planetary aspects and interprets their meaning for your relationship.
"Compare my chart with my partner's. Are we compatible for long-term commitment?"
Relocation Decisions
Use astrocartography to find your power zones. Claude can analyze how different cities would affect your career, love life, creativity, or overall wellbeing.
"I'm thinking of moving to Amsterdam or Barcelona. Which city is better for my career according to my astrocartography?"
Content Creation for Astrologers
Generate accurate horoscope content, chart interpretations, and astrological articles. Claude ensures astronomical accuracy while you focus on the narrative.
"Write a weekly forecast for Scorpio rising for the week of January 15-22, based on actual transits."
Learning Astrology
Explore astrological concepts with an AI that can calculate real examples. Ask about any technique and see it applied to actual charts.
"Explain what Saturn return means and show me when mine will be based on my birth date."
Professional Client Readings
Astrologers can speed up client work dramatically. Calculate charts, run compatibility analyses, and explore timing - all through conversation.
"Generate a full natal chart analysis for my client born July 4, 1985 at 11:45 AM in Denver."
ChatGPT & OpenAI
While ChatGPT doesn't natively support MCP, you can connect our astrology tools through bridges and custom integrations.
Custom GPTs with Real Astrology
Build a Custom GPT that can calculate actual birth charts. Use our REST API as the action backend, giving your GPT professional astrology capabilities that go beyond generic responses.
GPT-Powered Astrology Chatbots
Build customer-facing chatbots that provide personalized astrology. Use GPT for natural conversation and our API for accurate calculations.
Content Generation at Scale
Generate thousands of personalized horoscopes or chart interpretations. GPT handles the writing style, our API ensures astronomical accuracy.
Voice Assistants
Build voice-enabled astrology assistants using GPT's speech capabilities. Users speak their birth data, get spoken interpretations.
Integration Options
- ✓ REST API - Direct integration with our astrology endpoints
- ✓ MCP-to-OpenAI Bridge - Use tools like mcp-to-openai for function calling
- ✓ Custom Actions - Add our API as a Custom GPT action
- ✓ LangChain/LlamaIndex - Use our API as a tool in your AI pipeline
n8n Workflow Automation
Connect our MCP server to n8n and build powerful automated workflows. Send personalized horoscopes, trigger alerts on astrological events, enrich your CRM with birth chart data.
Automated Daily Horoscope Emails
Set up a workflow that generates personalized daily horoscopes for your email list. Each subscriber gets a forecast based on their birth chart, not generic sun-sign content.
Schedule Trigger (daily) > Get subscriber birth data > Call AstroAPI for transits > Generate personalized forecast > Send via SendGrid/Mailchimp
Every morning at 6 AM, send each subscriber their personalized transit report for the day.
Birthday-Triggered Solar Return Readings
Automatically send customers a free Solar Return reading on their birthday. Great for retention and engagement.
Birthday webhook > Calculate Solar Return chart > Generate year-ahead forecast > Send personalized email + offer
"Happy Birthday Sarah! Here's what the stars say about your year ahead..."
Astrology Chatbots (Telegram, WhatsApp, Slack)
Build messaging bots that respond to astrology questions with real calculations. Users send their birth data, bot responds with chart interpretations.
Telegram webhook > Parse user message > Extract birth data > Call AstroAPI > Format response > Send reply
User: '/chart 1990-03-15 14:30 New York' > Bot: Full natal chart analysis with AI interpretation
Mercury Retrograde Alert System
Notify your users before Mercury (or any planet) goes retrograde. Build anticipation and provide practical advice.
Schedule check (weekly) > Get upcoming retrogrades > Filter by date > Send alert emails to affected signs
"Heads up! Mercury goes retrograde in 3 days. Here's how it affects YOUR chart..."
CRM Enrichment with Astrological Data
Automatically enrich your customer profiles with astrological insights. Know their sun/moon/rising, current transits, compatibility scores.
New contact webhook > Extract birth data > Calculate full chart > Store sun/moon/rising + key aspects in CRM
Sales team sees: "Lead is a Virgo Sun/Cancer Moon - detail-oriented, values security. Good timing for outreach: next week."
Content Calendar Automation
Auto-generate astrological content for social media based on actual transits. Post about real cosmic events, not made-up content.
Daily trigger > Get today's major transits > Generate social posts > Schedule to Buffer/Hootsuite
Auto-post: "Venus enters Pisces today! Here's what it means for each sign..."
Lead Scoring by Compatibility
Score leads based on astrological compatibility with your brand's founding chart. Prioritize outreach to naturally aligned prospects.
New lead > Calculate synastry with company chart > Score compatibility > Tag in CRM > Notify sales if high match
"High-compatibility lead alert: 87% synastry match with company energy. Prioritize outreach."
Event Timing Optimization
Automatically find optimal dates for launches, meetings, or campaigns based on electional astrology principles.
Input date range + purpose > Calculate planetary positions > Score each date > Return ranked options
"Best dates for product launch in March: 15th (Venus-Jupiter), 22nd (Mercury direct), avoid 3rd-7th."
n8n HTTP Request Node
AI Agents & Autonomous Systems
Create AI agents that can autonomously perform astrological analysis, make recommendations, and take actions based on cosmic timing.
Autonomous Astrology Consultant
Build an agent that conducts full astrological consultations. It asks clarifying questions, calculates relevant charts, interprets results, and provides actionable recommendations - all autonomously.
- ✓ Multi-turn conversation to gather birth data
- ✓ Decides which charts to calculate based on user questions
- ✓ Combines natal, transit, and synastry analysis as needed
- ✓ Provides specific timing recommendations
Relocation Research Agent
An agent that researches optimal locations for a user. It queries astrocartography data, cross-references with practical factors, and delivers a comprehensive relocation report.
- ✓ Analyzes full astrocartography map
- ✓ Filters by user preferences (climate, language, cost)
- ✓ Ranks cities by astrological potential
- ✓ Researches practical information about top matches
Trading Signal Agent
Combine financial astrology with market analysis. Agent monitors planetary aspects, identifies traditionally significant configurations, and generates alerts.
- ✓ Monitors real-time planetary positions
- ✓ Identifies Gann-relevant aspects
- ✓ Correlates with historical market patterns
- ✓ Generates buy/sell timing signals
Content Production Agent
Autonomous agent that produces astrological content daily. Writes horoscopes, creates social posts, generates newsletter content - all based on actual transits.
- ✓ Monitors daily planetary movements
- ✓ Generates sign-by-sign forecasts
- ✓ Creates engaging social media content
- ✓ Writes long-form articles for blogs
Customer Success Agent
An agent that proactively reaches out to customers during significant transits. Offers support during challenging aspects, celebrates favorable ones.
- ✓ Monitors customer birth charts continuously
- ✓ Detects significant upcoming transits
- ✓ Triggers personalized outreach
- ✓ Offers relevant products/services
Matchmaking Agent
Build an agent for dating apps or HR that analyzes compatibility. It calculates synastry, identifies strengths/challenges, and provides matching scores.
- ✓ Batch processes compatibility calculations
- ✓ Ranks matches by synastry score
- ✓ Identifies key relationship dynamics
- ✓ Suggests conversation starters based on charts
Compatible Agent Frameworks
What is Astrology MCP Server? Complete Guide
Everything you need to know about adding professional astrology to AI assistants, chatbots, and automation
Ever wished your AI could calculate real birth charts, not just talk about astrology? That's exactly what our Astrology MCP Server does. MCP (Model Context Protocol) is a universal plugin system for AI - it lets Claude, ChatGPT integrations, n8n workflows, and AI agents connect to external tools. Our server gives any compatible system instant access to 16 professional astrology tools. Setup takes 30 seconds. Build Telegram bots that cast charts, automate personalized horoscope emails, create AI agents that provide astrological consulting - all powered by the same backend serving 2M+ calculations monthly.
How do I add astrology to Claude Desktop?
Open your Claude Desktop config file (Settings > Developer > Edit Config), and paste this: {"mcpServers": {"astrology-basic": {"url": "https://mcp.astrology-api.io/basic/mcp"}}}.
That's it.
Save, restart Claude, and ask "Calculate my birth chart for January 15, 1990 at 3:30 PM in New York".
Claude will use our MCP server to compute exact planetary positions, aspects, house placements, and give you an AI-interpreted reading.
Want astrocartography too? Add the second namespace and ask "Where should I move for career success?" Our server handles all the complex calculations - Claude just presents the results conversationally.
Can I build astrology chatbots with this?
Absolutely - that's one of the most popular use cases.
Connect our MCP to n8n or Make, add a Telegram/WhatsApp/Slack trigger, and you have a working astrology bot in under an hour.
Users send their birth data, your bot calculates their chart and responds with personalized interpretations.
Unlike generic horoscope bots that just return pre-written content, yours does real calculations.
Example: User sends '/compatibility 1990-03-15 14:30 NYC, 1988-07-22 09:15 LA' - bot calculates actual synastry and returns genuine compatibility analysis.
How do I automate horoscope emails with n8n?
Create a workflow: Schedule trigger (daily at 6 AM) > Loop through subscribers > For each: HTTP Request to our API with their birth data > Get personalized transits > Use AI node to write natural-language forecast > Send email.
Each subscriber gets a unique forecast based on their actual chart.
You can add their current transits, upcoming aspects, and personalized advice.
Scale to thousands of subscribers - our API handles the load.
Most astrology newsletters just blast the same content to everyone.
Yours becomes genuinely personalized.
What about ChatGPT and OpenAI integration?
ChatGPT doesn't directly support MCP (that's Anthropic's protocol), but you have options.
Build a Custom GPT and add our REST API as a custom action - now your GPT can calculate real charts.
Use LangChain or LlamaIndex with our API as a tool.
Or use bridges like mcp-to-openai that translate between protocols.
For simpler use cases, just call our API from your backend and feed results to GPT for interpretation.
The point: if you're building GPT-powered apps, you can absolutely add real astrology calculations.
Can AI agents use astrology tools autonomously?
Yes - and this is where it gets interesting.
Build agents that autonomously consult astrology for decisions.
A relocation agent that researches cities using astrocartography data.
A trading agent that monitors planetary aspects for timing signals.
A content agent that produces daily horoscopes based on actual transits.
A customer success agent that reaches out during significant transits.
These agents can chain multiple tools: calculate chart > analyze transits > cross-reference with user goals > generate recommendations > take action.
MCP makes astrology just another tool in your agent's toolkit.
What makes this better than other astrology MCPs?
Most astrology MCP servers on GitHub are weekend projects that depend on external APIs (which go down), require local Node.js installation, and only do basic sun-sign horoscopes.
Ours is different: it's powered by AstroAPI, the same backend serving 2M+ professional calculations monthly.
You get 16 dedicated tools across 2 namespaces - basic astrology (natal, transit, synastry, composite) and astrocartography (relocation analysis, power zones, paran mapping).
Everything runs on our infrastructure with 99.95% uptime SLA.
While other servers give you "Aries: Today is good for communication", we give you actual ephemeris-based calculations with degree-accurate positions.
Use Cases
AI Assistants (Claude/ChatGPT)
Personal astrology consultations, chart calculations, timing advice - conversational interface to professional astrology
Telegram/WhatsApp Bots
Build messaging bots that calculate charts, check compatibility, and provide daily forecasts to users
Email Automation
Send personalized horoscopes, birthday readings, and transit alerts to your subscriber list
AI Agents
Create autonomous systems that use astrology for timing, matching, content creation, and decision support
CRM Enrichment
Add astrological data to customer profiles for personalized marketing and sales timing
Content Production
Generate accurate horoscopes, social posts, and articles at scale with real planetary data
Technical Specifications
| MCP Spec Version | 2025-06-18 (latest) |
| Transport Protocol | Streamable HTTP |
| Total Tools | 16 across 2 namespaces |
| Basic Namespace Tools | 4 (natal, transit, synastry, composite) |
| Astrocartography Tools | 12 (relocation, paran, local space, etc.) |
| Hosting | Cloud-hosted, no installation required |
| Uptime SLA | 99.95% |
| Response Time | <500ms average |
| Ephemeris Precision | 0.001 arcseconds (Swiss Ephemeris) |
| House Systems | 23 supported |
| Supported Platforms | Claude, Cursor, n8n, Make, LangChain, custom |
| Languages | 9 for interpretations |
| Automation Ready | Webhooks, batch processing, scheduling |
Astrology MCP Server Comparison 2025: AstroAPI vs Natal MCP vs Horoscope MCP vs BaZi MCP
| Feature | AstroAPI | Others |
|---|---|---|
| Tools Available | 16 professional tools | |
| Hosting Model | Cloud-hosted (instant) | |
| Astrology Type | Western + Astrocartography | |
| Birth Chart Calculations | Full natal, transit, synastry, composite | |
| Astrocartography | 12 dedicated tools | |
| Chatbot/Automation Ready | Yes + n8n/Make guides | |
| Uptime SLA | 99.95% | |
| Response Time | <500ms | |
| AI Agent Integration | LangChain, CrewAI, AutoGPT | |
| Scale | 2M+ calculations/month |
16 Professional Astrology Tools
Two specialized namespaces for comprehensive astrological analysis
Frequently Asked Questions about Astrology MCP
Real answers about connecting astrology to your AI, chatbots, and automation
Explore More AstroAPI Products
The MCP server is powered by the same backend as our direct APIs. For different integration patterns, explore Natal Chart API for direct REST access to birth charts, Transit API for real-time planetary tracking, Astrocartography API for location-based astrology, Synastry API for relationship compatibility.
Precios Simples y Transparentes
Comienza gratis, escala a medida que creces. Sin cargos ocultos.
Starter
Para apps pequenas y proyectos personales
- Todos los endpoints basicos
- 12 sistemas de casas
- Soporte por email
Profesional
Para aplicaciones de astrologia en crecimiento
- Todos los endpoints mejorados
- 23 sistemas de casas
- Interpretaciones con IA
- Soporte prioritario
Business
Para aplicaciones de alto volumen
- TODOS los endpoints
- Listo para marca blanca
- Soporte telefonico
Todos los planes incluyen documentacion completa y SDKs
Preguntas? Habla con nuestro equipo