One REST API for Western, Vedic, Chinese, Hellenistic, Human Design, Tarot and Numerology calculations, with SDKs for five languages and a hosted MCP server your agent can call today.
api.astroway.info · Docs · Pricing · Get a free key
| API operations | 804, all in one OpenAPI 3.1 spec |
| Hosted MCP tools | 799 at https://mcp.astroway.info/mcp |
| MCP domain servers | 14, one per subject, plus a keyless docs server |
| Official SDKs | 5: TypeScript, Python, PHP, Go, .NET |
| Languages | 20, for documentation and interpretations |
| Free tier | 10,000 credits a month, no card |
claude mcp add --transport http astroway https://mcp.astroway.info/mcp --header "Authorization: Bearer aw_live_YOUR_KEY"On claude.ai, add https://mcp.astroway.info/mcp as a custom connector (Settings, Connectors) and pick "Sign in when needed". To keep the tool list short, connect one subject instead of the whole catalogue: https://mcp.astroway.info/mcp/<domain>, where the domain is one of core, vedic, chinese, hellenistic, tarot, numerology, human-design, forecast, relationships, psychological, divination, applied, reports, platform. Setup for Cursor, Claude Desktop, VS Code, Windsurf and Codex: agent setup.
| Stack | Install | Repository |
|---|---|---|
| TypeScript, Node | npm i @astroway/sdk |
astroway-typescript |
| Python | pip install astroway |
astroway-python |
| PHP | composer require astroway/sdk |
astroway-php, Laravel, Symfony |
| Go | go get github.com/astroway/astroway-go |
astroway-go |
| .NET | dotnet add package Astroway.Sdk |
astroway-dotnet |
| React hooks | npm i @astroway/react |
astroway-react |
| MCP server (stdio) | npx -y @astroway/mcp |
astroway-mcp |
| SVG chart renderers | npm i @astroway/render |
astroway-render |
| Web components | npm i @astroway/ui |
astroway-ui |
| WordPress | wordpress.org/plugins/astroway | astroway-wp-plugin, Elementor widgets |
| n8n | @astroway/n8n-nodes-astroway |
n8n-nodes-astroway |
| Any language | OpenAPI 3.1 snapshot, Postman collection | astrology-api-openapi |
Clone, add a key, run. Each has a Deploy to Render button.
| Starter | Live demo | What it shows |
|---|---|---|
| starter-human-design | demo | A bodygraph reader from one call |
| starter-bazi | demo | Four Pillars and the luck cycle from two calls |
| starter-practice | demo | A report desk: sixteen white-label PDF reports |
Copy-paste recipes for chat bots, LLM tools, edge caching and data export: examples.
astrology-accuracy-benchmark measures any astrology API's planetary longitudes against a reference ephemeris, in arcseconds. It runs against other providers too. Our own method and results: accuracy.
Open an issue in the repository of the package you use. Security reports go to security@astroway.info, see SECURITY.md. How we handle data: trust.