Skip to main content
AllMCPs
BrowseBestCategoriesStackCompareToolsGuidesBlog
Log in Submit MCP

Stay in the loop

Get new MCP servers and top picks in your inbox.

AllMCPs

The open directory for discovering and installing Model Context Protocol servers.

AllMCPs on GitHub (opens in a new tab)
Launched onTiny Startupstinystartups.com
Explore
  • Browse servers
  • Best MCP servers
  • Categories
  • MCP clients
  • Agent prompts
  • Stack Builder
  • Compare servers
  • Random discovery New
  • Submit a server
  • Pricing & Boost Boost
Learn
  • Guides hub
  • What is MCP?
  • Install guide
  • Build an MCP server
  • Deploy an MCP server
  • Security guide
  • Troubleshooting
  • MCP for SEO & AEO
  • Protocol versioning
  • Transports: stdio vs HTTP
  • State of MCP (stats)
  • Blog & updates
Tools
  • All developer tools
  • Config generator
  • Config validator
  • Config auditor
  • MCP playground
  • Token calculator
  • OpenAPI โ†’ MCP
  • Badge generator
For agents
  • REST API docs
  • Trust & traffic Live
  • Remote MCP server SSE โ†— (opens in a new tab)
  • llms.txt โ†— (opens in a new tab)
  • Catalog JSON โ†— (opens in a new tab)
Company
  • About
  • Advertise Sponsor
  • Contact
  • GitHub โ†— (opens in a new tab)
  • Terms
  • Privacy
AllMCPs VerifiedAllMCPs VerifiedFeatured on Nick LaunchesFeatured on Nick LaunchesLaunch Llama NewsletterLaunch Llama NewsletterVerified DR - allmcps.comVerified DR - allmcps.comFeatured on SaaSGrowFeatured on SaaSGrowFeatured on Twelve ToolsFeatured on Twelve ToolsFeatured on Saaspa.geFeatured on Saaspa.geFeatured on Findly.toolsFeatured on Findly.toolsFeatured on Startup FameFeatured on Startup FameFeatured on LaunchKiwiFeatured on LaunchKiwiFeatured on ScrollLaunchFeatured on ScrollLaunchFeatured on DailyPingsFeatured on DailyPingsFazier badgeFazier badgeFeatured on NewTool.siteFeatured on NewTool.siteFeatured on saasfame.comFeatured on saasfame.comDR Checker - Domain RatingDR Checker - Domain RatingListed on Turbo0Listed on Turbo0Launched on LaunchBoard - Product Launch PlatformLaunched on LaunchBoard - Product Launch PlatformList on SimilarlabsList on Similarlabshttps://codetrendy.comhttps://codetrendy.comListed on DevTool.ioFeatured on BuildlistFeatured on BuildlistLaunched on Tiny StartupsFeatured on ShowMeBestAIFeatured on ShowMeBestAIFind us on LaunchZoneFind us on LaunchZoneAllMCPs VerifiedAllMCPs VerifiedFeatured on Nick LaunchesFeatured on Nick LaunchesLaunch Llama NewsletterLaunch Llama NewsletterVerified DR - allmcps.comVerified DR - allmcps.comFeatured on SaaSGrowFeatured on SaaSGrowFeatured on Twelve ToolsFeatured on Twelve ToolsFeatured on Saaspa.geFeatured on Saaspa.geFeatured on Findly.toolsFeatured on Findly.toolsFeatured on Startup FameFeatured on Startup FameFeatured on LaunchKiwiFeatured on LaunchKiwiFeatured on ScrollLaunchFeatured on ScrollLaunchFeatured on DailyPingsFeatured on DailyPingsFazier badgeFazier badgeFeatured on NewTool.siteFeatured on NewTool.siteFeatured on saasfame.comFeatured on saasfame.comDR Checker - Domain RatingDR Checker - Domain RatingListed on Turbo0Listed on Turbo0Launched on LaunchBoard - Product Launch PlatformLaunched on LaunchBoard - Product Launch PlatformList on SimilarlabsList on Similarlabshttps://codetrendy.comhttps://codetrendy.comListed on DevTool.ioFeatured on BuildlistFeatured on BuildlistLaunched on Tiny StartupsFeatured on ShowMeBestAIFeatured on ShowMeBestAIFind us on LaunchZoneFind us on LaunchZone
ยฉ 2026 Jackalope Digital LLC. All rights reserved.
  1. Home
  2. ๐Ÿ”ฎ Spirituality & Esoterica
  3. Astro
Astro logo
Health: ActiveRecent health check succeeded.Last checked 9/23/2026, 3:16:58 AM

Astro

