# AstroWay Core astrology (remote · mcp.astroway.info)

Natal charts, planets, houses, aspects, dignities, rendering and the calendar.

- Trust score: 77/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-11

## Components

- remote · `mcp.astroway.info`: 77/100 (this document), [markdown](https://verifymcp.io/servers/info-astroway-core/mcp-core.md), [page](https://verifymcp.io/servers/info-astroway-core/mcp-core)

## Channel facts

- Endpoint: `https://mcp.astroway.info/mcp/core`
- Transports: `streamable-http`
- Auth: `required`
- Version: `0.4.3`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-11.

- **Endpoint Security**: 89/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, but the challenge carries no valid RFC 9728 metadata, so a client cannot discover where to get a token.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 69/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 27675 tokens (~232/item across 119 items; 105 tools + 14 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 17/100
  - Stability observed for 5 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 86/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 51% of tool parameters carry a description.
  - Structured output schemas are declared (96% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 105 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 107 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the AstroWay Core astrology MCP server?

AstroWay Core astrology is a hosted endpoint at https://mcp.astroway.info/mcp/core, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http info-astroway-core 'https://mcp.astroway.info/mcp/core'
```

### Cursor

```json
{
  "mcpServers": {
    "info-astroway-core": {
      "url": "https://mcp.astroway.info/mcp/core"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "info-astroway-core": {
      "type": "http",
      "url": "https://mcp.astroway.info/mcp/core"
    }
  }
}
```

### Codex

```toml
[mcp_servers.info-astroway-core]
url = "https://mcp.astroway.info/mcp/core"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "info-astroway-core": {
      "type": "remote",
      "url": "https://mcp.astroway.info/mcp/core",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add info-astroway-core --url 'https://mcp.astroway.info/mcp/core' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  info-astroway-core:
    url: "https://mcp.astroway.info/mcp/core"
```

### Netclaw

```json
{
  "McpServers": {
    "info-astroway-core": {
      "Transport": "http",
      "Url": "https://mcp.astroway.info/mcp/core"
    }
  }
}
```

### Vellum

```bash
assistant mcp add info-astroway-core -t streamable-http -u 'https://mcp.astroway.info/mcp/core'
```

### Other

```json
{
  "mcpServers": {
    "info-astroway-core": {
      "type": "http",
      "url": "https://mcp.astroway.info/mcp/core"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-11 (score 77, +52)

- [security regression] Authorization: unverified → fail
- [security improvement] Transport: unverified → pass
- [security improvement] Injection markers: unverified → pass
- [security] First check of Judged manipulation: pass
- [functional improvement] Stability: unverified → 0.17
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → 100
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Tool coverage: 96
- [functional] First check of Schema quality: fail
- [functional] First check of Destructive annotations: pass
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 51
- [functional] First check of Schema quality: good

### 2026-10-09 (score 25)

First indexed and scored.

## MCP tools (105)

### `astroway_account_status` (~73 tokens)

Account Status

Check current API key status: tier, credit balance, rate limits, monthly cycle reset. Run this BEFORE invoking expensive endpoints (Tier 4+ at 100+ credits, Tier 6/7 at 500-5000 credits) to confirm the user has budget. Returns plain-text human-readable summary.

### `astroway_cost_estimate` (~91 tokens)

Cost Estimate

Estimate the credit cost of one or more endpoints WITHOUT invoking them. Returns total + per-endpoint breakdown with tier annotations. Useful when planning multi-step workflows: estimate first, ask user confirmation, then invoke. Cache TTL 5 min.

Input parameters:

- `endpoints` (array, required): Endpoint paths to estimate, e.g. ["/chart", "/synastry", "/reports/natal"]. Leading slash optional.

### `astroway_geo_acg` (~437 tokens)

Astrocartography (A*C*G)

Calculate A*C*G lines for all planets: the geodetic map lines where each planet was on an angle at birth.

[Group: Astro-Geography]
[Endpoint: POST /v1/acg]
[Required: date, time, latitude, longitude]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `city` (string)
- `cosmogram` (boolean)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `houseSystem` (string)
- `latitude` (number, required)
- `longitude` (number, required)
- `name` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `zodiacType` (string)

Output parameters:

- `lines`

### `astroway_geo_acg_best_places` (~289 tokens)

Best places for a life category

Rank cities against the astrocartography lines of a chart for one of the 19 life categories. Distance to a line is computed from the body hour angle and altitude rather than against a discretised polyline, so it is exact: the distance to a horizon line IS the altitude in degrees of arc, and a meridian line offset is the hour angle times cos(latitude). Supportive and challenging totals are returned separately with every contributing line and its distance, so a strong-but-turbulent city is distinguishable from an average one. Bundled GeoNames set of 34,028 places above 15,000 people.

[Group: Astro-Geography]
[Endpoint: POST /v1/acg/best-places]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `body` (required): Birth data plus a life category. Birth coordinates are optional and unused for the ranking: astrocartography lines are a property of the birth moment, not of the birth place.
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `attribution`
- `category`
- `count`
- `dataset`
- `maxPossibleSupportive`
- `minSeparationKm`
- `orbKm`
- `places`
- `pool`
- `sort`
- `suppressedAsTooClose`
- `type`

### `astroway_geo_acg_by_category` (~330 tokens)

A*C*G by Life Category

A*C*G lines that govern one area of life, ranked by astrological weight and, when a point is supplied, by proximity to it. Returns curated interpretation text per line in 11 languages.

[Group: Astro-Geography]
[Endpoint: POST /v1/acg/by-category]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `body` (required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `category`
- `count`
- `language`
- `lines`
- `point`
- `polarity`
- `radiusDeg`
- `requestedLanguage`

### `astroway_geo_acg_categories` (~162 tokens)

A*C*G Life Categories

Reference taxonomy: 19 areas of life, each naming the planet-and-angle lines that govern it with a weight and a polarity. Free, cacheable, drives the two endpoints below.

[Group: Astro-Geography]
[Endpoint: GET /v1/acg/categories]
[Cost: see your plan — endpoint not in the public credit manifest]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `categories`
- `count`
- `language`
- `requestedLanguage`

### `astroway_geo_acg_countries` (~158 tokens)

Countries available for ranking

Which countries the bundled city list can rank, and how many qualifying cities each has. Asking for a country with two cities and getting two results should not look like a bug.

[Group: Astro-Geography]
[Endpoint: GET /v1/acg/countries]
[Cost: 5 credits (Tier ½)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `attribution`
- `count`
- `countries`
- `dataset`
- `totalCities`

### `astroway_geo_acg_line_report` (~336 tokens)

A*C*G Line Report

One line in full: its geometry, every life area it touches with weight and polarity, and the interpretation text for that planet-and-angle pair. Rising and setting curves arrive as several disjoint segments; all of them are returned.

[Group: Astro-Geography]
[Endpoint: POST /v1/acg/line-report]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `body` (required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `categories`
- `interpretation`
- `language`
- `line`
- `requestedLanguage`

### `astroway_geo_acg_zones` (~319 tokens)

A*C*G Lines Near a Point

A*C*G lines passing within radiusDeg of one location, with the angular distance to each. The "what runs over this city" lookup.

[Group: Astro-Geography]
[Endpoint: POST /v1/acg-zones]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `body` (required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `nearbyLines`
- `point`
- `radiusDeg`

### `astroway_agent_tools` (~405 tokens)

Agent tool definitions

Tool definitions for an agent framework, generated from the live OpenAPI document, so the schema a model fills is the schema the endpoint validates. `format=openai` (default) returns `{ type, function }` objects you can spread straight into a chat completion; `format=anthropic` returns `{ name, description, input_schema }`. The objects carry nothing of ours: how to call each tool lives in a separate `executors` map keyed by tool name, because an unexpected key inside a vendor tool object is a 400 at their end.

[Group: Agent Platform]
[Endpoint: GET /v1/agent/tools]
[Cost: see your plan — endpoint not in the public credit manifest]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `format` (string): Which vendor contract the tool objects follow. `openai` returns `{ type, function }`, `anthropic` returns `{ name, description, input_schema }`.
- `limit` (integer): How many tools to return. The ceiling is the OpenAI limit of 128 functions per request; models degrade well before it. Anything left out is counted in `totalMatched`.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `q` (string): Free-text filter applied within the selection, matched against path, summary, description and group.
- `select` (string): What to hand over: `starter` (the curated set, the default), `all`, `group:<tag>` such as `group:Vedic`, or `paths:/chart,/synastry` for an explicit list. An unknown path is named in `notes` rather t…

Output parameters:

- `count`
- `executors`
- `format`
- `notes`
- `select`
- `tools`
- `totalAvailable`
- `totalMatched`
- `truncated`

### `astroway_mcp_ai_chat` (~387 tokens)

Chart-grounded AI chat

Chat answered from the positions we computed for this birth moment, not from the model's memory of a sun sign. Carries up to 10 turns of history, replies in 21 languages, and takes four voices through `persona`. Send your own provider key and the turn costs 5 credits instead of the endpoint price.

[Group: AI & MCP]
[Endpoint: POST /v1/ai/chat]
[Required: message]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `chart` (object): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `history` (array)
- `language` (string)
- `message` (string, required)
- `persona` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `disclaimer`
- `duration_ms`
- `language`
- `model`
- `persona`
- `reply`
- `tokens`

### `astroway_mcp_ai_comparison_coach` (~497 tokens)

Comparison Coach

Coach two charts on relationship dynamics.

[Group: AI & MCP]
[Endpoint: POST /v1/ai/comparison-coach]
[Required: chart1, chart2, question]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `chart1` (object, required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `chart2` (object, required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `question` (string, required)

Output parameters:

- `coaching`

### `astroway_mcp_ai_explain_aspect` (~347 tokens)

Explain Aspect

Detailed explanation of an aspect between two planets.

[Group: AI & MCP]
[Endpoint: POST /v1/ai/explain-aspect]
[Required: planet1, planet2, aspectType]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `aspectType` (string, required)
- `chart` (object): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `planet1` (string, required)
- `planet2` (string, required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `explanation`

### `astroway_mcp_ai_explain_transit` (~360 tokens)

Explain Transit

Explain a current transit hitting your natal chart.

[Group: AI & MCP]
[Endpoint: POST /v1/ai/explain-transit]
[Required: chart, transitDate, transitPlanet, natalPlanet, aspectType]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `aspectType` (string, required)
- `chart` (object, required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `natalPlanet` (string, required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `transitDate` (string, required)
- `transitPlanet` (string, required)

Output parameters:

- `explanation`

### `astroway_calendar_algol_minimum` (~180 tokens)

Algol Minimum

Find the nearest minimum brightness moment of Algol (Beta Persei), the eclipsing variable star, within a date range.

[Group: Calendar & Cycles]
[Endpoint: POST /v1/algol-minimum]
[Required: startDate, endDate]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `endDate` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `longitude`
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `startDate` (string, required)

Output parameters:

- `count`
- `minima`

### `astroway_calendar_algol_minimum_nearest` (~161 tokens)

Algol Nearest Minimum

Find the single nearest Algol brightness minimum before or after a given date.

[Group: Calendar & Cycles]
[Endpoint: POST /v1/algol-minimum/nearest]
[Required: date]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `longitude`
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `date`
- `hoursUntil`
- `jd`
- `time`

### `astroway_dignities_almuten` (~162 tokens)

Almuten Figuris

Calculate the Almuten Figuris: the planet with the highest essential dignity score across the key chart positions.

[Group: Dignities & Receptions]
[Endpoint: POST /v1/almuten]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `body` (required): Natal chart plus optional custom terms and decans tables.
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `almuten`
- `chart`

### `astroway_aspects_antiscia` (~442 tokens)

Antiscia

Calculate antiscia (mirror points along the Cancer/Capricorn axis) and contra-antiscia, plus their aspects to natal planets.

[Group: Aspects & Points]
[Endpoint: POST /v1/antiscia]
[Required: date, time, latitude, longitude]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `city` (string)
- `cosmogram` (boolean)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `houseSystem` (string)
- `latitude` (number, required)
- `longitude` (number, required)
- `name` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `zodiacType` (string)

Output parameters:

- `antiscia`
- `aspects`

### `astroway_aspects_arabic_parts` (~176 tokens)

Arabic Parts (Lots)

Calculate Arabic parts (Lots) from a natal chart. Returns positions for standard lots (Fortune, Spirit, etc.) and any custom formula.

[Group: Aspects & Points]
[Endpoint: POST /v1/arabic-parts]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `body` (required): Natal chart plus optional custom lot definitions; the built-in set is used when omitted.
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `parts`

### `astroway_aspects_aspect_bar` (~234 tokens)

Aspect Bars (Gantt)

Transform aspect timelines into Gantt-style bars grouped by transit planet. Each bar shows the duration an aspect is in orb, with exact dates marked. Useful for visual transit calendars.

[Group: Aspects & Points]
[Endpoint: POST /v1/aspect-bar]
[Required: startDate, endDate]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `aspectAngles` (array)
- `endDate` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `maxOrb` (number)
- `planet1Ids` (array)
- `planet2Ids` (array)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `startDate` (string, required)
- `stepDays` (number)
- `visiblePlanetIds` (array)

Output parameters:

- `bars`
- `rows`

### `astroway_aspects_aspect_timeline` (~217 tokens)

Aspect Timeline

Calculate a timeline of when two specific planets form an exact aspect within a date range, including enter/exact/leave dates.

[Group: Aspects & Points]
[Endpoint: POST /v1/aspect-timeline]
[Required: startDate, endDate]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `aspectAngles` (array)
- `endDate` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `maxOrb` (number)
- `planet1Ids` (array)
- `planet2Ids` (array)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `startDate` (string, required)
- `stepDays` (number)

Output parameters:

- `count`
- `timelines`

### `astroway_calendar_aspects` (~463 tokens)

Aspect Matrix

Standalone aspect calculation: full inter-planetary aspect list with type / exactAngle / orb / isApplying. Uses per-pair astro.com orb matrix. Same calcAspects() as /chart but without planet positions / houses / midpoints overhead.

[Group: Calendar & Cycles]
[Endpoint: POST /v1/aspects]
[Required: date, time, latitude, longitude]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `city` (string)
- `cosmogram` (boolean)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `houseSystem` (string)
- `latitude` (number, required)
- `longitude` (number, required)
- `name` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `zodiacType` (string)

Output parameters:

- `aspects`
- `count`

### `astroway_geo_ccg_analysis` (~180 tokens)

CCG Analysis

Analyse Cyclo-Carto-Graphy (CCG) lines: progressed A*C*G lines at a target date with mundane/local aspects and latitude crossings.

[Group: Astro-Geography]
[Endpoint: POST /v1/ccg-analysis]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `body` (required): Wrapper { natal: ChartInput } used by endpoints that take a base natal plus extra parameters in flat fields.
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `mcShift`
- `meta`
- `mundaneAspects`

### `astroway_western_chart` (~511 tokens)

Natal Chart

Calculate a full natal chart: planets, house cusps, aspects, sect, and angular data for a given birth moment. When the birth time is unknown, send timeUnknown: true instead of time and the response carries planets and aspects with houses, angles and sect set to null, plus a timeUnknown block giving the range the Moon covers that day. With ?lang= the response adds localized: planet, sign and aspect names in that language, keyed by the English names.

[Group: Core]
[Endpoint: POST /v1/chart]
[Required: date, latitude, longitude]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `city` (string)
- `cosmogram` (boolean)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `houseSystem` (string)
- `latitude` (number, required)
- `longitude` (number, required)
- `name` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timeUnknown` (boolean)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `zodiacType` (string)

Output parameters:

- `antiscia`
- `antisciaAspects`
- `aspects`
- `chartSect`
- `houseAspects`
- `houses`
- `input`
- `julianDay`
- `localized`
- `meta`
- `parallelAspects`
- `planets`
- `siderealTime`

### `astroway_calendar_cyclic_index` (~175 tokens)

Cyclic Index

Calculate the André Barbault Cyclic Index, sum of all outer planet separations, for a date range to indicate global crisis periods.

[Group: Calendar & Cycles]
[Endpoint: POST /v1/cyclic-index]
[Required: startYear, endYear]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `endYear` (required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `pairs`
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `startYear` (required)

Output parameters:

- `count`
- `data`
- `endYear`
- `startYear`

### `astroway_dignities_disposition_chains` (~175 tokens)

Disposition Chains

Calculate planetary disposition chains: the recursive sequence of sign rulers leading to the final dispositor.

[Group: Dignities & Receptions]
[Endpoint: POST /v1/disposition-chains]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `body` (required): Natal chart plus the dispositor mode (rulership or detriment) and the ruler set (classical or modern).
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `data`
- `mode`
- `rulerMode`

### `astroway_dignities_disposition_chains_layout` (~172 tokens)

Disposition Chains Layout

Return disposition chains with computed x/y layout coordinates for graph visualization.

[Group: Dignities & Receptions]
[Endpoint: POST /v1/disposition-chains/layout]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `body` (required): Natal chart plus the dispositor mode (rulership or detriment) and the ruler set (classical or modern).
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `bounds`
- `data`
- `layout`
- `mode`
- `rulerMode`

### `astroway_geo_eclipse_analysis` (~173 tokens)

Eclipse Analysis

Analyse the impact of upcoming eclipses on a natal chart: aspects to natal planets, house activations, and Saros series context.

[Group: Astro-Geography]
[Endpoint: POST /v1/eclipse-analysis]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `body` (required): Wrapper { natal: ChartInput } used by endpoints that take a base natal plus extra parameters in flat fields.
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `eclipses`

### `astroway_calendar_eclipses` (~165 tokens)

Eclipses

Find solar and lunar eclipses within a given year or multi-year range. Returns type, date, and geographic visibility data.

[Group: Calendar & Cycles]
[Endpoint: POST /v1/eclipses]
[Required: year]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `year` (required)
- `yearsRange` (number)

Output parameters:

- `eclipses`

### `astroway_western_ephemeris` (~202 tokens)

Ephemeris Range

Return planet positions for a date range with configurable step (min 0.01 days). Max range: 1 year for sub-day steps, 5 years otherwise. Optionally filter by planetIds.

[Group: Core]
[Endpoint: POST /v1/ephemeris]
[Required: startDate, endDate]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `endDate` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `planetIds` (array)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `startDate` (string, required)
- `stepDays`

Output parameters:

- `ephemeris`

### `astroway_dignities_essential_dignities` (~178 tokens)

Essential Dignities

Calculate the five Ptolemaic essential dignities (rulership, exaltation, triplicity, term, face) and debilities for each planet.

[Group: Dignities & Receptions]
[Endpoint: POST /v1/essential-dignities]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `body` (required): Natal chart plus optional custom terms and decans tables.
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `dignities`
- `totalScore`

### `astroway_aspects_fixed_stars` (~436 tokens)

Fixed Stars

Calculate conjunctions between natal planets and fixed stars within a specified orb. Returns star details and aspect type.

[Group: Aspects & Points]
[Endpoint: POST /v1/fixed-stars]
[Required: date, time, latitude, longitude]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `city` (string)
- `cosmogram` (boolean)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `houseSystem` (string)
- `latitude` (number, required)
- `longitude` (number, required)
- `name` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `zodiacType` (string)

Output parameters:

- `stars`

### `astroway_aspects_fixed_stars_catalog` (~183 tokens)

Fixed star catalogue

The star names this API accepts, from Swiss Ephemeris `fixstars.cat`: traditional name, Bayer nomenclature, constellation and magnitude, with the 36-star astrological default set flagged. Optional `?maxMagnitude=` trims to the bright end. Static lookup, no chart needed.

[Group: Aspects & Points]
[Endpoint: GET /v1/fixed-stars/catalog]
[Cost: 5 credits (Tier ½)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `count`
- `defaultSetSize`
- `maxMagnitude`
- `source`
- `stars`
- `total`

### `astroway_aspects_gauquelin_sectors` (~446 tokens)

Gauquelin Sectors

Calculate Gauquelin sector positions (1–36) for all planets, indicating whether each planet is in a power zone.

[Group: Aspects & Points]
[Endpoint: POST /v1/gauquelin-sectors]
[Required: date, time, latitude, longitude]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `city` (string)
- `cosmogram` (boolean)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `houseSystem` (string)
- `latitude` (number, required)
- `longitude` (number, required)
- `name` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `zodiacType` (string)

Output parameters:

- `sectors`

### `astroway_geo_geodetic` (~193 tokens)

Geodetic Equivalents

Convert geographic coordinates to geodetic chart degrees (Sepharial method): each longitude maps to a zodiac degree on the Earth's surface.

[Group: Astro-Geography]
[Endpoint: POST /v1/geodetic]
[Required: latitude, longitude]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `latitude` (number, required)
- `longitude` (number, required)
- `method` (string)
- `obliquity` (number)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `year` (integer)

Output parameters:

- `geodeticAscendant`
- `geodeticMC`
- `zodiacalLongitude`

### `astroway_horoscope_compatibility` (~191 tokens)

Compatibility Horoscope

Generate a relationship horoscope based on synastry between two charts: strengths, friction points, and themes for the next 30 days.

[Group: Horoscope]
[Endpoint: POST /v1/horoscope/compatibility]
[Required: sign1, sign2]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `disclaimer_inline` (boolean)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `sign1` (string, required)
- `sign2` (string, required)

Output parameters:

- `challenges`
- `language`
- `score`
- `strengths`
- `summary`

### `astroway_horoscope_daily` (~245 tokens)

Daily Horoscope

Daily horoscope for a zodiac sign in 21 languages, written by a model from that sign's solar houses and the day's transits. Returns `sections` (overview, love, career, health, finance, advice) and the same text as `horoscope`, plus computed `transits` with solar houses, `aspects`, `events`, `energy` (1-10 with its factors), `lucky` and `compatibleSigns`.

[Group: Horoscope]
[Endpoint: POST /v1/horoscope/daily]
[Required: sign]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `date` (string)
- `disclaimer_inline` (boolean)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `sign` (string, required)

Output parameters:

- `disclaimer`
- `horoscope`
- `language`
- `model`

### `astroway_horoscope_monthly` (~190 tokens)

Monthly Horoscope

Monthly horoscope for a zodiac sign: the same shape as the daily one, over 30 days from `date`, with the month's ingresses, stations and lunar phases.

[Group: Horoscope]
[Endpoint: POST /v1/horoscope/monthly]
[Required: sign]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `date` (string)
- `disclaimer_inline` (boolean)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `sign` (string, required)

Output parameters:

- `disclaimer`
- `horoscope`
- `language`
- `model`

### `astroway_horoscope_weekly` (~190 tokens)

Weekly Horoscope

Weekly horoscope for a zodiac sign: the same shape as the daily one, with the week's ingresses, stations and lunar phases in `events` and in the text.

[Group: Horoscope]
[Endpoint: POST /v1/horoscope/weekly]
[Required: sign]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `date` (string)
- `disclaimer_inline` (boolean)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `sign` (string, required)

Output parameters:

- `body`
- `keyTransits`
- `language`
- `title`
- `weekEnd`
- `weekStart`

### `astroway_horoscope_yearly` (~189 tokens)

Yearly Horoscope

Generate a year-ahead horoscope (12-month window) with major transit cycles, solar return chart context, and time-lord (profection) for the year.

[Group: Horoscope]
[Endpoint: POST /v1/horoscope/yearly]
[Required: sign]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `date` (string)
- `disclaimer_inline` (boolean)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `sign` (string, required)

Output parameters:

- `body`
- `language`
- `profectionLord`
- `solarReturn`
- `title`
- `year`

### `astroway_calendar_houses` (~488 tokens)

House Cusps

Standalone house calculation: 12 cusps + ascendant + MC + ARMC + vertex + co-asc + polar-asc. Supports Placidus, Koch, Regiomontanus, Campanus, Topocentric, Whole Sign, Equal, Porphyry, Morinus etc. Auto-fallback warning on |lat|>66.5° quadrant systems.

[Group: Calendar & Cycles]
[Endpoint: POST /v1/houses]
[Required: date, time, latitude, longitude]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `city` (string)
- `cosmogram` (boolean)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `houseSystem` (string)
- `latitude` (number, required)
- `longitude` (number, required)
- `name` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `zodiacType` (string)

Output parameters:

- `houses`

### `astroway_dignities_hyleg` (~173 tokens)

Hyleg & Alcocoden

Calculate the Hyleg (apheta, giver of life) and Alcocoden (indicator of lifespan) using traditional Hellenistic method.

[Group: Dignities & Receptions]
[Endpoint: POST /v1/hyleg]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `body` (required): Natal chart plus the hyleg method and optional custom dignity tables.
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `alcocoden`
- `hyleg`

### `astroway_calendar_ingresses` (~175 tokens)

Planet Ingresses

Find all sign ingresses for a planet within a date range (including retrograde re-entries).

[Group: Calendar & Cycles]
[Endpoint: POST /v1/ingresses]
[Required: planetId, startDate, endDate]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `endDate` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `planetId` (required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `startDate` (string, required)

Output parameters:

- `ingresses`

### `astroway_geo_local_space` (~433 tokens)

Local Space Chart

Calculate local space chart: azimuth and altitude of each planet from a given geographic location at the birth moment.

[Group: Astro-Geography]
[Endpoint: POST /v1/local-space]
[Required: date, time, latitude, longitude]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `city` (string)
- `cosmogram` (boolean)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `houseSystem` (string)
- `latitude` (number, required)
- `longitude` (number, required)
- `name` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `zodiacType` (string)

Output parameters:

- `birthplace`
- `count`
- `lines`

### `astroway_geo_local_space_influence_zone` (~191 tokens)

Local Space Influence Zone

Calculate the local space influence zone lines for a chart relocated to a specific city: lines on the map showing planet directions from that location.

[Group: Astro-Geography]
[Endpoint: POST /v1/local-space/influence-zone]
[Required: latitude, longitude, azimuth]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `azimuth` (required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `halfAngle`
- `latitude` (required)
- `longitude` (required)
- `maxDistDeg`
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `count`
- `polygon`

### `astroway_calendar_lunar_calendar` (~169 tokens)

Lunar Calendar

Calculate a lunar calendar for a given month: Moon sign per day, lunar phases, void-of-course windows, and perigee/apogee.

[Group: Calendar & Cycles]
[Endpoint: POST /v1/lunar-calendar]
[Required: year, month]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `month` (required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `year` (required)

Output parameters:

- `dailyInfo`
- `ingresses`
- `month`
- `moonAspects`
- `phases`
- `voidPeriods`
- `year`

### `astroway_mcp_agent_debate` (~351 tokens)

MCP Agent Debate

2 personas debate a topic, multi-round transcript.

[Group: MCP Advanced]
[Endpoint: POST /v1/mcp/agent-debate]
[Required: topic, agentA, agentB]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `agentA` (string, required)
- `agentB` (string, required)
- `chart` (object): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `rounds` (integer)
- `topic` (string, required)

Output parameters:

- `transcript`

### `astroway_mcp_agent_pool_status` (~131 tokens)

MCP Agent Pool Status

8 personas with specialties.

[Group: MCP Advanced]
[Endpoint: GET /v1/mcp/agent-pool-status]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `count`
- `note`
- `personas`

### `astroway_mcp_multi_agent_coordinate` (~330 tokens)

MCP Multi-Agent Coordinate

Run N personas in parallel + LLM synthesis.

[Group: MCP Advanced]
[Endpoint: POST /v1/mcp/multi-agent-coordinate]
[Required: question, agents]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `agents` (array, required)
- `chart` (object): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `question` (string, required)

Output parameters:

- `individual`
- `synthesis`

### `astroway_mcp_multi_chart_context` (~154 tokens)

MCP Multi-Chart Context

Compact context for MCP agents working across multiple charts.

[Group: AI & MCP]
[Endpoint: POST /v1/mcp/multi-chart-context]
[Required: charts]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `charts` (array, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `intent` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `chartCount`
- `contextHash`
- `intent`
- `notes`
- `summaries`
- `summaryString`

### `astroway_mcp_rag_search` (~320 tokens)

MCP RAG Search

Keyword-tag scoring over chart chunks.

[Group: MCP Advanced]
[Endpoint: POST /v1/mcp/rag-search]
[Required: query, chart]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `chart` (object, required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `query` (string, required)
- `topK` (integer)

Output parameters:

- `matches`
- `query`
- `results`
- `tokens`
- `total`

### `astroway_mcp_streaming` (~322 tokens)

MCP Streaming Chat

Server-Sent Events streaming chat completion with optional chart context.

[Group: AI & MCP]
[Endpoint: POST /v1/mcp/streaming]
[Required: message]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `chart` (object): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `message` (string, required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

### `astroway_mcp_tool_call_stream` (~157 tokens)

MCP Tool-Call Stream

SSE-stream of a tool call envelope.

[Group: MCP Advanced]
[Endpoint: POST /v1/mcp/tool-call-stream]
[Required: tool]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `args` (object)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `tool` (string, required)

### `astroway_mcp_tools_list` (~144 tokens)

MCP Tools List

Auto-generated tool manifest for MCP clients (modelcontextprotocol/2025-03 spec).

[Group: AI & MCP]
[Endpoint: GET /v1/mcp/tools-list]
[Cost: see your plan — endpoint not in the public credit manifest]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `notes`
- `server`
- `spec`
- `toolCount`
- `tools`

### `astroway_aspects_midpoint_trees` (~168 tokens)

Midpoint Trees (Uranian)

Calculate Uranian midpoint trees and planetary pictures (symmetries) for each focal planet within a given orb.

[Group: Aspects & Points]
[Endpoint: POST /v1/midpoint-trees]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `body` (required): Natal chart plus the orb in degrees used for midpoint trees and symmetries.
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `symmetries`
- `trees`

### `astroway_aspects_midpoints` (~433 tokens)

Midpoints

Calculate all planetary midpoints and their zodiac positions. Optionally include midpoint aspects to natal points.

[Group: Aspects & Points]
[Endpoint: POST /v1/midpoints]
[Required: date, time, latitude, longitude]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `city` (string)
- `cosmogram` (boolean)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `houseSystem` (string)
- `latitude` (number, required)
- `longitude` (number, required)
- `name` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `zodiacType` (string)

Output parameters:

- `midpoints`

### `astroway_calendar_moon_aspects` (~170 tokens)

Moon Aspects

Calculate all aspects the Moon makes within a date range (applying and separating), useful for electional and horary work.

[Group: Calendar & Cycles]
[Endpoint: POST /v1/moon-aspects]
[Required: year, month]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `month` (integer, required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `year` (integer, required)

Output parameters:

- `events`

### `astroway_calendar_moon_phase` (~457 tokens)

Moon Phase

Current moon phase at a given moment: illumination %, age in days, elongation, waxing/waning, sun + moon zodiac signs. Geocentric Sun-Moon elongation per Meeus Ch.48.

[Group: Calendar & Cycles]
[Endpoint: POST /v1/moon-phase]
[Required: date, time, latitude, longitude]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `city` (string)
- `cosmogram` (boolean)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `houseSystem` (string)
- `latitude` (number, required)
- `longitude` (number, required)
- `name` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `zodiacType` (string)

Output parameters:

- `ageDays`
- `elongationDeg`
- `illuminationPercent`
- `majorPhase`
- `moonLongitude`
- `moonSign`
- `phase`
- `phaseName`
- `sunLongitude`
- `sunSign`
- `waxing`

### `astroway_calendar_moon_voc` (~354 tokens)

Moon Void-of-Course

Find Moon void-of-course periods within a date range. The Moon is VOC from its last aspect until it enters the next sign.

[Group: Calendar & Cycles]
[Endpoint: POST /v1/moon-voc]
[Required: date, time]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `rangeDays` (number)
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.

Output parameters:

- `periods`

### `astroway_reference_natal_texts` (~493 tokens)

Natal texts (static)

Edited interpretation texts for a chart, no AI at request time. `keys` is a comma list of up to 64: `sun.aries` (planet in sign, also `chiron`, `ascendant`), `moon.h4` (planet in house), `sun_moon.trine` (major aspect between two of Sun..Pluto). `lang` is required; a text that does not exist in that language is listed in `missing`, never replaced by another language. Planet in sign covers 20 languages; houses and aspects are being written. Plain text, paragraphs separated by a blank line.

[Group: Reference]
[Endpoint: GET /v1/natal-texts]
[Required: keys, lang]
[Cost: 10 credits (Tier 1)]

Keys with no text in the requested `lang` come back listed in `missing`, not in `texts`. Do not invent, translate or guess a replacement body for a key that comes back in `missing`; report it as unavailable.

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `keys` (string, required): Comma list of up to 64 distinct keys: `<body>.<sign>` (planet in sign, also `chiron`, `ascendant`, `north_node`, `south_node`, `lilith`), `<body>.h<1-12>` (planet in house, also `chiron`, `lilith`),…
- `lang` (string, required): Language of the texts. No fallback: a text missing in this language is listed in `missing`.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `lang`
- `missing`
- `texts`

### `astroway_aspects_parallel_aspects` (~162 tokens)

Parallel Aspects

Calculate parallel (same declination) and contra-parallel (opposite declination) aspects between all planets within orb.

[Group: Aspects & Points]
[Endpoint: POST /v1/parallel-aspects]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `body` (required): Natal chart plus the declination orb in degrees.
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `parallels`

### `astroway_geo_parans` (~441 tokens)

Parans

Crossing points of two A*C*G lines: the places where two planets were simultaneously angular. Returns every planet-to-planet crossing with its coordinates.

[Group: Astro-Geography]
[Endpoint: POST /v1/parans]
[Required: date, time, latitude, longitude]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `city` (string)
- `cosmogram` (boolean)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `houseSystem` (string)
- `latitude` (number, required)
- `longitude` (number, required)
- `name` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `zodiacType` (string)

Output parameters:

- `count`
- `parans`

### `astroway_geo_parans_star` (~296 tokens)

Star-planet parans (Brady)

Latitudes where a fixed star and a planet are angular at the same moment, which is how Brady tabulates a paran: not a place, a latitude. Twelve event pairs per star and planet (rise, set, culminate, anticulminate, minus meridian against meridian, which is a shared right ascension rather than a paran). Each row carries the houses of the technique in plain form: which body does what, the latitude, and the meridian where it happens at this chart moment. Solved on hour angles rather than by intersecting map polylines, so the latitude is exact rather than quantised to the polyline step.

[Group: Astro-Geography]
[Endpoint: POST /v1/parans/star]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `body` (required): Birth data for star-planet parans. Coordinates are not used: a paran is a latitude, and which latitudes exist depends on the moment, not on where the native was born.
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `count`
- `gmst`
- `horizon`
- `julianDay`
- `latitudeLimit`
- `note`
- `obliquity`
- `parans`
- `requestedStarsNotFound`
- `stars`
- `starsWithNoParans`
- `type`

### `astroway_geo_phase_return` (~319 tokens)

Phase Return

Find dates when a planet returns to its same synodic phase relative to the Sun (e.g. next Venus heliacal rising, next Mars retrograde station).

[Group: Astro-Geography]
[Endpoint: POST /v1/phase-return]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `body` (required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `phase`
- `planet`
- `returns`

### `astroway_calendar_planetary_cycles` (~195 tokens)

Planetary Cycles

Find all conjunctions between two planets within a date range, defining the start of a new synodic cycle.

[Group: Calendar & Cycles]
[Endpoint: POST /v1/planetary-cycles]
[Required: planet1Id, planet2Id, startDate, endDate]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `endDate` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `planet1Id` (required)
- `planet2Id` (required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `startDate` (string, required)

Output parameters:

- `conjunctions`

### `astroway_calendar_planetary_hours` (~507 tokens)

Planetary Hours

Chaldean planetary hours for a date and place: 12 from sunrise to sunset and 12 from sunset to sunrise, so an hour is rarely 60 minutes. `startHour` and `endHour` are decimal local hours. Send `atLocalHour` (decimal local time, e.g. 15.2 for 15:12) to have the hour containing it marked `isCurrent`; without it no hour carries the field, because the answer is cacheable and a flag from the server clock would be stale by the time it renders.

[Group: Calendar & Cycles]
[Endpoint: POST /v1/planetary-hours]
[Required: date, latitude, longitude]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `atLocalHour` (number): Local time of day in decimal hours, e.g. 15.2 for 15:12. When sent, the hour containing it carries isCurrent: true and every other hour carries false. When omitted, no hour carries the field at all:…
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `latitude` (required)
- `longitude` (required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.

Output parameters:

- `date`
- `dayOfWeek`
- `dayRulerPlanetId`
- `dayRulerPlanetName`
- `hours`
- `latitude`
- `longitude`
- `sunTimes`
- `timezone`

### `astroway_calendar_planetary_phases` (~455 tokens)

Planetary Phases

Calculate the synodic phase of each planet relative to the Sun (new, crescent, first quarter, gibbous, full, disseminating, last quarter, balsamic).

[Group: Calendar & Cycles]
[Endpoint: POST /v1/planetary-phases]
[Required: date, time, latitude, longitude]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `city` (string)
- `cosmogram` (boolean)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `houseSystem` (string)
- `latitude` (number, required)
- `longitude` (number, required)
- `name` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `zodiacType` (string)

Output parameters:

- `phases`

### `astroway_western_planets` (~433 tokens)

Planet Positions

Calculate raw planet longitudes for a given date/time without full chart context (no houses, no aspects).

[Group: Core]
[Endpoint: POST /v1/planets]
[Required: date, time, latitude, longitude]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `city` (string)
- `cosmogram` (boolean)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `houseSystem` (string)
- `latitude` (number, required)
- `longitude` (number, required)
- `name` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `zodiacType` (string)

Output parameters:

- `planets`

### `astroway_dignities_receptions` (~166 tokens)

Mutual Receptions

Find mutual receptions between planets: pairs where each planet is in a sign ruled, exalted, or in the dignity of the other.

[Group: Dignities & Receptions]
[Endpoint: POST /v1/receptions]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `body` (required): Natal chart plus optional custom terms and decans tables.
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `count`
- `mutual`
- `receptions`

### `astroway_geo_relocation` (~174 tokens)

Relocation Chart

Recalculate a natal chart for a new geographic location (same birth moment, different lat/lng). Returns new houses and planet house positions.

[Group: Astro-Geography]
[Endpoint: POST /v1/relocation]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `body` (required): Wrapper { natal: ChartInput } used by endpoints that take a base natal plus extra parameters in flat fields.
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `delta`
- `natal`
- `relocated`

### `astroway_render_aspect_grid` (~148 tokens)

Aspect Grid (SVG)

Triangular aspect matrix: rows × columns = planets, each cell shows aspect glyph + orb. Standard textbook layout.

[Group: Visualization]
[Endpoint: POST /v1/render/aspect-grid]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `body` (required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `byteLength`
- `format`
- `svg`

### `astroway_render_bi_wheel` (~149 tokens)

Bi-Wheel (SVG)

Two concentric wheels: inner natal + outer ring with transit (or progression) planets. Standard bi-wheel layout.

[Group: Visualization]
[Endpoint: POST /v1/render/bi-wheel]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `body` (required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `byteLength`
- `format`
- `svg`

### `astroway_render_biorhythm` (~189 tokens)

Biorhythm (SVG)

Three-curve sine plot of physical (23d), emotional (28d), and intellectual (33d) cycles since birth.

[Group: Visualization]
[Endpoint: POST /v1/render/biorhythm]
[Required: birthDate, rangeStart, rangeEnd]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `birthDate` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `options` (object)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `rangeEnd` (string, required)
- `rangeStart` (string, required)

Output parameters:

- `byteLength`
- `format`
- `svg`

### `astroway_render_composite` (~156 tokens)

Composite Chart (SVG)

Composite-chart wheel from two natal inputs. Computes midpoint composite then renders as Western wheel.

[Group: Visualization]
[Endpoint: POST /v1/render/composite]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `body` (required): Pair of natal charts for relationship calculations: synastry, composite, davison.
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `byteLength`
- `format`
- `svg`

### `astroway_render_cosmogram` (~318 tokens)

Cosmogram: Hamburg School 90° dial (SVG)

Cosmobiology 90° dial. Plots planets at (longitude mod 90)° across 4 quadrants, Cardinal/Fixed/Mutable repeated.

[Group: Visualization]
[Endpoint: POST /v1/render/cosmogram]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `body` (required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `byteLength`
- `format`
- `svg`

### `astroway_render_eclipse_path` (~191 tokens)

Eclipse Path Map (SVG)

Equirectangular world graticule with caller-supplied eclipse track. Renders centerline + shaded band of given degree-width.

[Group: Visualization]
[Endpoint: POST /v1/render/eclipse-path]
[Required: path]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `bandWidthDeg` (number)
- `centerlinePoints` (array)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `options` (object)
- `path` (array, required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `title` (string)

Output parameters:

- `byteLength`
- `format`
- `svg`

### `astroway_render_moon_phase` (~305 tokens)

Moon Phase (SVG)

Render the moon disk with its illuminated fraction at the given moment. Returns SVG plus illumination metrics.

[Group: Visualization]
[Endpoint: POST /v1/render/moon-phase]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `body` (required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `elongationDeg`
- `illuminationFraction`
- `phase`
- `svg`
- `waxing`

### `astroway_render_star_map` (~194 tokens)

Star Map (SVG)

Stereographic projection of caller-supplied points (RA/Dec). Handles brightness magnitude scaling and labels.

[Group: Visualization]
[Endpoint: POST /v1/render/star-map]
[Required: points]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `capAltitudeDeg` (number)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `observerLatDeg` (number)
- `options` (object)
- `points` (array, required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `title` (string)
- `zenithDecDeg` (number)

Output parameters:

- `byteLength`
- `format`
- `svg`

### `astroway_render_timeline` (~179 tokens)

Timeline (SVG)

Gantt-style horizontal timeline of transit/aspect events over a date window. Caller supplies events array.

[Group: Visualization]
[Endpoint: POST /v1/render/timeline]
[Required: rangeStart, rangeEnd, events]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `events` (array, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `options` (object)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `rangeEnd` (string, required)
- `rangeStart` (string, required)

Output parameters:

- `byteLength`
- `format`
- `svg`

### `astroway_render_tri_wheel` (~657 tokens)

Tri-Wheel (SVG)

Three concentric wheels: natal + progressed + transit. Used for advanced forecasting visuals.

[Group: Visualization]
[Endpoint: POST /v1/render/tri-wheel]
[Required: natal, middle, outer]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `middle` (object, required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `natal` (object, required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `options` (object)
- `outer` (object, required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `byteLength`
- `format`
- `svg`

### `astroway_render_wheel_vedic_east` (~313 tokens)

Vedic Wheel: East Indian (SVG)

East Indian (Bengali) layout: square with diagonals + inner rotated square forming 12 sectors.

[Group: Visualization]
[Endpoint: POST /v1/render/wheel-vedic-east]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `body` (required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `byteLength`
- `format`
- `svg`

### `astroway_render_wheel_vedic_north` (~314 tokens)

Vedic Wheel: North Indian (SVG)

North Indian diamond chart layout: 12 fixed positions, signs rotate per ascendant. Standard BPHS rendering.

[Group: Visualization]
[Endpoint: POST /v1/render/wheel-vedic-north]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `body` (required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `byteLength`
- `format`
- `svg`

### `astroway_render_wheel_vedic_south` (~318 tokens)

Vedic Wheel: South Indian (SVG)

South Indian 4×4 grid layout (Pisces top-left, signs fixed). House numbers placed where lagna sign falls.

[Group: Visualization]
[Endpoint: POST /v1/render/wheel-vedic-south]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `body` (required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `byteLength`
- `format`
- `svg`

### `astroway_render_wheel_western` (~155 tokens)

Western Wheel (SVG)

Render a Western natal wheel as SVG: signs ring, houses ring, planets, aspect lines. Pure server-side, no browser needed.

[Group: Visualization]
[Endpoint: POST /v1/render/wheel-western]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `body` (required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `byteLength`
- `format`
- `svg`

### `astroway_calendar_retrograde_periods` (~221 tokens)

Retrograde Periods

Retrograde periods of the planets in `planetIds` (default Mercury) within a date range: the two stations and their longitudes, plus `shadowStart` (the planet first reaches the longitude of its direct station) and `shadowEnd` (it regains the longitude of its retrograde station).

[Group: Calendar & Cycles]
[Endpoint: POST /v1/retrograde-periods]
[Required: startDate, endDate]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `endDate` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `planetIds` (array)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `startDate` (string, required)

Output parameters:

- `periods`

### `astroway_aspects_sabian_symbols` (~160 tokens)

Sabian Symbols

Return the Sabian symbol (Dane Rudhyar) for each given ecliptic longitude.

[Group: Aspects & Points]
[Endpoint: POST /v1/sabian-symbols]
[Required: longitudes]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `longitudes` (array, required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `count`
- `symbols`

### `astroway_geo_solar_acg` (~326 tokens)

Solar A*C*G

Astrocartography for the solar return of a given year: the A*C*G map of the moment the Sun comes back to its natal longitude. Planet names carry an SR suffix.

[Group: Astro-Geography]
[Endpoint: POST /v1/solar-acg]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `body` (required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `lines`
- `year`

### `astroway_western_sun_times` (~341 tokens)

Sun Times

Calculate sunrise, sunset, twilight times, and day length for a given date and geographic location.

[Group: Core]
[Endpoint: POST /v1/sun-times]
[Required: date, latitude, longitude]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `latitude` (required)
- `longitude` (required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.

Output parameters:

- `dawn`
- `dayLength`
- `dusk`
- `sunrise`
- `sunset`

### `astroway_content_localization_translate_astro` (~204 tokens)

Translate (astro-aware)

Translate one text into any of 21 languages with astrology-domain glossary pinning. Source defaults to English; pass source_lang to override. Credits: 15 + ceil(chars/40). Max 3000 chars.

[Group: Content Localization]
[Endpoint: POST /v1/translate/astro]
[Required: text, target_lang]
[Cost: 16 credits (Tier 1)]

Input parameters:

- `domain` (string)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `source_lang` (string)
- `target_lang` (string, required)
- `text` (string, required)

Output parameters:

- `chars`
- `credits`
- `domain`
- `provider`
- `source_lang`
- `target_lang`
- `translated`

### `astroway_content_localization_translate_batch` (~196 tokens)

Translate batch

Translate up to 25 strings (≤2000 chars each, ≤20000 total) sharing one target language + domain. Credits: 15 + ceil(total_chars/40).

[Group: Content Localization]
[Endpoint: POST /v1/translate/batch]
[Required: items, target_lang]
[Cost: 16 credits (Tier 1)]

Input parameters:

- `domain` (string)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `items` (array, required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `source_lang` (string)
- `target_lang` (string, required)

Output parameters:

- `chars`
- `count`
- `credits`
- `domain`
- `items`
- `source_lang`
- `target_lang`

### `astroway_content_localization_translate_glossary_lang` (~187 tokens)

Glossary download

Download the astrology glossary for a target language. Query: ?source=<lang> (default en), ?domain=<domain> (default generic). Free (0 credits).

[Group: Content Localization]
[Endpoint: GET /v1/translate/glossary/{lang}]
[Required: lang]
[Cost: see your plan — endpoint not in the public credit manifest]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `lang` (string, required): Target language code, one of the active locales.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `count`
- `domain`
- `entries`
- `source_lang`
- `target_lang`

### `astroway_content_localization_translate_languages` (~141 tokens)

Supported languages

List the 21 supported language codes + names. Free (0 credits).

[Group: Content Localization]
[Endpoint: GET /v1/translate/languages]
[Cost: see your plan — endpoint not in the public credit manifest]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `count`
- `languages`

### `astroway_geo_zenith` (~435 tokens)

Zenith

Find all geographic locations where a given planet is exactly at the zenith (MC) at the birth moment.

[Group: Astro-Geography]
[Endpoint: POST /v1/zenith]
[Required: date, time, latitude, longitude]
[Cost: 50 credits (Tier 3)]

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `city` (string)
- `cosmogram` (boolean)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `houseSystem` (string)
- `latitude` (number, required)
- `longitude` (number, required)
- `name` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `zodiacType` (string)

Output parameters:

- `count`
- `points`

### `astroway_zodiac_signs_per_sign_deep_zodiac_aquarius` (~153 tokens)

Aquarius: Fixed Air

Communal innovation, futurist detachment. Saturn + Uranus. I KNOW.

[Group: Zodiac Signs (Per-Sign Deep)]
[Endpoint: GET /v1/zodiac/aquarius]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `cohort`
- `decans`
- `degreeRange`
- `description`
- `sign`
- `source`

### `astroway_zodiac_signs_per_sign_deep_zodiac_aries` (~150 tokens)

Aries: Cardinal Fire

Pioneering will, raw initiation. Ruler Mars. I AM signature.

[Group: Zodiac Signs (Per-Sign Deep)]
[Endpoint: GET /v1/zodiac/aries]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `cohort`
- `decans`
- `degreeRange`
- `description`
- `sign`
- `source`

### `astroway_zodiac_signs_per_sign_deep_zodiac_cancer` (~148 tokens)

Cancer: Cardinal Water

Protective nurture, tidal memory. Ruler Moon. I FEEL.

[Group: Zodiac Signs (Per-Sign Deep)]
[Endpoint: GET /v1/zodiac/cancer]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `cohort`
- `decans`
- `degreeRange`
- `description`
- `sign`
- `source`

### `astroway_zodiac_signs_per_sign_deep_zodiac_capricorn` (~151 tokens)

Capricorn: Cardinal Earth

Disciplined mastery, long-view structure. Ruler Saturn. I USE.

[Group: Zodiac Signs (Per-Sign Deep)]
[Endpoint: GET /v1/zodiac/capricorn]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `cohort`
- `decans`
- `degreeRange`
- `description`
- `sign`
- `source`

### `astroway_zodiac_signs_per_sign_deep_zodiac_gemini` (~149 tokens)

Gemini: Mutable Air

Curious connection, plural perspectives. Ruler Mercury. I THINK.

[Group: Zodiac Signs (Per-Sign Deep)]
[Endpoint: GET /v1/zodiac/gemini]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `cohort`
- `decans`
- `degreeRange`
- `description`
- `sign`
- `source`

### `astroway_zodiac_signs_per_sign_deep_zodiac_leo` (~148 tokens)

Leo: Fixed Fire

Radiant generosity, theatrical authority. Ruler Sun. I WILL.

[Group: Zodiac Signs (Per-Sign Deep)]
[Endpoint: GET /v1/zodiac/leo]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `cohort`
- `decans`
- `degreeRange`
- `description`
- `sign`
- `source`

### `astroway_zodiac_signs_per_sign_deep_zodiac_libra` (~149 tokens)

Libra: Cardinal Air

Partnership, aesthetic balance, mediation. Ruler Venus. I BALANCE.

[Group: Zodiac Signs (Per-Sign Deep)]
[Endpoint: GET /v1/zodiac/libra]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `cohort`
- `decans`
- `degreeRange`
- `description`
- `sign`
- `source`

### `astroway_zodiac_signs_per_sign_deep_zodiac_pisces` (~152 tokens)

Pisces: Mutable Water

Oceanic compassion, dissolving boundaries. Jupiter + Neptune. I BELIEVE.

[Group: Zodiac Signs (Per-Sign Deep)]
[Endpoint: GET /v1/zodiac/pisces]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `cohort`
- `decans`
- `degreeRange`
- `description`
- `sign`
- `source`

### `astroway_zodiac_signs_per_sign_deep_zodiac_sagittarius` (~150 tokens)

Sagittarius: Mutable Fire

Philosophical quest, frank expansion. Ruler Jupiter. I SEE.

[Group: Zodiac Signs (Per-Sign Deep)]
[Endpoint: GET /v1/zodiac/sagittarius]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `cohort`
- `decans`
- `degreeRange`
- `description`
- `sign`
- `source`

### `astroway_zodiac_signs_per_sign_deep_zodiac_scorpio` (~150 tokens)

Scorpio: Fixed Water

Penetrating depth, transformation. Mars + Pluto. I DESIRE.

[Group: Zodiac Signs (Per-Sign Deep)]
[Endpoint: GET /v1/zodiac/scorpio]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `cohort`
- `decans`
- `degreeRange`
- `description`
- `sign`
- `source`

### `astroway_zodiac_signs_per_sign_deep_zodiac_taurus` (~149 tokens)

Taurus: Fixed Earth

Embodied stability, sensory wealth. Ruler Venus. I HAVE.

[Group: Zodiac Signs (Per-Sign Deep)]
[Endpoint: GET /v1/zodiac/taurus]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `cohort`
- `decans`
- `degreeRange`
- `description`
- `sign`
- `source`

### `astroway_zodiac_signs_per_sign_deep_zodiac_virgo` (~152 tokens)

Virgo: Mutable Earth

Discerning service, refined craft. Ruler Mercury. I ANALYZE.

[Group: Zodiac Signs (Per-Sign Deep)]
[Endpoint: GET /v1/zodiac/virgo]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `cohort`
- `decans`
- `degreeRange`
- `description`
- `sign`
- `source`

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/info-astroway-core/mcp-core#diagnostics

## Score history

- 2026-10-11: 77
- 2026-10-09: 25

## Common questions

### What is the AstroWay Core astrology MCP server?

AstroWay Core astrology is an MCP server listed in the public MCP registry as info.astroway/core. Natal charts, planets, houses, aspects, dignities, rendering and the calendar. This page covers its hosted endpoint (https://mcp.astroway.info/mcp/core).

### Is the AstroWay Core astrology MCP server safe to use?

AstroWay Core astrology scores 77 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the AstroWay Core astrology MCP server expose?

AstroWay Core astrology exposes 105 tools: astroway_account_status, astroway_cost_estimate, astroway_geo_acg, astroway_geo_acg_best_places, astroway_geo_acg_by_category, and 100 more. Their descriptions and schemas cost roughly 26,779 tokens of context every time the server is loaded.

### Does the AstroWay Core astrology MCP server require authentication?

Yes. AstroWay Core astrology asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

### Is the AstroWay Core astrology MCP server still maintained?

AstroWay Core astrology is still listed as active in the MCP registry. We last reached this channel on 11 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://mcp.astroway.info/mcp/core
- Authorisation metadata: https://mcp.astroway.info/.well-known/oauth-protected-resource/mcp/core
- Website: https://api.astroway.info/en/examples/mcp/
- Changelog RSS feed: https://verifymcp.io/servers/info-astroway-core/mcp-core.xml
- Changelog JSON feed: https://verifymcp.io/servers/info-astroway-core/mcp-core.json
- HTML version of this page: https://verifymcp.io/servers/info-astroway-core/mcp-core
