# AstroWay Reports (remote · mcp.astroway.info)

Sixteen finished PDF reports and the white-label configuration behind them.

- 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-reports/mcp-reports.md), [page](https://verifymcp.io/servers/info-astroway-reports/mcp-reports)

## Channel facts

- Endpoint: `https://mcp.astroway.info/mcp/reports`
- 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**: 68/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 15244 tokens (~272/item across 56 items; 42 tools + 14 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 13/100
  - Stability observed for 4 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).
  - 52% of tool parameters carry a description.
  - Structured output schemas are declared (90% 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 42 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 44 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 Reports MCP server?

AstroWay Reports is a hosted endpoint at https://mcp.astroway.info/mcp/reports, 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-reports 'https://mcp.astroway.info/mcp/reports'
```

### Cursor

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

### VS Code

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

### Codex

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

### opencode

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

### OpenClaw

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

### Hermes

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

### Netclaw

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

### Vellum

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

### Other

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

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, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-10 (score 76, +2)

- [security improvement] Judged manipulation: unverified → pass
- [security] Tool “astroway_agent_tools” rewrote its description, which is the text the model reads
- [security] Tool “astroway_mcp_agent_debate” rewrote its description, which is the text the model reads
- [security] Tool “astroway_mcp_agent_pool_status” rewrote its description, which is the text the model reads
- [security] Tool “astroway_mcp_ai_chat” rewrote its description, which is the text the model reads
- [security] Tool “astroway_mcp_ai_comparison_coach” rewrote its description, which is the text the model reads
- [security] Tool “astroway_mcp_ai_explain_aspect” rewrote its description, which is the text the model reads
- [security] Tool “astroway_mcp_ai_explain_transit” rewrote its description, which is the text the model reads
- [security] Tool “astroway_mcp_multi_agent_coordinate” rewrote its description, which is the text the model reads
- [security] Tool “astroway_mcp_multi_chart_context” rewrote its description, which is the text the model reads
- [security] Tool “astroway_mcp_rag_search” rewrote its description, which is the text the model reads
- [security] Tool “astroway_mcp_streaming” rewrote its description, which is the text the model reads
- [security] Tool “astroway_mcp_tool_call_stream” rewrote its description, which is the text the model reads
- [security] Tool “astroway_mcp_tools_list” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_ai_monthly_narrative” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_ai_natal_narrative” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_ai_synastry_narrative” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_ai_transit_narrative” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_ai_year_ahead_narrative” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_business” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_career” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_child” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_gemstone” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_generate” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_history” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_human_design” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_lal_kitab” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_love” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_money” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_muhurta” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_natal” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_relocation” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_stellaforge” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_synastry” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_tarot” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_transit_yearly” rewrote its description, which is the text the model reads
- [security] Tool “astroway_reports_vedic_kundli” rewrote its description, which is the text the model reads
- [security] Tool “astroway_whitelabel_config” rewrote its description, which is the text the model reads
- [security] Tool “astroway_whitelabel_domain_verify” rewrote its description, which is the text the model reads
- [security] Tool “astroway_whitelabel_logo” rewrote its description, which is the text the model reads
- [security] Tool “astroway_whitelabel_preview” rewrote its description, which is the text the model reads

### 2026-10-08 (score 74, 0)

- [functional improvement] Stability: unverified → 0.03

### 2026-10-07 (score 74)

First indexed and scored.

## MCP tools (42)

### `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_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_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_reports_ai_monthly_narrative` (~393 tokens)

AI Monthly Narrative

Single-month forecast. Tighter scope than year-ahead: uses fast and slow planet transits within the month. Inputs: chart, year, month (1-12), language, tone, length.

[Group: AI Reports]
[Endpoint: POST /v1/reports/ai/monthly-narrative]
[Required: chart, year, month]
[Cost: 250 credits (Tier 5)] ⚠️ Heavy — confirm with user before invoking.

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.
- `language` (string)
- `length` (string)
- `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.
- `tone` (string)
- `year` (integer, required)

Output parameters:

- `disclaimer`
- `model`
- `narrative`
- `tokens`

### `astroway_reports_ai_natal_narrative` (~411 tokens)

AI Natal Narrative

Long-form natal-chart narrative (markdown). Inputs: chart, language (21 codes), tone (warm/professional/concise), length (short/medium/long; ≤3200 tokens). Returns the narrative text plus model and token usage. AI grounded on the computed natal chart: Sun/Moon/Asc, 13 bodies, 12 houses, ≤25 major aspects.

[Group: AI Reports]
[Endpoint: POST /v1/reports/ai/natal-narrative]
[Required: chart]
[Cost: 250 credits (Tier 5)] ⚠️ Heavy — confirm with user before invoking.

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.
- `language` (string)
- `length` (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.
- `tone` (string)

Output parameters:

- `disclaimer`
- `duration_ms`
- `language`
- `length`
- `model`
- `narrative`
- `tokens`
- `tone`

### `astroway_reports_ai_synastry_narrative` (~535 tokens)

AI Synastry Narrative

Long-form relationship narrative grounded in cross-chart aspects. Inputs: chart1, chart2, language, tone, length.

[Group: AI Reports]
[Endpoint: POST /v1/reports/ai/synastry-narrative]
[Required: chart1, chart2]
[Cost: 250 credits (Tier 5)] ⚠️ Heavy — confirm with user before invoking.

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)
- `length` (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.
- `tone` (string)

Output parameters:

- `disclaimer`
- `model`
- `narrative`
- `tokens`

### `astroway_reports_ai_transit_narrative` (~412 tokens)

AI Transit Narrative (single date)

Snapshot transit interpretation for a specific date. Inputs: chart + transitDate (+optional transitTime/tzOffset), language, tone, length. Returns narrative grounded in transit-to-natal aspects (orb ≤1°).

[Group: AI Reports]
[Endpoint: POST /v1/reports/ai/transit-narrative]
[Cost: 250 credits (Tier 5)] ⚠️ Heavy — confirm with user before invoking.

Input parameters:

- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `date` (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.
- `time` (string)
- `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:

- `disclaimer`
- `model`
- `narrative`
- `tokens`

### `astroway_reports_ai_year_ahead_narrative` (~389 tokens)

AI Year-Ahead Narrative

Long-form annual report. Combines natal context with the year's major outer-planet transits clustered by month. Inputs: chart, year (default = next year), language, tone, length (use long for full annual report).

[Group: AI Reports]
[Endpoint: POST /v1/reports/ai/year-ahead-narrative]
[Required: chart]
[Cost: 250 credits (Tier 5)] ⚠️ Heavy — confirm with user before invoking.

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.
- `language` (string)
- `length` (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.
- `tone` (string)
- `year` (integer)

Output parameters:

- `disclaimer`
- `model`
- `narrative`
- `tokens`

### `astroway_reports_business` (~357 tokens)

Generate Business Astrology Report (PDF or HTML)

Founding-chart analysis (mundane astrology). Highlights Sun (purpose), MC (reputation), Jupiter (growth), Saturn (structure). Disclaimer: "not financial advice".

[Group: Reports]
[Endpoint: POST /v1/reports/business]
[Required: chart]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `chart` (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.
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_career` (~355 tokens)

Generate Career Compass Report (PDF or HTML)

Career-themed natal: MC, 10th-house cusp, Saturn placement, Mars motivation, aspects to Sun. Self-knowledge tool, not directive.

[Group: Reports]
[Endpoint: POST /v1/reports/career]
[Required: chart]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `chart` (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.
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_child` (~365 tokens)

Generate Child Astrology Report (PDF or HTML)

Parenting-oriented natal report. Highlights Moon (emotional core), Mercury (learning style), Venus (connection style), Mars (energy/temperament). Includes full natal data and a disclaimer noting interpretive nature.

[Group: Reports]
[Endpoint: POST /v1/reports/child]
[Required: chart]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `chart` (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.
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_gemstone` (~482 tokens)

Generate Gemstone Report (PDF or HTML)

The ratna prescription as a multi-page A4 PDF (default) or live HTML (add `?format=html`). Same astrology as `POST /vedic/gemstones`, and pinned by a test to never disagree with it: same sidereal lagna, same two schools, same three gems. What the document adds is what a table cannot carry. Every recommended gem gets a page: what the graha it belongs to signifies classically, the basis in house ownership, mineral and substitutes, weight in ratti with gram and carat conversions, weekday, finger, metal, mantra and japa count, and **the next auspicious day to first wear it**, found by scanning th…

[Group: Reports]
[Endpoint: POST /v1/reports/gemstone]
[Required: chart]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `chart` (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.
- `school` (string)
- `wearingFrom` (string)
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_generate` (~799 tokens)

Generate Report: Unified Dispatcher (V2)

Single endpoint over the 12 type-specific renderers: pass report_type ("natal" | "transit-yearly" | "synastry" | "business" | "career" | "love" | "money" | "child" | "lal-kitab" | "human-design" | "tarot" | "vedic-kundli") plus the renderer-specific inputs. SDK ergonomics: one method instead of 12. Required fields vary by type: chart for most, chart1+chart2 for synastry, seed for tarot (chart optional).

[Group: Reports]
[Endpoint: POST /v1/reports/generate]
[Required: report_type]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `allowReversed` (boolean)
- `chart`: 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;…
- `chart1`: 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`: 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)
- `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.
- `report_type` (string, required)
- `seed`
- `spread` (string)
- `whitelabel`
- `year` (integer)

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_history` (~215 tokens)

List Recent Report Exports

List the calling key's most recently generated PDF reports: type, byte size, page count, language, created/expiry timestamps and a `url`. Re-fetch a report link within its 24h validity window, or surface recent exports in a dashboard. PDFs are purged after 24h, so older items return `expired: true` with a now-dead URL. Free to call. Query `?limit=` (1–50, default 10).

[Group: Reports]
[Endpoint: GET /v1/reports/history]
[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`
- `items`

### `astroway_reports_human_design` (~364 tokens)

Generate Human Design Report (PDF or HTML)

Bodygraph PDF: Type, Strategy, Authority, Profile, Definition, Not-Self theme, Incarnation Cross + 9 centers (defined/open) + activated channels with gate pairs.

[Group: Reports]
[Endpoint: POST /v1/reports/human-design]
[Required: chart]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `chart` (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.
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_lal_kitab` (~399 tokens)

Generate Lal Kitab Report (PDF or HTML)

Lal Kitab analysis: Teva (graha placements with Pakka-ghar match), Kismat & Prosperity scores, detected Rins (ancestral debts) with triggers, suggested Upayas (remedies). Sidereal compute (Lahiri ayanamsa) with sign-from-Lagna house numbering per Lal Kitab convention.

[Group: Reports]
[Endpoint: POST /v1/reports/lal-kitab]
[Required: chart]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `chart` (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.
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_love` (~361 tokens)

Generate Love Report (PDF or HTML)

Romantic-relationship natal report. Highlights Venus (attraction style), Mars (desire), Moon (emotional needs), Descendant (partner profile). Disclaimer: not a prophecy.

[Group: Reports]
[Endpoint: POST /v1/reports/love]
[Required: chart]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `chart` (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.
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_money` (~359 tokens)

Generate Money Report (PDF or HTML)

Financial natal: 2nd house (earned income), 8th house (shared resources), Jupiter (expansion), Saturn (discipline). Disclaimer: not investment advice.

[Group: Reports]
[Endpoint: POST /v1/reports/money]
[Required: chart]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `chart` (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.
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_muhurta` (~424 tokens)

Generate Muhurta Report (PDF or HTML)

Render a standard A4 report of the most auspicious dates for a chosen activity over a search window. Same window-scan engine as /vedic/muhurat/*: it scores each day by sunrise Panchang (Tithi/Vara/Nakshatra/Yoga/Karana) per Muhurta Chintamani + B.V.Raman, and lists ranked days with per-day Abhijit Muhurat and the scoring factors as the rationale. `activity` is one of the 12 from /muhurta/types. PDF default; ?format=html returns HTML.

[Group: Reports]
[Endpoint: POST /v1/reports/muhurta]
[Required: activity, search_window_start, latitude, longitude]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `activity` (string, required)
- `ayanamsa` (string): Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
- `ayanamsaId`
- `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)
- `latitude` (number, required)
- `longitude` (number, 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.
- `search_window_end` (string)
- `search_window_start` (string, required)
- `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.
- `topN` (integer)
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_natal` (~450 tokens)

Generate Natal Report (PDF or HTML)

Render a Western tropical natal chart as a single-page A4 PDF (default) or live HTML (add `?format=html`). Includes Big Three (Sun/Moon/ASC), full planets table with houses + retrograde, all 12 house cusps, and major aspects. Set `whitelabel: true` to apply the caller's branding overrides. Languages: `uk` (default) or `en`. PDF URLs valid 24h via auto-cleanup cron; HTML mode streams directly without storage.

[Group: Reports]
[Endpoint: POST /v1/reports/natal]
[Required: chart]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `chart` (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;…
- `enrich` (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)
- `length` (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.
- `tone` (string)
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_relocation` (~460 tokens)

Generate Relocation Report (PDF or HTML)

Compare up to five places for one birth chart as a multi-page A4 PDF (default) or live HTML (add `?format=html`). Per place: the relocated ascendant and midheaven with the signed shift from birth, **which planets changed house** (the substantive difference, diffed rather than left as two tables), every astrocartography line running within 300 km with its interpretation text, and supportive/challenging scores across the 19 life categories. With more than one place a side-by-side comparison leads the document.

[Group: Reports]
[Endpoint: POST /v1/reports/relocation]
[Required: chart, locations]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `categories` (array)
- `chart` (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)
- `locations` (array, required)
- `orbKm` (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.
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_stellaforge` (~476 tokens)

Generate Stellaforge Birth-Chart Poster (PDF or HTML)

Render a data-rich, print-ready natal chart poster. A high-detail western wheel (colored element sectors, colored glyphs, degree labels, ASC arrow, MC marker, house cusps) plus the Sun/Moon/Rising trio, a placements table, element/modality balance bars, and the top aspects, fully deterministic, 0 AI. Three styles via `style`: `editorial` (light), `celestial` (dark + gold), `classic` (minimal). White-label via `whitelabel`. i18n via `language`. PDF default; `?format=html` returns HTML. NB `style` is read from the request BODY, not the query string.

[Group: Reports]
[Endpoint: POST /v1/reports/stellaforge]
[Required: chart]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `chart` (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.
- `style` (string)
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_synastry` (~536 tokens)

Generate Synastry Report (PDF or HTML)

Render a relationship synastry PDF: side-by-side Big Three, full cross-chart aspect table (top 40 major aspects), and per-chart + combined element/modality balance.

[Group: Reports]
[Endpoint: POST /v1/reports/synastry]
[Required: chart1, chart2]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `chart1` (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` (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.
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_tarot` (~259 tokens)

Generate Tarot Reading (PDF or HTML)

Render a tarot reading PDF. Default spread `three-card` (Past/Present/Future from Rider-Waite-Smith deck). Available spreads: single-card, three-card, celtic-cross, horseshoe, relationship, year-ahead, decision, chakra, career, love-triangle. Pass `seed` for reproducibility (deterministic mulberry32 RNG); omit to use a daily seed. Set `allowReversed: false` to draw upright cards only.

[Group: Reports]
[Endpoint: POST /v1/reports/tarot]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `allowReversed` (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)
- `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.
- `seed`
- `spread` (string)
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_transit_yearly` (~397 tokens)

Generate Year-Ahead Transit (PDF or HTML)

Render a year-ahead transit calendar PDF grouped by month. Includes major aspects (conjunction, sextile, square, trine, opposition) of outer planets (Mars through Pluto) to natal positions, with 0.5° max orb. Defaults to next calendar year if `year` omitted.

[Group: Reports]
[Endpoint: POST /v1/reports/transit-yearly]
[Required: chart]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `chart` (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.
- `whitelabel`
- `year` (integer)

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_reports_vedic_kundli` (~386 tokens)

Generate Vedic Kundli (PDF or HTML)

Sidereal Vedic chart (Lahiri ayanamsa): Lagna + Moon nakshatra/pada, all sidereal planet positions with nakshatra+pada+house, full 9-period Vimshottari Mahadasha tree with current period highlighted.

[Group: Reports]
[Endpoint: POST /v1/reports/vedic-kundli]
[Required: chart]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `chart` (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.
- `whitelabel`

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `storage_key`
- `url`

### `astroway_whitelabel_config` (~150 tokens)

Get White-label Config

Read the authenticated user's branding overrides (logo, colour palette, font, footer text, custom domain). On first access, defaults are seeded.

[Group: White-label]
[Endpoint: GET /v1/whitelabel/config]
[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:

- `custom_domain`
- `domain_last_checked_at`
- `domain_verified`
- `font_family`
- `footer_text`
- `logo_storage_key`
- `primary_color`
- `secondary_color`
- `updated_at`

### `astroway_whitelabel_domain_verify` (~164 tokens)

Verify Custom Domain DNS

Check whether the configured custom_domain points to api.astroway.info via CNAME. Persists the result. If only A records resolve, returns them with a hint to switch to CNAME.

[Group: White-label]
[Endpoint: POST /v1/whitelabel/domain/verify]
[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:

- `domain`
- `expectedTarget`
- `resolved`
- `verified`

### `astroway_whitelabel_logo` (~181 tokens)

Upload White-label Logo

Upload a logo as a base64 data URL (`data:image/<png|jpeg|svg+xml|webp>;base64,...`). Maximum 512 KB. Replaces any prior logo and deletes the old file from storage.

[Group: White-label]
[Endpoint: POST /v1/whitelabel/logo]
[Required: data_url]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `data_url` (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.

Output parameters:

- `byte_length`
- `logo_storage_key`
- `logo_url`
- `mime_type`

### `astroway_whitelabel_preview` (~201 tokens)

Preview White-label Report

Render a sample natal report PDF using the authenticated user's white-label configuration (colours, font, footer, logo). Pass `chart` to use your own birth data; omit to use the bundled Kyiv 1990 sample.

[Group: White-label]
[Endpoint: POST /v1/whitelabel/preview]
[Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

Input parameters:

- `chart`
- `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.

Output parameters:

- `byte_length`
- `duration_ms`
- `expires_at`
- `page_count`
- `preview`
- `storage_key`
- `url`

## Diagnostics

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

## Score history

- 2026-10-11: 77
- 2026-10-10: 76
- 2026-10-08: 74
- 2026-10-07: 74

## Common questions

### What is the AstroWay Reports MCP server?

AstroWay Reports is an MCP server listed in the public MCP registry as info.astroway/reports. Sixteen finished PDF reports and the white-label configuration behind them. This page covers its hosted endpoint (https://mcp.astroway.info/mcp/reports).

### Is the AstroWay Reports MCP server safe to use?

AstroWay Reports 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 Reports MCP server expose?

AstroWay Reports exposes 42 tools: astroway_account_status, astroway_cost_estimate, astroway_agent_tools, astroway_mcp_ai_chat, astroway_mcp_ai_comparison_coach, and 37 more. Their descriptions and schemas cost roughly 14,349 tokens of context every time the server is loaded.

### Does the AstroWay Reports MCP server require authentication?

Yes. AstroWay Reports 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 Reports MCP server still maintained?

AstroWay Reports 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/reports
- Authorisation metadata: https://mcp.astroway.info/.well-known/oauth-protected-resource/mcp/reports
- Website: https://api.astroway.info/en/examples/mcp/
- Changelog RSS feed: https://verifymcp.io/servers/info-astroway-reports/mcp-reports.xml
- Changelog JSON feed: https://verifymcp.io/servers/info-astroway-reports/mcp-reports.json
- HTML version of this page: https://verifymcp.io/servers/info-astroway-reports/mcp-reports