User RatingsBe the first to rate and review this MCP server! Enrichment pendingWe havenโ€™t run our AI enrichment pass on this listing yet, so the overview, use cases, and FAQ below may be sparse or missing. We work through the catalog over time โ€” check back soon.
View Repository8 GitHub StarsTotal stargazers on GitHub for the source repository (8 stars).Visit Website

Multi-tradition astrology. 19 modes, 18 tools. Deterministic ephemeris engine.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent โ€” or use 1-click editor setup below.

Add to CursorAdd to VS Code
Manual Client & Custom JSON ConfigExpand JSON โ–พ

Client Config & Setup

Remote HTTP
Choose your client or environment
Target File:~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "astro": {
      "url": "https://astro-api-a2rc.onrender.com/mcp/sse"
    }
  }
}

๐Ÿ’ก Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Install Directory Badge Claim listing Alternatives๐Ÿ”ฎ More in Spirituality & Esoterica

Documentation Overview

Astro โ€” Multi-Tradition Astrology Engine for AI Agents

Trustworthy birth charts, transits, and synastry across Western, Vedic/Jyotish, and Chinese BaZi. The engine computes; the model interprets.

MIT Python 3.10+ MCP REST Deploy smithery badge


Paste this into any AI chat or agent (Claude, ChatGPT, Gemini, Claude Code, Cursor, Codex, DeepSeek, Perplexityโ€ฆ). It installs Astro itself โ€” you don't set anything up first:

Code
You are my personal astrologer powered by Astro, an open-source multi-tradition astrology engine that computes mathematically real charts instead of guessing: https://github.com/aryaminus/astro

SET YOURSELF UP now using whatever you're capable of โ€” try in this order, don't ask me first:
1. If you can run shell/terminal commands, get the pure-Python engine (zero dependencies โ€” no pip install) by ANY of these:
   - `git clone https://github.com/aryaminus/astro` โ€” most reliable; engine at astro/skills/astrology/scripts/astro_engine.py
   - `npx skills add aryaminus/astro -g` โ€” installs the skill on Claude Code, Cursor, Codex, Gemini CLI + 50+ hosts (engine at skills/astrology/scripts/astro_engine.py)
   - latest packaged release (needs only curl + unzip): `curl -L -o astrology.skill https://github.com/aryaminus/astro/releases/latest/download/astrology.skill && unzip astrology.skill` โ€” engine then at scripts/astro_engine.py
   Then run it: `python3 <path>/astro_engine.py --json '{"year":1990,"month":6,"day":15,"hour":14,"minute":30,"lat":40.7128,"lng":-74.0060,"tz":"America/New_York"}'`. Required: year, month, day, lat, lng (decimals, East +/West โˆ’), tz (IANA name like "America/New_York"); optional: hour+minute (omit โ†’ Sun-sign level), name, gender, "mode" (transit / synastry / compatibility / solar_return / โ€ฆ), "systems":["western","vedic","bazi"]. Look up the user's city's lat/lng/tz yourself.
2. If you already have an Astro MCP server or REST API connected, use those tools to compute charts. Public MCP SSE endpoint: `https://astro-api-a2rc.onrender.com/mcp/sse` (~30s cold start after idle).
3. If you can only browse the web: read the canonical spec and follow it as your operating instructions โ€” https://raw.githubusercontent.com/aryaminus/astro/main/skills/astrology/SKILL.md โ€” and fetch the classical reference rulesets it links (western, vedic, bazi, synastry-and-timing, consultation) from https://github.com/aryaminus/astro/tree/main/skills/astrology/references
4. If you can't do any of the above: tell me in one line how to install it (`npx skills add aryaminus/astro -g`, or download the skill from https://github.com/aryaminus/astro/releases/latest for claude.ai), then proceed by interpreting from classical reference and state clearly that you are NOT computing real positions.

THEN behave exactly as Astro's SKILL.md defines:
- COMPUTE the real chart before interpreting โ€” NEVER invent a planetary position, house, or aspect. If no compute path worked, say so honestly.
- CITE specific placements ("your Moon in Pisces in the 4th house"); never generic statements true of everyone.
- ROUTE by question: love โ†’ synastry/compatibility; timing/career โ†’ transits; year ahead โ†’ solar return + progressions; where to live โ†’ astrocartography; auspicious dates โ†’ electional + panchang.
- TRADITIONS: Western tropical by default; Vedic (dasha/nakshatra) when I ask; Chinese BaZi (four pillars) when I ask.
- ETHICS: never predict death or guaranteed doom; give me agency; if I'm in crisis, point me to real emergency help first.

Now ask me for my birth details (date โ€” and ideally exact time + city) and let's begin.

Local install โ€” works on Claude Code, Cursor, Codex, Copilot, Gemini CLI, and 50+ Agent Skills hosts:

Terminal
npx skills add aryaminus/astro -g

Astro skill in action

