Western Planetary Return
asterwise_get_western_planetary_return
Next return chart for any planet after a given date. Finds the exact moment the specified planet returns to its natal tropical longitude and builds a complete Western natal chart for that moment at the birth location.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
birth | object | yes | Birth data for Western astrology tools (tropical zodiac). Fields: date, time, lat, lon, person_name, timezone, house_system |
planet | string | yes | |
response_format | enum: markdown, json | no | |
after_date | string/null | no |
What it covers
Generalised return for any of the 10 classical tropical bodies — Mercury returns (yearly-ish), Venus (~1 year), Mars (~2 years), Jupiter (~12 years), Saturn (~29 years), through Pluto (~248 years).
Workflow
BEFORE: asterwise_get_western_natal.
AFTER: None.
Input
birth — WesternBirthData.
planet — one of Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto.
after_date (optional YYYY-MM-DD) — defaults to today.
Output contract
Same shape as solar return: planet name, natal_longitude, return_utc, return_jd, chart
Response format
response_format=json serialises the complete response as indented JSON.
response_format=markdown renders the same data as a human-readable report.
Both modes return identical underlying data.
Compute class
SLOW_COMPUTE for outer planets (Jupiter+ return can search years ahead)
Errors
INVALID_PARAMS (local):
planet not in the valid 10-planet set → MCP INVALID_PARAMS locally.
INTERNAL_ERROR: Any upstream API failure or timeout → MCP INTERNAL_ERROR
Edge cases:
Neptune return takes ~165 years — only useful for generational analysis, not individual lifetime prediction. Pluto return: ~248 years, never completes in one lifetime.
Do not confuse with
asterwise_get_western_solar_return — Sun-only shortcut.
asterwise_get_western_lunar_return — Moon-only shortcut.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.