Released
Hosted MCP - zero-install for Claude Web / Desktop / Cursor
Hosted Streamable HTTP endpoint at mcp.astroway.info/mcp - same 700+ tool catalogue as the npm package, no local install. One URL, one Bearer header, and your AI client sees the entire AstroWay ecosystem. Multi-tenant: credits draw from the account that owns your Bearer key.
https://mcp.astroway.info/mcp read SDK guide → MCP server (stdio) for Claude / Cursor / GPT
Official @astroway/mcp: exposes every one of the 700+ AstroWay API endpoints as tools for AI agents. Works with Claude Desktop, Cursor, GPT MCP clients. Stdio mode - your key stays on your machine, no network hops. For zero-install scenarios use the hosted endpoint instead.
npx -y @astroway/mcp read SDK guide → TypeScript SDK for the AstroWay API
Official @astroway/sdk - thin wrapper over openapi-fetch (~6 KB runtime). Path autocomplete + request/response types in your IDE for all 865+ endpoints. Stainless-style error hierarchy, built-in retry on 408/409/429/5xx, OIDC + SLSA L3 provenance.
npm install @astroway/sdk read SDK guide → Python SDK for the AstroWay API
Official astroway on PyPI - Astroway (sync) + AsyncAstroway (async) on top of httpx. Identical surface - the same API on both clients. Stainless-style error hierarchy, retry on 408/409/429/5xx, PEP 561 typed package. Python 3.9+, Trusted Publisher OIDC.
pip install astroway read SDK guide → PHP SDK for the AstroWay API
Official astroway/sdk on Packagist - built on Guzzle 7 + PSR-18. PHP 8.1+ (readonly properties, constructor promotion). Stainless-style error hierarchy, built-in retry middleware on 408/409/429/5xx, two auth schemes (X-Api-Key default or Bearer).
composer require astroway/sdk read SDK guide → React companion for @astroway/sdk
Official @astroway/react on npm - a thin Stripe-style wrapper over @astroway/sdk. AstrowayProvider lifts the client into React context; useAstroway, useAstrowayQuery, useNatalChart hooks return an SWR-style { data, error, loading } triple with zero external deps. Works with React 18+, Next.js App Router (via "use client"), Vite, CRA.
npm install @astroway/react @astroway/sdk react read SDK guide → AstroWay web components (alpha)
Natal wheel, moon phase, compatibility, tarot and horoscope as plain HTML elements for any site: one <script> tag from a CDN, or npm install. Charts are drawn by the same code as the API, so a wheel on your page matches what /v1/render returns. Alpha: attribute names may still change before 1.0.
npm install @astroway/ui@alpha read SDK guide → Symfony Bundle for the AstroWay API
Official astroway/sdk-symfony on Packagist - a Bundle on top of astroway/sdk. Auto-registers via Symfony Flex, configured through the standard config/packages/astroway.yaml, exposes an autowireable Astroway\Astroway service for injection into any controller or service. Compatible with Symfony 6.4 LTS and 7.x, PHP 8.1+.
composer require astroway/sdk-symfony:^0.1.0-alpha read SDK guide → Laravel ServiceProvider for the AstroWay API
Official astroway/sdk-laravel on Packagist - a ServiceProvider + facade on top of astroway/sdk. Auto-discovered via composer.json extra.laravel.providers, Astroway\Astroway registered as a container singleton, config published via php artisan vendor:publish. Inject into controllers or use the facade Astroway::post("/chart", ...). Works with Laravel 10/11/12, PHP 8.1+.
composer require astroway/sdk-laravel:^0.1.0-alpha read SDK guide → Go SDK for the AstroWay API
The official AstroWay Go module: every API endpoint as a method, such as aw.Chart.Compute, with a context on every call. Retries on 408/409/429/5xx honour Retry-After, and a POST keeps one Idempotency-Key, so a retried call is not charged twice. Errors are tested with errors.Is, and the response decodes into your own type. Standard library only, Go 1.22+.
go get github.com/astroway/astroway-go read SDK guide → C# SDK for the AstroWay API
Package Astroway.Sdk: every API endpoint as an async method, such as aw.Chart.ComputeAsync, cancellable with a CancellationToken. Retries on 408/409/429/5xx honour Retry-After, every kind of failure has its own exception, and the response deserializes into your own records. .NET Standard 2.0 and .NET 8: .NET Framework 4.7.2+, .NET 6/8/9, Unity.
dotnet add package Astroway.Sdk read SDK guide → 4 lines to your first request
import { Astroway } from '@astroway/sdk';
const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });
const { data: chart } = await aw.client.POST('/chart', {
body: {
date: '1990-07-14',
time: '14:30:00',
timezoneOffset: 3,
latitude: 50.4501,
longitude: 30.5234,
houseSystem: 'P',
},
});
// aw.client.POST is the raw typed fetch, so `chart` is the { ok, data } envelope
console.log(chart.data.houses.ascendant); // 212.0952574979425Coming soon
Bring your own wrapper
Don't see your language on the list? Every endpoint is described in standardized OpenAPI 3.1 spec - generate your own client through openapi-generator or stainless.