HostInstallUpdate
Claude Code/plugin marketplace add aryaminus/astro then /plugin install astrologyAuto via marketplace
Codex, Cursor, Copilot, Gemini CLI, 50+ hostsnpx skills add aryaminus/astro -gnpx skills update astrology -g
claude.aiDownload .skill โ†’ Customize โ†’ Skills โ†’ +Re-download
ChatGPTCopy openapi.yaml into Custom GPT โ†’ Actions โ†’ ImportManual
Poke (Messages/WhatsApp/Telegram)Add as MCP integration โ†’ URL: https://astro-api-a2rc.onrender.com/mcp/sseโ€”
Claude Desktop / Zednpx @smithery/cli install astrology --client claudeRe-run
Manual / devgit clone https://github.com/aryaminus/astro.git && ln -sfn "$(pwd)/astro/skills/astrology" ~/.agents/skills/astrologygit pull

Why this exists

A raw LLM cannot tell you where Mars was on a Tuesday in 1997 โ€” it hallucinates chart data. Astro splits the work:

  1. Engine โ€” deterministic Python math computes real sky positions (zero deps, pure stdlib)
  2. Skill โ€” orchestrates the engine + loads classical interpretation rulesets
  3. Glue โ€” MCP, REST, CLI, ChatGPT Actions reach the engine from any platform

The model never guesses a position. It interprets structured output grounded in 8 classical rulesets.

19 modes ยท 3 traditions ยท zero dependencies

Modes: natal, transit, synastry, compatibility, composite, astrocartography, horary, event, solar/lunar/planetary return, navamsa, varga (D2โ€“D60), panchang, moon phase, numerology, progressions, planetary hours, transit-to-natal aspects. Full list and parameters in skills/astrology/SKILL.md.

Traditions: Western tropical, Vedic/Jyotisha (Lahiri sidereal), Chinese BaZi + Tibetan/Buddhist.

Auto-included in every natal chart: Aspect patterns (Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, Stellium) ยท Part of Fortune ยท Vertex ยท Black Moon Lilith ยท Moon phase ยท 10 Arabic Parts ยท 23 fixed-star conjunctions ยท Navamsa D9 ยท Panchang ยท Mangal Dosha ยท Kaalsarpa Dosha.

Try it

After installing, ask any of these:

  • "What's my chart?" โ†’ full natal
  • "Am I compatible withโ€ฆ?" โ†’ synastry + 0โ€“100 scoring
  • "When's my Saturn return?" โ†’ planetary return + timing
  • "Where should I live for career?" โ†’ astrocartography
  • "What time should I start the meeting?" โ†’ Chaldean planetary hours
  • "Pick an auspicious wedding date" โ†’ electional + panchang
  • "Should I have surgery this month?" โ†’ medical timing
  • "What does today have in store?" โ†’ transits + natal aspects

Project layout

Code
astro/
โ”œโ”€โ”€ skills/astrology/
โ”‚   โ”œโ”€โ”€ SKILL.md                    # runtime spec the model reads
โ”‚   โ”œโ”€โ”€ scripts/astro_engine.py     # deterministic engine (~2930 lines)
โ”‚   โ”œโ”€โ”€ scripts/mcp_server.py       # MCP wrapper (18 tools, stdio + SSE)
โ”‚   โ”œโ”€โ”€ scripts/api.py              # REST API (31 endpoints)
โ”‚   โ””โ”€โ”€ references/                 # 8 classical rulesets
โ”‚       โ”œโ”€โ”€ western.md ยท vedic.md ยท bazi.md ยท tibetan.md
โ”‚       โ”œโ”€โ”€ health.md ยท synastry-and-timing.md
โ”‚       โ”œโ”€โ”€ specialty-systems.md ยท consultation.md
โ”œโ”€โ”€ openapi.yaml                    # OpenAPI 3.1 (ChatGPT, Agentforce, Coze)
โ”œโ”€โ”€ smithery.yaml                   # Smithery registry
โ”œโ”€โ”€ Dockerfile ยท docker-compose.yml ยท render.yaml   # cloud deploy
โ””โ”€โ”€ AGENTS.md ยท CONTRIBUTING.md ยท SECURITY.md ยท CHANGELOG.md

Cloud hosting

Free by default. No auth, no rate limits. Set ASTRO_API_KEY to gate, ASTRO_RATE_LIMIT to throttle.

Render (one-click, free tier): Connect this repo โ†’ New โ†’ Blueprint. render.yaml provisions everything. Verify with curl https://astro-api-a2rc.onrender.com/health. Free tier spins down after 15 min idle; first request after idle takes ~30s.

Docker:

Terminal
docker compose up --build    # API on :8000, docs at /docs

Raw Python:

Terminal
pip install -r requirements.txt
uvicorn skills.astrology.scripts.api:app --host 0.0.0.0 --port 8000

