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 {endpoints}+ 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 → 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 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 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',
},
});
console.log(chart.angles.asc);Coming soon
Go SDK — in development
Module `astroway-go` with built-in context.Context support and structs generated from OpenAPI 3.1.
preview →Ruby SDK — in development
Gem `astroway` for Ruby 3.0+ and Rails 7+. Works with Faraday transport.
preview →Rust SDK — in development
Crate `astroway` with full async support via Tokio and type-safe enums generated from OpenAPI 3.1.
preview →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.