post_astrology_solar_return
ActiveTool of Western Astrology MCP Server by RoxyAPI
Generate a solar return chart for any year, the foundational technique for annual astrological forecasting. The chart is cast for the exact moment the transiting Sun returns to its natal ecliptic longitude (your astrological birthday). Returns full tropical zodiac chart with planetary positions, house cusps, aspects, Ascendant, and Midheaven. Location-sensitive: relocating your solar return chart to a different city changes the houses and Ascendant. Solar return chart API, annual horoscope forecast, birthday chart calculator, yearly astrology prediction, relocated solar return.
Parameters schema
{
"type": "object",
"required": [
"birthDate",
"birthTime",
"returnYear",
"latitude",
"longitude",
"timezone"
],
"properties": {
"lang": {
"enum": [
"en",
"tr",
"de",
"es",
"hi",
"pt",
"fr",
"ru"
],
"type": "string",
"default": "en",
"example": "en",
"description": "Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English."
},
"compact": {
"type": "boolean",
"default": false,
"description": "Set true to receive the exact same data in a token-optimized shape that is cheaper for you to read: whitespace is stripped and every array of same-shaped objects is encoded columnar as {\"__cols\":[field names],\"__rows\":[[values]]}, so each field name is sent once instead of once per row. Fully lossless (no field or value is dropped or changed) and typically 40 to 52 percent fewer tokens on large results. Prefer true whenever token or inference cost matters. Default false returns standard indented JSON."
},
"latitude": {
"type": "number",
"example": 40.7128,
"maximum": 90,
"minimum": -90,
"description": "Latitude of the solar return location in decimal degrees (-90 to 90). Use current residence or travel location at time of birthday. Solar return charts are location-sensitive."
},
"timezone": {
"anyOf": [
{
"type": "number",
"maximum": 14,
"minimum": -14
},
{
"type": "string"
}
],
"example": -5,
"description": "Decimal hours from UTC OR IANA name (e.g. \"America/New_York\"). IANA resolved to the DST-correct offset for the birthDate. Output datetime is adjusted to this timezone."
},
"birthDate": {
"type": "string",
"format": "date",
"example": "1990-07-15",
"description": "Original birth date in YYYY-MM-DD format. Used to determine natal Sun longitude for the solar return calculation."
},
"birthTime": {
"type": "string",
"format": "time",
"example": "14:30:00",
"description": "Original birth time in 24-hour HH:MM:SS format. Determines exact natal Sun position for annual return timing."
},
"longitude": {
"type": "number",
"example": -74.006,
"maximum": 180,
"minimum": -180,
"description": "Longitude of the solar return location in decimal degrees (-180 to 180). Affects house cusps and Ascendant of the return chart."
},
"returnYear": {
"type": "integer",
"example": 2026,
"description": "Year for which to cast the solar return chart. The chart is erected for the exact moment the transiting Sun conjuncts the natal Sun longitude in this year."
},
"houseSystem": {
"enum": [
"placidus",
"whole-sign",
"equal",
"koch"
],
"type": "string",
"default": "placidus",
"example": "placidus",
"description": "House system for the solar return chart. Placidus (default) is most common in Western astrology. Whole Sign, Equal, and Koch also supported."
}
}
}Parent server
Western Astrology MCP Server by RoxyAPI
1/7 registries