LabscoMCP early access ↗
astrowayMCP SERVER · OFFICIAL PROJECT

AstroWay MCP

Compute charts across the Western, Vedic, Hellenistic, Chinese and Mayan traditions, render them as SVG or PDF, and price a call in credits before you spend them.

by astroway ↗Games, Entertainment & Fandom✓ Official

LABSCO SUMMARY

Breadth is the product, and the credit line inside each tool description is the thing to read before wiring one in.

Prices travel with the tool rather than sitting in a price list, and the spread is wide — from 5 credits to 500 depending on the endpoint — while a set of endpoints carries "not in the public credit manifest" where a number would be, which is precisely the set the cost estimator cannot price ahead of time. Those same descriptions are where lifecycle notices live, so the tool text doubles as the migration notice. If the catalogue is too large for your client, discovery mode trades typed structured output for a two-tool footprint — worth knowing before you choose it.

What it is

An astrology and divination compute API fronted by a very large MCP catalogue — natal and relationship maths, Vedic dashas and Panchang, Hellenistic and Cosmobiology techniques, tarot, numerology and geomancy — with server-side chart rendering, PDF reports, credit accounting, outbound webhooks and white-label branding alongside them. The catalogue is generated from the API's own endpoint manifest, so new endpoints arrive with the next release rather than by hand.

What you get

  • Chart maths that reports what it cannot know rather than guessing: astroway_western_chart accepts timeUnknown: true in place of time and returns planets and aspects with houses, angles and sect set to null, plus a timeUnknown block giving the range the Moon covers that day; astroway_relational_synastry applies the same rule per partner, so cross-aspects still come back while that side's houses, angles and sect are null.
  • A price check that runs before the call: astroway_account_status reports the key's tier, credit balance, rate limits and monthly cycle reset, and astroway_cost_estimate prices a list of endpoints without invoking them, returning a total plus a per-endpoint breakdown with tier annotations.
  • Wheels drawn on the server with no browser in the path: astroway_render_wheel_western returns signs ring, houses ring, planets and aspect lines as SVG; astroway_render_wheel_vedic_north, astroway_render_wheel_vedic_south and astroway_render_wheel_vedic_east cover the diamond, 4x4-grid and Bengali layouts; astroway_render_bi_wheel stacks transits over natal; astroway_render_cosmogram plots the cosmobiology dial.
  • PDFs with a stated shelf life instead of a link you hope still works: astroway_reports_natal renders A4 or live HTML, and astroway_reports_history lists the calling key's recent exports with type, byte size, page count, language and created and expiry timestamps, marking anything past its window expired with a now-dead URL.
  • Astrocartography as a lookup rather than a map to squint at: astroway_geo_acg computes the lines, astroway_geo_acg_zones answers which lines pass within radiusDeg of one location and how far away each is, astroway_geo_acg_categories is the reference taxonomy of 19 areas of life with a weight and polarity per line, and astroway_geo_parans returns every place two planets were simultaneously angular.
  • Sky events delivered instead of polled: astroway_webhooks_subscribe registers a URL for report-ready, transit-alert and eclipse-alert deliveries and hands back a signing_secret for verifying the X-AstroWay-Signature header; astroway_webhooks_retrograde_start, astroway_webhooks_sign_ingress and astroway_webhooks_eclipse_alert register the ephemeris triggers, and astroway_webhooks_webhooks lists what is currently subscribed.
  • Branding that is verified rather than assumed: astroway_whitelabel_config holds logo, colour palette, font, footer text and custom domain, and astroway_whitelabel_domain_verify checks the custom domain's CNAME against api.astroway.info and, when only A records resolve, returns them with a hint to switch.
  • Output in the reader's language: astroway_content_localization_translate_astro pins an astrology glossary while translating, translate_batch takes a set of strings under one target language and domain, and translate_languages lists the supported codes at no credit cost.
  • Two ways to keep the catalogue from swamping a context window: register only the groups you use — western, vedic, tarot, numerology, human design, relational, prognostics, horary, geo, chinese, bazi and more — or switch on discovery mode, which exposes a search tool and a dispatch tool and reaches everything else through them.

Requirements

An ASTROWAY_API_KEY. The free plan needs no card and comes with a monthly credit allowance; a sandbox key returns deterministic responses free, which is the right thing to develop against. Pricing is per endpoint, from 5 to 500 credits depending on which one, and the figure is printed inside each tool's own description. Serving reports from your own domain additionally requires a domain whose CNAME you can point at api.astroway.info. The server sends no telemetry: the only traffic it originates is the API calls you asked for.

Setup effort

One command plus a key — npx @astroway/mcp, then supply credentials

See installation options