Log inSubmit server
Astro Skill logo

Astro Skill

by adityarya24

Calculates offline Vedic astrology charts, timelines, transits, compatibility scores, panchang data, and bilingual PDF reports.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Astro Skill

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "adityarya24-astro-skill": {
      "command": "uvx",
      "args": [
        "astro-skill"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The adityarya24/astro-skill MCP server exposes a deterministic Vedic astrology engine through 11 stdio tools. It uses bundled Swiss Ephemeris data with Lahiri ayanamsa to produce structured Kundali, dasha, transit, panchang, compatibility, and report outputs without API keys or network calls. Local SQLite storage supports client profiles and report lookup, while ReportLab generates bilingual Hindi and English PDFs. Reach for it when an agent needs calculation-backed Vedic astrology workflows that can run offline.

Use cases

  • Calculate a birth Kundali from date, time, and location
  • Generate Vimshottari dasha timelines
  • Check planetary transits and Sade Sati
  • Score Ashtakoot compatibility between two charts
  • Render bilingual astrology reports as PDFs

Key features

  • 11 stdio MCP tools
  • Swiss Ephemeris with Lahiri ayanamsa
  • Kundali and Navamsa calculations
  • Vimshottari dasha and transit analysis
  • SQLite client profile storage
  • Bilingual ReportLab PDF generation

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

12/12 checks healthy over the last 86d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 21h ago via OSV.dev · astro-skill (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
Last commit1mo agoMost recent push to the default branch.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Astro Skill works

What adityarya24/astro-skill MCP server does

The adityarya24/astro-skill MCP server provides an offline Vedic astrology engine and exposes it to MCP clients over stdio. It accepts birth details, dates, places, coordinates, and chart data, then returns structured calculations or generated reports. The engine uses bundled Swiss Ephemeris SWIEPH data through pyswisseph and Lahiri, also called Chitrapaksha, ayanamsa.

Its astrology output covers birth charts, Navamsa, planetary strengths, yogas, house analysis, Vimshottari dasha periods, daily panchang, planetary transits, Sade Sati, and Ashtakoot compatibility scoring. It also includes bilingual Hindi and English report generation through ReportLab. Calculations do not require an external API key, rate-limited service, or network connection.

How it works

The MCP entry point runs as astro-mcp, or through python -m services.astro_mcp, and communicates with clients using stdio. Requests pass through the MCP layer to the shared astrology core, which returns structured JSON or creates a PDF report. The same core is also available through Python modules and command-line scripts, so an MCP workflow can share calculations with local automation.

The server includes SQLite-based client profile management. Agents can save birth parameters, search profiles by identifier or name substring, and retrieve reports associated with a client. This makes it suitable for repeated work with locally stored client records, while keeping the calculation and storage surfaces on the local machine.

Setup and configuration

Install the package with Python 3.11 or newer:

Terminal
pip install astro-skill

Start the stdio server with:

bash
astro-mcp

A Python module invocation is also supported:

bash
python -m services.astro_mcp

Claude Desktop can launch it with the astro-mcp command. Cursor can invoke python -m services.astro_mcp and set the repository path as its working directory. The provided setup does not require environment variables or API credentials.

Tools and capabilities

The 11 MCP tools are:

  • parse_birth_details converts conversational birth information into structured date, time, and coordinate fields.
  • save_client_profile, find_client_profile, and list_client_reports manage local SQLite profiles and report records.
  • calculate_kundali produces a Lahiri whole-sign chart with D1, D9, yogas, and bhava information.
  • calculate_dasha calculates Vimshottari Mahadasha and Antardasha periods with birth-balance handling.
  • calculate_gochar calculates transits and Sade Sati status for a selected date.
  • calculate_compatibility returns a 36-point Ashtakoot Guna Milan result for two charts.
  • calculate_panchang returns sunrise-based Tithi, Vara, Nakshatra, Yoga, and Karana data.
  • generate_report_json combines astrology results into a structured draft.
  • generate_pdf_report renders a bilingual printable report using in-process ReportLab.

Limitations and notes

The adityarya24/astro-skill MCP server is described as a calculation and reporting engine, not as a general-purpose conversational astrology interpretation service. Its open-core repository provides mathematical calculations, JSON schemas, and factual PDFs; a separately described Pro Report Tier adds narrative synthesis, premium layouts, and prioritized remedies.

The server is specifically documented for stdio MCP use. The README names Claude Desktop, Cursor, and Codex among compatible MCP clients, but does not document an HTTP transport. Offline operation applies to the astrological calculations and does not imply that every surrounding client is offline.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Astro Skill

adityarya24/astro-skill is an MCP server that connects AI clients to an offline Vedic astrology engine. Its main tools calculate Kundali charts, Vimshottari dasha, transits and Sade Sati, panchang, Ashtakoot compatibility, structured reports, and bilingual PDFs, with local SQLite profile management and no API key required.

Install it with `pip install astro-skill` using Python 3.11 or newer. Start the server with `astro-mcp`, or run `python -m services.astro_mcp`. The README also provides launch configurations for Claude Desktop and Cursor.

Yes, adityarya24/astro-skill works with Cursor through its stdio MCP configuration. Cursor can run `python -m services.astro_mcp` and use the repository directory as the working directory, as shown in the provided configuration.

No, the astrological calculations do not require an API key or network access. The engine uses bundled Swiss Ephemeris data and performs calculations locally, with SQLite client storage and in-process ReportLab PDF generation.

Related MCP servers

All in Spirituality & Esoterica All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

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 Skill AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/adityarya24-astro-skill?style=directory)](https://allmcps.com/mcp/adityarya24-astro-skill)
HTML Embed
<a href="https://allmcps.com/mcp/adityarya24-astro-skill"><img src="https://allmcps.com/api/badge/adityarya24-astro-skill?style=directory" alt="Astro Skill on AllMCPs" /></a>