MCP SSE (Smithery, Cloudflare, Poke):

bash
ASTRO_MCP_TRANSPORT=sse python -m skills.astrology.scripts.mcp_server

Cloud MCP SSE (no deploy needed): https://astro-api-a2rc.onrender.com/mcp/sse โ€” free Render instance. ~30s cold start.

Env vars and operational endpoints documented in AGENTS.md.

Documentation

FileWhat it covers
AGENTS.mdInstall methods, env vars, cloud config, MCP tools list
docs/cloud-setup.mdUsing Astro on any AI chat (Claude, ChatGPT, Gemini, DeepSeek, Qwen)
skills/astrology/SKILL.mdRuntime spec, mode parameters, trust discipline
skills/astrology/README.mdEngine internals, API surface, specialty branches
openapi.yamlREST API schema (ChatGPT, Agentforce, Coze)
CHANGELOG.mdRelease history
CONTRIBUTING.mdHard rules, dev workflow, PR checklist
SECURITY.mdVulnerability reporting

Contributing

PRs welcome. Hard rules: engine stays zero-dep, engine never imports frameworks, touch all 4 surfaces (engine + MCP + REST + OpenAPI), the skill is honest. See CONTRIBUTING.md.

License

MIT. Reference texts in skills/astrology/references/ are original MIT-licensed syntheses of classical sources.

Read the full README โ†’View source on GitHub โ†’

Related MCP Servers

View all in Spirituality & Esoterica View all alternatives
  • Bible MCP logoBible MCP

    Bible corpus MCP server: scripture, Greek/Hebrew interlinear data, cross-refs, semantic search.

    ๐Ÿ”ฎ Spirituality & Esoterica0 views
    Compare vs Bible MCP โ†’
  • FateMCP DayMaster logoFateMCP DayMaster

    Day Pillar reading from your birth date โ€” BaZi astrology.

    ๐Ÿ”ฎ Spirituality & Esoterica0 views
    Compare vs FateMCP DayMaster โ†’
  • Vedaksha logoVedaksha

    Vedic astrology and astronomical ephemeris: kundali, panchanga, dashas, vargas, transits

    ๐Ÿ”ฎ Spirituality & Esoterica0 views
    Compare vs Vedaksha โ†’
  • Bazi MCP logoBazi MCP

    Provides comprehensive and accurate Bazi (Chinese Astrology) charting and analysis

    ๐Ÿ”ฎ Spirituality & Esoterica2 views
    Compare vs Bazi MCP โ†’

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks โ€” not a rating.

GitHub stars
8
Stargazers on the source repository.
npm downloads
40M
Package downloads in the last 30 days.
Last commit
3mo ago
Most recent push to the default branch.

Reviews

No reviews yet โ€” be the first to share how this listing worked for you.

Frequently Asked Questions about Astro

astro is a hosted MCP server. Add it as a remote server in your client's config: "mcpServers": { "astro": { "url": "https://astro-api-a2rc.onrender.com/mcp/sse" } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAstro AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/astro?style=directory)](https://allmcps.com/mcp/astro)
HTML Embed
<a href="https://allmcps.com/mcp/astro"><img src="https://allmcps.com/api/badge/astro?style=directory" alt="Astro on AllMCPs" /></a>

Technical Specs & Signals

Category๐Ÿ”ฎSpirituality & Esoterica
More technical detailsExpand โ–พ
TransportSSE (Remote)
Last updatedJun 8, 2026
2/6 checks healthy over the last 46d
Views0
Unique ViewsTotal visits recorded for this listing page on AllMCPs.
Installs0
Installs & Copy ActionsTotal times users copied install commands or configuration snippets for this server.
GitHub stars8
GitHub Star CountTotal stargazers on GitHub representing community popularity (8 stars).
Last commit3mo ago
Last Repository CommitThe most recent commit or push recorded for this server's GitHub repository.Last commit on Jun 8, 2026
npm downloads40,385,813/mo
Monthly npm DownloadsAverage monthly package installs recorded from npm registry statistics.
41Quality signal: Fair ยท 41/100How this signal is calculated โ–พ
Server availabilityNot measured

Not scored for repo-hosted servers โ€” we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20
Documentation & tools15/30
Adoption & activity6/15
Community engagement0/10

A guidance signal from public completeness & health data โ€” not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8/16/2026 via OSV.dev ยท https://astro-api-a2rc.onrender.com/mcp/sse (npm)

โ˜… FeaturedMoxie Docs MCP logo

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server โ†’

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge โ€” proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it โ€” no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in ๐Ÿ”ฎ Spirituality & Esoterica โ†’Alternatives to Astro โ†’Install in Claude DesktopInstall in CursorInstall in VS CodeSetup guides for all 13 MCP clients