AstroWay Core astrology

info.astroway/core · v0.4.6

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

Website Set it up

Connect Remote server

Terminal

claude mcp add --transport http core https://mcp.astroway.info/mcp/core --header "Authorization: Bearer <YOUR_API_KEY>"

~/.cursor/mcp.json

{
  "mcpServers": {
    "core": {
      "url": "https://mcp.astroway.info/mcp/core",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "core": {
      "type": "http",
      "url": "https://mcp.astroway.info/mcp/core",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

Claude Desktop

Settings > Connectors > Add custom connector
URL: https://mcp.astroway.info/mcp/core

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools 80 found in our last check

astroway_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
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.
astroway_geo_acg
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)]
astroway_geo_acg_best_places
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…
astroway_geo_acg_by_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)]
astroway_geo_acg_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 publi…
astroway_geo_acg_countries
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 ½)]
astroway_geo_acg_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/…
astroway_geo_acg_zones
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)]
astroway_agent_tools
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`…
astroway_mcp_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…
astroway_mcp_ai_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)]
astroway_mcp_ai_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)]
astroway_mcp_ai_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)]
astroway_calendar_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)]
astroway_calendar_algol_minimum_nearest
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)]
astroway_dignities_almuten
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)]
astroway_aspects_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)]
astroway_aspects_arabic_parts
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)]
astroway_aspects_aspect_bar
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] [Co…
astroway_aspects_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)]
astroway_calendar_aspects
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/…
astroway_geo_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)]
astroway_western_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 time…
astroway_calendar_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)]
astroway_dignities_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)]
astroway_dignities_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)]
astroway_geo_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)]
astroway_calendar_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)]
astroway_western_ephemeris
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)]
astroway_dignities_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)]
astroway_aspects_fixed_stars
Positions of fixed stars at the birth moment (36 classic stars, or the names in `stars`), and the conjunctions of natal planets with them within `orb` degrees (default 1, at most 5), closest first. [Group: Aspects & Points] [Endpoint: POST /v1/fixed-stars] [Required: date, time,…
astroway_aspects_fixed_stars_catalog
The star names this API accepts, from our fixed-star catalogue (953 stars): 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. [G…
astroway_aspects_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)]
astroway_geo_reverse
The populated place nearest to a point, by great-circle distance over the same list as /geo/search, and the IANA zone of the point itself (which near a border can differ from the place's). Works across the antimeridian and at the poles. At sea `timezone` is the nautical hour ban…
astroway_geo_search
A place name to candidates with coordinates and the IANA zone, for a birthplace field. Matches a prefix, ignores case, accents and punctuation (`krakow` finds Kraków, `St. Petersburg` finds Saint Petersburg), and knows the names GeoNames carries in our 21 languages and older one…
astroway_geo_timezone
The IANA zone at a point and the UTC offset its clocks kept at that local date and time, from the tz database, never a fixed offset: Kyiv answers +2 in January, +3 in July and +4 on 15 May 1990, when it kept Moscow summer time. `time` defaults to 12:00 and matters on the day clo…
astroway_geo_geodetic
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)]
astroway_horoscope_compatibility
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)]
astroway_horoscope_daily
Daily horoscope for a zodiac sign in 21 languages, written by a model from that sign's solar houses and the day's transits. `style: "plain"` gives everyday words with no astrological terms, written once in English and translated so every language says the same; `length` (short,…
astroway_horoscope_monthly
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)]
astroway_horoscope_weekly
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)]
astroway_horoscope_yearly
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)]
astroway_calendar_houses
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…
astroway_dignities_hyleg
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)]
astroway_calendar_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)]
astroway_geo_local_space
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)]
astroway_geo_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 cre…
astroway_calendar_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)]
astroway_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)]
astroway_mcp_agent_pool_status
8 personas with specialties. [Group: MCP Advanced] [Endpoint: GET /v1/mcp/agent-pool-status] [Cost: 10 credits (Tier 1)]
astroway_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)]
astroway_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)]
astroway_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)]
astroway_mcp_streaming
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)]
astroway_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)]
astroway_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]
astroway_aspects_midpoint_trees
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)]
astroway_aspects_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)]
astroway_calendar_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)]
astroway_calendar_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…
astroway_calendar_moon_voc
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)]
astroway_reference_natal_texts
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 d…
astroway_aspects_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)]
astroway_geo_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)]
astroway_geo_parans_star
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 ascensio…
astroway_geo_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)]
astroway_calendar_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)]
astroway_calendar_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…
astroway_calendar_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 (Ti…
astroway_western_planets
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)]
astroway_dignities_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)]
astroway_geo_relocation
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)]
astroway_render_aspect_grid
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)]
astroway_render_bi_wheel
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)]
astroway_render_biorhythm
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)]
astroway_render_composite
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)]
astroway_render_cosmogram
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)]
astroway_render_eclipse_path
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)]
astroway_render_moon_phase
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)]

Headers

Name	Description
`Authorization` Required, secret	Bearer followed by your AstroWay API key (aw_live_* or aw_test_*), from api.astroway.info/dashboard

Details

Endpoint	`https://mcp.astroway.info/mcp/core` (Streamable HTTP)
First published	1 Nov 2026
Last updated	1 Nov 2026
Registry name	`info.astroway/core`

More data and analytics servers See all

Live status

Live

Typical response: 478 ms
Answered: 100% of 2 checks
Last check: 13 Nov 2026

30 days agoToday

We connect daily without credentials and run initialize and tools/list.

Pair it with live search

Agents that use AstroWay Core astrology often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/info-astroway-core/badge.svg)](https://nestdaddy.com/mcp/servers/info-astroway-core)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.