astroway/astroway-mcp

Overview

An MCP server that wraps the AstroWay Calculation API for use in Claude Desktop, Cursor, Windsurf, and any MCP client. Auto-generated from a live OpenAPI spec, it provides endpoints for natal charts, synastry, transits, Vedic dashas, Tarot, Human Design, and AI-generated horoscopes. Built in TypeScript.

Best for

Best for
Developers building AI assistants or tools that need integrated astrology, Tarot, or Human Design data via MCP

Use cases

• Generate natal chart data in Claude Desktop via natural language
• Query transits or synastry between two birth charts from Cursor or Windsurf
• Retrieve Vedic dasha periods or Tarot readings programmatically

How to use

Install

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

Tools exposed

• ASTROWAY_API_KEY
• ASTROWAY_BASE_URL

Tested with

Claude Desktop, Cursor, Windsurf, Cline, Continue, VS Code

Example client config

{\n  "mcpServers": {\n    "astroway": {\n      "command": "npx",\n      "args": ["-y", "@astroway/mcp"],\n      "env": {\n        "ASTROWAY_API_KEY": "aw_live_..."\n      }\n    }\n  }\n}

Notes

An MCP server that wraps the AstroWay Calculation API for use in Claude Desktop, Cursor, Windsurf, and any MCP client. Auto-generated from a live OpenAPI spec, it provides endpoints for natal charts, synastry, transits, Vedic dashas, Tarot, Human Design, and AI-generated horoscopes. Built in TypeScript.

1 stars on GitHub. Last updated 2026-06-05. Licensed MIT.

Use cases

• Generate natal chart data in Claude Desktop via natural language
• Query transits or synastry between two birth charts from Cursor or Windsurf
• Retrieve Vedic dasha periods or Tarot readings programmatically

Pros

• Auto-generated from the live API spec, so endpoints stay current
• Covers a wide range of esoteric data (astrology, Tarot, Human Design) in one server
• Works with popular MCP clients out of the box

Cons

• Very early stage (1 star on GitHub); stability and adoption are unproven
• Limited to the AstroWay API — no offline fallback or custom source support
• Dependency on external API means usage costs and potential rate limits

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.