Model Context Protocol

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.

View Docs
16
AI Tools
2
Namespaces
30s
Setup Time
56+
Calculations
Claude, ChatGPT, n8n
Hosted & Production-Ready
No Installation Required

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

16
MCP Tools
99.95%
Uptime SLA
<500ms
Response Time
10+
Platforms

Quick Setup: Add to Your AI in 30 Seconds

Just paste this config into your MCP client settings

Claude Desktop / Cursor Config
{
  "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
AI Assistants

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
Workflow Automation

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

1Add HTTP Request node
2Method: POST
3URL: https://mcp.astrology-api.io/basic/mcp
4Add your API key header
5Send birth data in request body
6Parse JSON response for chart data
Autonomous Systems

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

LangChain - Use as a tool in your agent chain
AutoGPT - Add as an external capability
CrewAI - Assign to specialist agent roles
BabyAGI - Include in task execution
Claude Agent SDK - Direct MCP integration
Custom frameworks - REST API available

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.

01

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.

2 lines of config, 30 seconds to professional astrology
1 min read
02

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.

Build working astrology bots in under an hour
1 min read
03

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.

Personalized horoscopes at scale, not generic blasts
1 min read
04

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.

Multiple paths to GPT integration
1 min read
05

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.

Astrology becomes an autonomous agent capability
1 min read
06

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.

Production-grade infrastructure, not hobby projects
1 min read

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 Version2025-06-18 (latest)
Transport ProtocolStreamable HTTP
Total Tools16 across 2 namespaces
Basic Namespace Tools4 (natal, transit, synastry, composite)
Astrocartography Tools12 (relocation, paran, local space, etc.)
HostingCloud-hosted, no installation required
Uptime SLA99.95%
Response Time<500ms average
Ephemeris Precision0.001 arcseconds (Swiss Ephemeris)
House Systems23 supported
Supported PlatformsClaude, Cursor, n8n, Make, LangChain, custom
Languages9 for interpretations
Automation ReadyWebhooks, batch processing, scheduling

Astrology MCP Server Comparison 2025: AstroAPI vs Natal MCP vs Horoscope MCP vs BaZi MCP

FeatureAstroAPIOthers
Tools Available16 professional tools
Hosting ModelCloud-hosted (instant)
Astrology TypeWestern + Astrocartography
Birth Chart CalculationsFull natal, transit, synastry, composite
Astrocartography12 dedicated tools
Chatbot/Automation ReadyYes + n8n/Make guides
Uptime SLA99.95%
Response Time<500ms
AI Agent IntegrationLangChain, CrewAI, AutoGPT
Scale2M+ calculations/month

Explore AstroAPI Products

16 Professional Astrology Tools

Two specialized namespaces for comprehensive astrological analysis

Natal Chart Calculator - Complete birth charts with all celestial bodies
Transit Analysis - Current planetary influences on any chart
Synastry Comparison - Two-chart compatibility analysis
Composite Charts - Merged relationship charts

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.

Precos Simples e Transparentes

Comece gratis, escale conforme cresce. Sem taxas ocultas.

OFERTA POR TEMPO LIMITADO

🎉 100% GRATIS Ate 1 de Janeiro de 2026

Sem cartao de credito • Sem chave API necessaria • Politica de Uso Justo

Chamadas API Ilimitadas
Todos os Endpoints
Pronto para Producao

Sempre Gratis

Sem Cartao de Credito

Perfeito para aprender, testar e pequenos projetos pessoais

100 chamadas API/mes
Mapas natais basicos
5 sistemas de casas
Suporte da comunidade

Starter

$11/mes

Para apps pequenos e projetos pessoais

5.000 requisicoes/mes
  • Todos os endpoints basicos
  • 12 sistemas de casas
  • Suporte por email

Business

$99/mes

Para aplicacoes de alto volume

220.000 requisicoes/mes
  • TODOS os endpoints
  • Pronto para marca branca
  • Suporte telefonico

Enterprise

ILIMITADO

Requisicoes ilimitadas com infraestrutura dedicada

Infraestrutura de servidor dedicado
Sub-300ms garantido
Treinamento de modelo IA personalizado
Suporte dedicado 24/7
Marca branca e personalizacao
99,99% uptime SLA
$399+
por mes

Todos os planos incluem documentacao completa e SDKs

Duvidas? Fale com nossa equipe

30 Seconds to AI Astrology

Your AI Is Missing Astrology Superpowers

While others manually calculate charts or use limited sun-sign bots, you could have professional astrology in every conversation, workflow, and agent.

16
Professional Tools
30s
Setup Time
$0
To Start
Get Config NowView Documentation
No installation required
Works with Claude, ChatGPT, n8n
100 free requests

"We built our Telegram astrology bot in one afternoon. Now it serves 5,000+ users daily with personalized readings. Way better than the generic horoscope bots out there."

AK
Alex K.
Founder, StarBot.io

Your Competitors Are Already Automating Astrology

Every day without AI-powered astrology is a day you're falling behind.

Astrology MCP Server | AI Astrology for Claude, ChatGPT, n8n & AI Agents | AstroAPI