astroway-mcp

Official

by astroway

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

Aspect Grid (SVG)

astroway_render_aspect_grid

Read-onlyIdempotent

Renders a triangular aspect grid from natal chart data, showing planet-to-planet aspects with glyphs and orbs in a standard textbook matrix for visual analysis.

Instructions

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)]

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "body": "<body>"
    },
    "name": "astroway_render_aspect_grid"
  }
}

Input Schema

Name	Required	Description	Default
`body`	Yes

Output Schema

Name	Required	Description	Default
`svg`	No
`format`	No
`byteLength`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv1.6.1Nov 9, 2026

changedInput schema / properties / body / anyOf

Previous value: -[
-  {
-    "allOf": [
-      {
-        "additionalProperties": {
-          "anyOf": [
-            {},
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "description": "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; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
-        "properties": {
-          "ayanamsa": {
-            "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.",
-            "enum": [
-              "fagan-bradley",
-              "lahiri",
-              "de-luce",
-              "raman",
-              "krishnamurti",
-              "kp",
-              "yukteshwar",
-              "jn-bhasin",
-              "true-citra",
-              "djwhal-khul"
-            ],
-            "type": "string"
-          },
-          "ayanamsaId": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "city": {
-            "default": "",
-            "type": "string"
-          },
-          "cosmogram": {
-            "type": "boolean"
-          },
-          "date": {
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "type": "string"
-          },
-          "houseSystem": {
-            "default": "P",
-            "enum": [
-              "P",
-              "K",
-              "R",
-              "C",
-              "E",
-              "W",
-              "B",
-              "M",
-              "O",
-              "A",
-              "T",
-              "V",
-              "D",
-              "F",
-              "G",
-              "H",
-              "I",
-              "i",
-              "L",
-              "N",
-              "Q",
-              "S",
-              "U",
-              "X",
-              "Y"
-            ],
-            "type": "string"
-          },
-          "latitude": {
-            "maximum": 90,
-            "minimum": -90,
-            "type": "number"
-          },
-          "longitude": {
-            "maximum": 180,
-            "minimum": -180,
-            "type": "number"
-          },
-          "name": {
-            "default": "",
-            "type": "string"
-          },
-          "time": {
-            "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$",
-            "type": "string"
-          },
-          "timezone": {
-            "description": "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 in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.",
-            "type": "string"
-          },
-          "timezoneOffset": {
-            "anyOf": [
-              {
-                "maximum": 14,
-                "minimum": -14,
-                "type": "number"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "default": 0,
-            "description": "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."
-          },
-          "zodiacType": {
-            "enum": [
-              "tropical",
-              "sidereal"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "date",
-          "time",
-          "latitude",
-          "longitude"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": {
-          "anyOf": [
-            {},
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "properties": {
-          "options": {
-            "properties": {
-              "bodies": {
-                "items": {
-                  "enum": [
-                    "Sun",
-                    "Moon",
-                    "Mercury",
-                    "Venus",
-                    "Mars",
-                    "Jupiter",
-                    "Saturn",
-                    "Uranus",
-                    "Neptune",
-                    "Pluto",
-                    "North Node",
-                    "South Node",
-                    "Chiron",
-                    "Lilith"
-                  ],
-                  "type": "string"
-                },
-                "maxItems": 14,
-                "minItems": 1,
-                "type": "array"
-              },
-              "format": {
-                "default": "json",
-                "enum": [
-                  "svg",
-                  "json"
-                ],
-                "type": "string"
-              },
-              "labels": {
-                "additionalProperties": false,
-                "description": "Your own words in place of the English the image would otherwise carry: the ASC/DSC/MC/IC axis labels, the SVG <title> and <desc> read by screen readers, and the planet and sign names plus the word for retrograde in each planet's data-label (theme css). bodies is keyed by the English name, signs lists twelve names from Aries. Nothing is translated for you; absent keys keep the English.",
-                "properties": {
-                  "asc": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "bodies": {
-                    "properties": {
-                      "Chiron": {
-                        "maxLength": 40,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "Jupiter": {
-                        "maxLength": 40,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "Lilith": {
-                        "maxLength": 40,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "Mars": {
-                        "maxLength": 40,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "Mercury": {
-                        "maxLength": 40,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "Moon": {
-                        "maxLength": 40,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "Neptune": {
-                        "maxLength": 40,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "North Node": {
-                        "maxLength": 40,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "Pluto": {
-                        "maxLength": 40,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "Saturn": {
-                        "maxLength": 40,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "South Node": {
-                        "maxLength": 40,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "Sun": {
-                        "maxLength": 40,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "Uranus": {
-                        "maxLength": 40,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "Venus": {
-                        "maxLength": 40,
-                        "minLength": 1,
-                        "type": "string"
-                      }
-                    },
-                    "type": "object"
-                  },
-                  "desc": {
-                    "maxLength": 2000,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "dsc": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "ic": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "mc": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "retrograde": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "signs": {
-                    "items": {
-                      "maxLength": 40,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  "title": {
-                    "maxLength": 200,
-                    "minLength": 1,
-                    "type": "string"
-                  }
-                },
-                "type": "object"
-              },
-              "showAspects": {
-                "type": "boolean"
-              },
-              "showRetrograde": {
-                "type": "boolean"
-              },
-              "size": {
-                "maximum": 2000,
-                "minimum": 200,
-                "type": "integer"
-              },
-              "theme": {
-                "description": "css paints every colour as var(--aw-<role>, <light colour>), so the page that inlines the SVG can recolour it with CSS custom properties (--aw-chart-bg, --aw-fg, --aw-muted, --aw-ring, --aw-houses-fill, --aw-benefic, --aw-malefic, --aw-aspect-harmonious, --aw-aspect-tense, --aw-aspect-neutral, --aw-aspect-minor, --aw-aspect-quintile, --aw-moon-shadow, --aw-moon-light, --aw-cycle-physical, --aw-cycle-emotional, --aw-cycle-intellectual). With none set it looks exactly like light. Inside an <img> the variables cannot be set, so it stays light. The Western wheels and the aspect grid then also carry stable aw-* classes, and each planet is a <g> with data-planet and data-label, each aspect line has data-a and data-b; see the @astroway/render changelog for the list.",
-                "enum": [
-                  "light",
-                  "dark",
-                  "console",
-                  "css"
-                ],
-                "type": "string"
-              },
-              "title": {
-                "maxLength": 120,
-                "type": "string"
-              }
-            },
-            "type": "object"
-          }
-        },
-        "type": "object"
-      }
-    ],
-    "description": "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; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems."
-  },
-  {
-    "additionalProperties": false,
-    "description": "A chart you already hold, drawn as is: no birth data, 1 credit.",
-    "properties": {
-      "chart": {
-        "additionalProperties": {
-          "anyOf": [
-            {},
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "description": "The data object of a POST /v1/chart response, sent back to be drawn without computing the chart again (1 credit instead of 10). Extra fields are ignored; planets (1 to 30, longitude 0 to 360), houses (exactly 12 cusps, ascendant, mc) and aspects are read.",
-        "properties": {
-          "aspects": {
-            "items": {
-              "additionalProperties": {
-                "anyOf": [
-                  {},
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "properties": {
-                "orb": {
-                  "maximum": 30,
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "planet1": {
-                  "maxLength": 40,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "planet2": {
-                  "maxLength": 40,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "type": {
-                  "anyOf": [
-                    {
-                      "maxLength": 40,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    {
-                      "additionalProperties": {
-                        "anyOf": [
-                          {},
-                          {
-                            "type": "null"
-                          }
-                        ]
-                      },
-                      "properties": {
-                        "name": {
-                          "maxLength": 40,
-                          "minLength": 1,
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "name"
-                      ],
-                      "type": "object"
-                    }
-                  ]
-                }
-              },
-              "required": [
-                "planet1",
-                "planet2",
-                "type"
-              ],
-              "type": "object"
-            },
-            "maxItems": 300,
-            "type": "array"
-          },
-          "houses": {
-            "additionalProperties": {
-              "anyOf": [
-                {},
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "properties": {
-              "ascendant": {
-                "maximum": 360,
-                "minimum": 0,
-                "type": "number"
-              },
-              "cusps": {
-                "items": {
-                  "maximum": 360,
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "type": "array"
-              },
-              "mc": {
-                "maximum": 360,
-                "minimum": 0,
-                "type": "number"
-              }
-            },
-            "required": [
-              "cusps",
-              "ascendant",
-              "mc"
-            ],
-            "type": "object"
-          },
-          "planets": {
-            "items": {
-              "additionalProperties": {
-                "anyOf": [
-                  {},
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "properties": {
-                "id": {
-                  "maximum": 100000,
-                  "minimum": -1,
-                  "type": "integer"
-                },
-                "isRetrograde": {
-                  "type": "boolean"
-                },
-                "longitude": {
-                  "maximum": 360,
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "name": {
-                  "maxLength": 40,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "speedLong": {
-                  "maximum": 30,
-                  "minimum": -30,
-                  "type": "number"
-                }
-              },
-              "required": [
-                "id",
-                "name",
-                "longitude"
-              ],
-              "type": "object"
-            },
-            "maxItems": 30,
-            "minItems": 1,
-            "type": "array"
-          }
-        },
-        "required": [
-          "planets",
-          "houses"
-        ],
-        "type": "object"
-      },
-      "options": {
-        "properties": {
-          "bodies": {
-            "items": {
-              "enum": [
-                "Sun",
-                "Moon",
-                "Mercury",
-                "Venus",
-                "Mars",
-                "Jupiter",
-                "Saturn",
-                "Uranus",
-                "Neptune",
-                "Pluto",
-                "North Node",
-                "South Node",
-                "Chiron",
-                "Lilith"
-              ],
-              "type": "string"
-            },
-            "maxItems": 14,
-            "minItems": 1,
-            "type": "array"
-          },
-          "format": {
-            "default": "json",
-            "enum": [
-              "svg",
-              "json"
-            ],
-            "type": "string"
-          },
-          "labels": {
-            "additionalProperties": false,
-            "description": "Your own words in place of the English the image would otherwise carry: the ASC/DSC/MC/IC axis labels, the SVG <title> and <desc> read by screen readers, and the planet and sign names plus the word for retrograde in each planet's data-label (theme css). bodies is keyed by the English name, signs lists twelve names from Aries. Nothing is translated for you; absent keys keep the English.",
-            "properties": {
-              "asc": {
-                "maxLength": 40,
-                "minLength": 1,
-                "type": "string"
-              },
-              "bodies": {
-                "properties": {
-                  "Chiron": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "Jupiter": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "Lilith": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "Mars": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "Mercury": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "Moon": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "Neptune": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "North Node": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "Pluto": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "Saturn": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "South Node": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "Sun": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "Uranus": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "Venus": {
-                    "maxLength": 40,
-                    "minLength": 1,
-                    "type": "string"
-                  }
-                },
-                "type": "object"
-              },
-              "desc": {
-                "maxLength": 2000,
-                "minLength": 1,
-                "type": "string"
-              },
-              "dsc": {
-                "maxLength": 40,
-                "minLength": 1,
-                "type": "string"
-              },
-              "ic": {
-                "maxLength": 40,
-                "minLength": 1,
-                "type": "string"
-              },
-              "mc": {
-                "maxLength": 40,
-                "minLength": 1,
-                "type": "string"
-              },
-              "retrograde": {
-                "maxLength": 40,
-                "minLength": 1,
-                "type": "string"
-              },
-              "signs": {
-                "items": {
-                  "maxLength": 40,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "title": {
-                "maxLength": 200,
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "showAspects": {
-            "type": "boolean"
-          },
-          "showRetrograde": {
-            "type": "boolean"
-          },
-          "size": {
-            "maximum": 2000,
-            "minimum": 200,
-            "type": "integer"
-          },
-          "theme": {
-            "description": "css paints every colour as var(--aw-<role>, <light colour>), so the page that inlines the SVG can recolour it with CSS custom properties (--aw-chart-bg, --aw-fg, --aw-muted, --aw-ring, --aw-houses-fill, --aw-benefic, --aw-malefic, --aw-aspect-harmonious, --aw-aspect-tense, --aw-aspect-neutral, --aw-aspect-minor, --aw-aspect-quintile, --aw-moon-shadow, --aw-moon-light, --aw-cycle-physical, --aw-cycle-emotional, --aw-cycle-intellectual). With none set it looks exactly like light. Inside an <img> the variables cannot be set, so it stays light. The Western wheels and the aspect grid then also carry stable aw-* classes, and each planet is a <g> with data-planet and data-label, each aspect line has data-a and data-b; see the @astroway/render changelog for the list.",
-            "enum": [
-              "light",
-              "dark",
-              "console",
-              "css"
-            ],
-            "type": "string"
-          },
-          "title": {
-            "maxLength": 120,
-            "type": "string"
-          }
-        },
-        "type": "object"
-      }
-    },
-    "required": [
-      "chart"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "allOf": [
+      {
+        "additionalProperties": {
+          "anyOf": [
+            {},
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "description": "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; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single house-system letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
+        "properties": {
+          "ayanamsa": {
+            "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.",
+            "enum": [
+              "fagan-bradley",
+              "lahiri",
+              "de-luce",
+              "raman",
+              "krishnamurti",
+              "kp",
+              "yukteshwar",
+              "jn-bhasin",
+              "true-citra",
+              "djwhal-khul"
+            ],
+            "type": "string"
+          },
+          "ayanamsaId": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "city": {
+            "default": "",
+            "type": "string"
+          },
+          "cosmogram": {
+            "type": "boolean"
+          },
+          "date": {
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          },
+          "houseSystem": {
+            "default": "P",
+            "enum": [
+              "P",
+              "K",
+              "R",
+              "C",
+              "E",
+              "W",
+              "B",
+              "M",
+              "O",
+              "A",
+              "T",
+              "V",
+              "D",
+              "F",
+              "G",
+              "H",
+              "I",
+              "i",
+              "L",
+              "N",
+              "Q",
+              "S",
+              "U",
+              "X",
+              "Y"
+            ],
+            "type": "string"
+          },
+          "latitude": {
+            "maximum": 90,
+            "minimum": -90,
+            "type": "number"
+          },
+          "longitude": {
+            "maximum": 180,
+            "minimum": -180,
+            "type": "number"
+          },
+          "name": {
+            "default": "",
+            "type": "string"
+          },
+          "time": {
+            "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$",
+            "type": "string"
+          },
+          "timezone": {
+            "description": "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 in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.",
+            "type": "string"
+          },
+          "timezoneOffset": {
+            "anyOf": [
+              {
+                "maximum": 14,
+                "minimum": -14,
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": 0,
+            "description": "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."
+          },
+          "zodiacType": {
+            "enum": [
+              "tropical",
+              "sidereal"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "date",
+          "time",
+          "latitude",
+          "longitude"
+        ],
+        "type": "object"
+      },
+      {
+        "additionalProperties": {
+          "anyOf": [
+            {},
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "properties": {
+          "options": {
+            "properties": {
+              "bodies": {
+                "items": {
+                  "enum": [
+                    "Sun",
+                    "Moon",
+                    "Mercury",
+                    "Venus",
+                    "Mars",
+                    "Jupiter",
+                    "Saturn",
+                    "Uranus",
+                    "Neptune",
+                    "Pluto",
+                    "North Node",
+                    "South Node",
+                    "Chiron",
+                    "Lilith"
+                  ],
+                  "type": "string"
+                },
+                "maxItems": 14,
+                "minItems": 1,
+                "type": "array"
+              },
+              "format": {
+                "default": "json",
+                "enum": [
+                  "svg",
+                  "json"
+                ],
+                "type": "string"
+              },
+              "labels": {
+                "additionalProperties": false,
+                "description": "Your own words in place of the English the image would otherwise carry: the ASC/DSC/MC/IC axis labels, the SVG <title> and <desc> read by screen readers, and the planet and sign names plus the word for retrograde in each planet's data-label (theme css). bodies is keyed by the English name, signs lists twelve names from Aries. Nothing is translated for you; absent keys keep the English.",
+                "properties": {
+                  "asc": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "bodies": {
+                    "properties": {
+                      "Chiron": {
+                        "maxLength": 40,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "Jupiter": {
+                        "maxLength": 40,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "Lilith": {
+                        "maxLength": 40,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "Mars": {
+                        "maxLength": 40,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "Mercury": {
+                        "maxLength": 40,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "Moon": {
+                        "maxLength": 40,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "Neptune": {
+                        "maxLength": 40,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "North Node": {
+                        "maxLength": 40,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "Pluto": {
+                        "maxLength": 40,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "Saturn": {
+                        "maxLength": 40,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "South Node": {
+                        "maxLength": 40,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "Sun": {
+                        "maxLength": 40,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "Uranus": {
+                        "maxLength": 40,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "Venus": {
+                        "maxLength": 40,
+                        "minLength": 1,
+                        "type": "string"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "desc": {
+                    "maxLength": 2000,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "dsc": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "ic": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "mc": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "retrograde": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "signs": {
+                    "items": {
+                      "maxLength": 40,
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "title": {
+                    "maxLength": 200,
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "showAspects": {
+                "type": "boolean"
+              },
+              "showRetrograde": {
+                "type": "boolean"
+              },
+              "size": {
+                "maximum": 2000,
+                "minimum": 200,
+                "type": "integer"
+              },
+              "theme": {
+                "description": "css paints every colour as var(--aw-<role>, <light colour>), so the page that inlines the SVG can recolour it with CSS custom properties (--aw-chart-bg, --aw-fg, --aw-muted, --aw-ring, --aw-houses-fill, --aw-benefic, --aw-malefic, --aw-aspect-harmonious, --aw-aspect-tense, --aw-aspect-neutral, --aw-aspect-minor, --aw-aspect-quintile, --aw-moon-shadow, --aw-moon-light, --aw-cycle-physical, --aw-cycle-emotional, --aw-cycle-intellectual). With none set it looks exactly like light. Inside an <img> the variables cannot be set, so it stays light. The Western wheels and the aspect grid then also carry stable aw-* classes, and each planet is a <g> with data-planet and data-label, each aspect line has data-a and data-b; see the @astroway/render changelog for the list.",
+                "enum": [
+                  "light",
+                  "dark",
+                  "console",
+                  "css"
+                ],
+                "type": "string"
+              },
+              "title": {
+                "maxLength": 120,
+                "type": "string"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      }
+    ],
+    "description": "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; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single house-system letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems."
+  },
+  {
+    "additionalProperties": false,
+    "description": "A chart you already hold, drawn as is: no birth data, 1 credit.",
+    "properties": {
+      "chart": {
+        "additionalProperties": {
+          "anyOf": [
+            {},
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "description": "The data object of a POST /v1/chart response, sent back to be drawn without computing the chart again (1 credit instead of 10). Extra fields are ignored; planets (1 to 30, longitude 0 to 360), houses (exactly 12 cusps, ascendant, mc) and aspects are read.",
+        "properties": {
+          "aspects": {
+            "items": {
+              "additionalProperties": {
+                "anyOf": [
+                  {},
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "properties": {
+                "orb": {
+                  "maximum": 30,
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "planet1": {
+                  "maxLength": 40,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "planet2": {
+                  "maxLength": 40,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": {
+                  "anyOf": [
+                    {
+                      "maxLength": 40,
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    {
+                      "additionalProperties": {
+                        "anyOf": [
+                          {},
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "properties": {
+                        "name": {
+                          "maxLength": 40,
+                          "minLength": 1,
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "name"
+                      ],
+                      "type": "object"
+                    }
+                  ]
+                }
+              },
+              "required": [
+                "planet1",
+                "planet2",
+                "type"
+              ],
+              "type": "object"
+            },
+            "maxItems": 300,
+            "type": "array"
+          },
+          "houses": {
+            "additionalProperties": {
+              "anyOf": [
+                {},
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "properties": {
+              "ascendant": {
+                "maximum": 360,
+                "minimum": 0,
+                "type": "number"
+              },
+              "cusps": {
+                "items": {
+                  "maximum": 360,
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "type": "array"
+              },
+              "mc": {
+                "maximum": 360,
+                "minimum": 0,
+                "type": "number"
+              }
+            },
+            "required": [
+              "cusps",
+              "ascendant",
+              "mc"
+            ],
+            "type": "object"
+          },
+          "planets": {
+            "items": {
+              "additionalProperties": {
+                "anyOf": [
+                  {},
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "properties": {
+                "id": {
+                  "maximum": 100000,
+                  "minimum": -1,
+                  "type": "integer"
+                },
+                "isRetrograde": {
+                  "type": "boolean"
+                },
+                "longitude": {
+                  "maximum": 360,
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "name": {
+                  "maxLength": 40,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "speedLong": {
+                  "maximum": 30,
+                  "minimum": -30,
+                  "type": "number"
+                }
+              },
+              "required": [
+                "id",
+                "name",
+                "longitude"
+              ],
+              "type": "object"
+            },
+            "maxItems": 30,
+            "minItems": 1,
+            "type": "array"
+          }
+        },
+        "required": [
+          "planets",
+          "houses"
+        ],
+        "type": "object"
+      },
+      "options": {
+        "properties": {
+          "bodies": {
+            "items": {
+              "enum": [
+                "Sun",
+                "Moon",
+                "Mercury",
+                "Venus",
+                "Mars",
+                "Jupiter",
+                "Saturn",
+                "Uranus",
+                "Neptune",
+                "Pluto",
+                "North Node",
+                "South Node",
+                "Chiron",
+                "Lilith"
+              ],
+              "type": "string"
+            },
+            "maxItems": 14,
+            "minItems": 1,
+            "type": "array"
+          },
+          "format": {
+            "default": "json",
+            "enum": [
+              "svg",
+              "json"
+            ],
+            "type": "string"
+          },
+          "labels": {
+            "additionalProperties": false,
+            "description": "Your own words in place of the English the image would otherwise carry: the ASC/DSC/MC/IC axis labels, the SVG <title> and <desc> read by screen readers, and the planet and sign names plus the word for retrograde in each planet's data-label (theme css). bodies is keyed by the English name, signs lists twelve names from Aries. Nothing is translated for you; absent keys keep the English.",
+            "properties": {
+              "asc": {
+                "maxLength": 40,
+                "minLength": 1,
+                "type": "string"
+              },
+              "bodies": {
+                "properties": {
+                  "Chiron": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "Jupiter": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "Lilith": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "Mars": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "Mercury": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "Moon": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "Neptune": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "North Node": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "Pluto": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "Saturn": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "South Node": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "Sun": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "Uranus": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "Venus": {
+                    "maxLength": 40,
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "desc": {
+                "maxLength": 2000,
+                "minLength": 1,
+                "type": "string"
+              },
+              "dsc": {
+                "maxLength": 40,
+                "minLength": 1,
+                "type": "string"
+              },
+              "ic": {
+                "maxLength": 40,
+                "minLength": 1,
+                "type": "string"
+              },
+              "mc": {
+                "maxLength": 40,
+                "minLength": 1,
+                "type": "string"
+              },
+              "retrograde": {
+                "maxLength": 40,
+                "minLength": 1,
+                "type": "string"
+              },
+              "signs": {
+                "items": {
+                  "maxLength": 40,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "title": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "showAspects": {
+            "type": "boolean"
+          },
+          "showRetrograde": {
+            "type": "boolean"
+          },
+          "size": {
+            "maximum": 2000,
+            "minimum": 200,
+            "type": "integer"
+          },
+          "theme": {
+            "description": "css paints every colour as var(--aw-<role>, <light colour>), so the page that inlines the SVG can recolour it with CSS custom properties (--aw-chart-bg, --aw-fg, --aw-muted, --aw-ring, --aw-houses-fill, --aw-benefic, --aw-malefic, --aw-aspect-harmonious, --aw-aspect-tense, --aw-aspect-neutral, --aw-aspect-minor, --aw-aspect-quintile, --aw-moon-shadow, --aw-moon-light, --aw-cycle-physical, --aw-cycle-emotional, --aw-cycle-intellectual). With none set it looks exactly like light. Inside an <img> the variables cannot be set, so it stays light. The Western wheels and the aspect grid then also carry stable aw-* classes, and each planet is a <g> with data-planet and data-label, each aspect line has data-a and data-b; see the @astroway/render changelog for the list.",
+            "enum": [
+              "light",
+              "dark",
+              "console",
+              "css"
+            ],
+            "type": "string"
+          },
+          "title": {
+            "maxLength": 120,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "required": [
+      "chart"
+    ],
+    "type": "object"
+  }
+]

Addedv1.6.0Oct 24, 2026

TDQS

B3/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish that this is a read-only, idempotent, non-destructive, closed-world render operation. The description adds useful visual context (triangular matrix, glyph plus orb per cell) and a credit tier, but its 'Cost: 10 credits' line omits the cheaper 1-credit path when a precomputed chart is supplied, which is a meaningful behavioral gap for callers.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is tightly front-loaded: the first sentence explains the rendered layout, and the bracketed metadata lines are compact. It contains little waste, though 'Standard textbook layout' is mildly redundant and the cost metadata is incomplete.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With a rich nested input schema, a defined output schema, and safety annotations, the description can rely on structured fields for much of the detail. Still, for a complex render tool with two distinct accepted body shapes and a 10-credit versus 1-credit distinction, the description is thin and should at least acknowledge the dual input modes.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage for the single top-level body parameter is reported as 0%, and the description does not compensate: it never mentions that body accepts either birth data or a precomputed chart, nor does it explain the differing credit cost between those modes. The visual-layout sentence describes the output, not the input semantics.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific visualization artifact: a triangular aspect matrix with planets on rows and columns and aspect glyph plus orb in each cell. That is clear enough to identify the tool, but it does not explicitly distinguish this natal-style grid from sibling grid or wheel tools such as astroway_relational_synastry_aspect_grid.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no when-to-use guidance, no exclusions, and no named alternatives. It does not say whether to choose this grid over the Western wheel, aspect bar, timeline, or synastry aspect grid, so the agent must infer routing from the tool name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server