@oomol-lab/open-connector 1.8.0 → 1.9.0

package/assets/open-connector/catalog/apps/freeastroapi.json

@@ -0,0 +1,2986 @@
+{
+  "service": "freeastroapi",
+  "displayName": "FreeAstroAPI",
+  "homepageUrl": "https://www.freeastroapi.com/",
+  "iconUrl": "https://www.freeastroapi.com/favicon.svg",
+  "categories": [
+    "Data & Analytics"
+  ],
+  "authTypes": [
+    "api_key"
+  ],
+  "auth": [
+    {
+      "type": "api_key",
+      "label": "API Key",
+      "placeholder": "FREE_ASTRO_API_KEY",
+      "description": "FreeAstroAPI key sent in the x-api-key header. Obtain it from the API Key section of your dashboard: https://www.freeastroapi.com/dashboard"
+    }
+  ],
+  "actions": [
+    {
+      "id": "freeastroapi.analyze_bazi_constitution",
+      "service": "freeastroapi",
+      "name": "analyze_bazi_constitution",
+      "description": "Analyze traditional BaZi and TCM constitution tendencies and timing patterns; this is not medical advice, diagnosis, or treatment.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "year": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Year of birth or the date to calculate."
+          },
+          "month": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 12,
+            "description": "Month number."
+          },
+          "day": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 31,
+            "description": "Day of month."
+          },
+          "hour": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 23,
+            "description": "Local clock hour. Defaults to 12."
+          },
+          "minute": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 59,
+            "description": "Local clock minute. Defaults to 0."
+          },
+          "city": {
+            "anyOf": [
+              {
+                "type": "string",
+                "minLength": 1,
+                "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+          },
+          "latitude": {
+            "anyOf": [
+              {
+                "type": "number",
+                "minimum": -90,
+                "maximum": 90,
+                "description": "Latitude in degrees."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Latitude in degrees."
+          },
+          "longitude": {
+            "anyOf": [
+              {
+                "type": "number",
+                "minimum": -180,
+                "maximum": 180,
+                "description": "Longitude in degrees."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Longitude in degrees."
+          },
+          "sex": {
+            "type": "string",
+            "enum": [
+              "M",
+              "F"
+            ],
+            "description": "Sex used for traditional luck-cycle direction rules. Defaults to M."
+          },
+          "includeTiming": {
+            "type": "boolean",
+            "description": "Include decade and annual timing windows. Defaults to true."
+          },
+          "timingYearsAhead": {
+            "type": "integer",
+            "description": "Number of years ahead to analyze. Defaults to 10."
+          },
+          "language": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Response language. Defaults to en; use zh-CN for Simplified Chinese."
+          },
+          "idempotencyKey": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional idempotency key. Reuse only when retrying the exact same POST request after a network failure."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "year",
+          "month",
+          "day"
+        ],
+        "description": "Traditional constitution analysis input.",
+        "anyOf": [
+          {
+            "description": "Resolve the location from a city.",
+            "required": [
+              "city"
+            ],
+            "properties": {
+              "city": {
+                "type": "string",
+                "minLength": 1,
+                "description": "A non-empty city name.",
+                "pattern": "\\S"
+              }
+            }
+          },
+          {
+            "description": "Use explicit geographic coordinates.",
+            "required": [
+              "latitude",
+              "longitude"
+            ],
+            "properties": {
+              "latitude": {
+                "type": "number",
+                "description": "Explicit latitude."
+              },
+              "longitude": {
+                "type": "number",
+                "description": "Explicit longitude."
+              }
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "analysis": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Complete traditional constitution analysis, including the upstream disclaimer and model transparency fields."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "analysis"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.calculate_bazi",
+      "service": "freeastroapi",
+      "name": "calculate_bazi",
+      "description": "Calculate a complete BaZi chart with four pillars, Day Master, Ten Gods, luck cycles, and optional professional analysis.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "year": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Year of birth or the date to calculate."
+          },
+          "month": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 12,
+            "description": "Month number."
+          },
+          "day": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 31,
+            "description": "Day of month."
+          },
+          "hour": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 23,
+            "description": "Local clock hour. Defaults to 12."
+          },
+          "minute": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 59,
+            "description": "Local clock minute. Defaults to 0."
+          },
+          "city": {
+            "anyOf": [
+              {
+                "type": "string",
+                "minLength": 1,
+                "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+          },
+          "latitude": {
+            "anyOf": [
+              {
+                "type": "number",
+                "minimum": -90,
+                "maximum": 90,
+                "description": "Latitude in degrees."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Latitude in degrees."
+          },
+          "longitude": {
+            "anyOf": [
+              {
+                "type": "number",
+                "minimum": -180,
+                "maximum": 180,
+                "description": "Longitude in degrees."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Longitude in degrees."
+          },
+          "timezone": {
+            "anyOf": [
+              {
+                "type": "string",
+                "minLength": 1,
+                "description": "IANA timezone or AUTO. Defaults to AUTO and resolves historical offsets from the location."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "IANA timezone or AUTO. Defaults to AUTO and resolves historical offsets from the location."
+          },
+          "timeStandard": {
+            "type": "string",
+            "enum": [
+              "civil",
+              "true_solar",
+              "true_solar_absolute"
+            ],
+            "description": "Time standard: civil clock time, relative true solar time, or absolute true solar time. Defaults to civil."
+          },
+          "calendar": {
+            "type": "string",
+            "enum": [
+              "gregorian",
+              "julian"
+            ],
+            "description": "Calendar used for the supplied date. Defaults to gregorian."
+          },
+          "sex": {
+            "type": "string",
+            "enum": [
+              "M",
+              "F"
+            ],
+            "description": "Sex used for traditional luck-cycle direction rules. Defaults to M."
+          },
+          "includeTenGods": {
+            "type": "boolean",
+            "description": "Include Ten Gods. Defaults to true."
+          },
+          "includePinyin": {
+            "type": "boolean",
+            "description": "Include pinyin. Defaults to true."
+          },
+          "includeStars": {
+            "type": "boolean",
+            "description": "Include symbolic stars. Defaults to true."
+          },
+          "includeInteractions": {
+            "type": "boolean",
+            "description": "Include pillar interactions. Defaults to true."
+          },
+          "includeProfessional": {
+            "type": "boolean",
+            "description": "Include Day Master strength, patterns, and useful elements. Defaults to true."
+          },
+          "includeDebug": {
+            "type": "boolean",
+            "description": "Include calculation debug data. Defaults to true."
+          },
+          "includeCurrentFlow": {
+            "type": "boolean",
+            "description": "Include current annual flow triggers. Defaults to false."
+          },
+          "language": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Response language. Defaults to en; use zh-CN for Simplified Chinese."
+          },
+          "idempotencyKey": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional idempotency key. Reuse only when retrying the exact same POST request after a network failure."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "year",
+          "month",
+          "day"
+        ],
+        "description": "Complete birth data and BaZi calculation options.",
+        "anyOf": [
+          {
+            "description": "Resolve the location from a city.",
+            "required": [
+              "city"
+            ],
+            "properties": {
+              "city": {
+                "type": "string",
+                "minLength": 1,
+                "description": "A non-empty city name.",
+                "pattern": "\\S"
+              }
+            }
+          },
+          {
+            "description": "Use explicit geographic coordinates.",
+            "required": [
+              "latitude",
+              "longitude"
+            ],
+            "properties": {
+              "latitude": {
+                "type": "number",
+                "description": "Explicit latitude."
+              },
+              "longitude": {
+                "type": "number",
+                "description": "Explicit longitude."
+              }
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "chart": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Complete BaZi chart returned by FreeAstroAPI, including optional and future fields."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "chart"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.calculate_bazi_flow",
+      "service": "freeastroapi",
+      "name": "calculate_bazi_flow",
+      "description": "Calculate annual and monthly BaZi flow pillars, interactions, and stars for one prediction year, with optional timezone and solar-time settings.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "year": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Year of birth or the date to calculate."
+          },
+          "month": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 12,
+            "description": "Month number."
+          },
+          "day": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 31,
+            "description": "Day of month."
+          },
+          "hour": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 23,
+            "description": "Local clock hour. Defaults to 12."
+          },
+          "minute": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 59,
+            "description": "Local clock minute. Defaults to 0."
+          },
+          "city": {
+            "anyOf": [
+              {
+                "type": "string",
+                "minLength": 1,
+                "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+          },
+          "latitude": {
+            "anyOf": [
+              {
+                "type": "number",
+                "minimum": -90,
+                "maximum": 90,
+                "description": "Latitude in degrees."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Latitude in degrees."
+          },
+          "longitude": {
+            "anyOf": [
+              {
+                "type": "number",
+                "minimum": -180,
+                "maximum": 180,
+                "description": "Longitude in degrees."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Longitude in degrees."
+          },
+          "sex": {
+            "type": "string",
+            "enum": [
+              "M",
+              "F"
+            ],
+            "description": "Sex used for traditional luck-cycle direction rules. Defaults to M."
+          },
+          "timezone": {
+            "anyOf": [
+              {
+                "type": "string",
+                "minLength": 1,
+                "description": "IANA timezone or AUTO. Defaults to AUTO and resolves historical offsets from the location."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "IANA timezone or AUTO. Defaults to AUTO and resolves historical offsets from the location."
+          },
+          "timeStandard": {
+            "type": "string",
+            "enum": [
+              "civil",
+              "true_solar",
+              "true_solar_absolute"
+            ],
+            "description": "Time standard: civil clock time, relative true solar time, or absolute true solar time. Defaults to civil."
+          },
+          "includePinyin": {
+            "type": "boolean",
+            "description": "Include pinyin. Defaults to true."
+          },
+          "targetYear": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Prediction year. Defaults upstream to the current UTC year when omitted."
+          },
+          "targetYearEnd": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Optional end year. Must equal targetYear when both are supplied; omitted or null uses the prediction year."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Optional end year. Must equal targetYear when both are supplied; omitted or null uses the prediction year."
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "summary",
+              "standard",
+              "debug"
+            ],
+            "description": "Response detail level. Defaults to summary."
+          },
+          "include": {
+            "anyOf": [
+              {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "interactions",
+                    "stars"
+                  ],
+                  "description": "One flow feature."
+                },
+                "description": "Optional whitelist of interactions and stars. Omitted or null includes both."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Optional whitelist of interactions and stars. Omitted or null includes both."
+          },
+          "exclude": {
+            "anyOf": [
+              {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "interactions",
+                    "stars",
+                    "baseline_interactions"
+                  ],
+                  "description": "One flow feature to exclude."
+                },
+                "description": "Optional flow features to exclude, including baseline_interactions."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Optional flow features to exclude, including baseline_interactions."
+          },
+          "dictionaryResponse": {
+            "type": "boolean",
+            "description": "Include the integer-ID dictionary in x_dict. Defaults to false."
+          },
+          "language": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Response language. Defaults to en; use zh-CN for Simplified Chinese."
+          },
+          "idempotencyKey": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional idempotency key. Reuse only when retrying the exact same POST request after a network failure."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "year",
+          "month",
+          "day"
+        ],
+        "description": "Annual and monthly flow input.",
+        "anyOf": [
+          {
+            "description": "Resolve the location from a city.",
+            "required": [
+              "city"
+            ],
+            "properties": {
+              "city": {
+                "type": "string",
+                "minLength": 1,
+                "description": "A non-empty city name.",
+                "pattern": "\\S"
+              }
+            }
+          },
+          {
+            "description": "Use explicit geographic coordinates.",
+            "required": [
+              "latitude",
+              "longitude"
+            ],
+            "properties": {
+              "latitude": {
+                "type": "number",
+                "description": "Explicit latitude."
+              },
+              "longitude": {
+                "type": "number",
+                "description": "Explicit longitude."
+              }
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "flow": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Annual and monthly flow data, including any returned x_dict mapping."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "flow"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.calculate_bazi_life_curve",
+      "service": "freeastroapi",
+      "name": "calculate_bazi_life_curve",
+      "description": "Calculate traditional Neijing Jing, Qi, and Shen age trajectories with BaZi luck-cycle adjustments.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "year": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Year of birth or the date to calculate."
+          },
+          "month": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 12,
+            "description": "Month number."
+          },
+          "day": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 31,
+            "description": "Day of month."
+          },
+          "hour": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 23,
+            "description": "Local clock hour. Defaults to 12."
+          },
+          "minute": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 59,
+            "description": "Local clock minute. Defaults to 0."
+          },
+          "city": {
+            "anyOf": [
+              {
+                "type": "string",
+                "minLength": 1,
+                "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+          },
+          "latitude": {
+            "anyOf": [
+              {
+                "type": "number",
+                "minimum": -90,
+                "maximum": 90,
+                "description": "Latitude in degrees."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Latitude in degrees."
+          },
+          "longitude": {
+            "anyOf": [
+              {
+                "type": "number",
+                "minimum": -180,
+                "maximum": 180,
+                "description": "Longitude in degrees."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Longitude in degrees."
+          },
+          "sex": {
+            "type": "string",
+            "enum": [
+              "M",
+              "F"
+            ],
+            "description": "Sex used for traditional luck-cycle direction rules. Defaults to M."
+          },
+          "maxAge": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 200,
+            "description": "Final age in the curve. Defaults to 120."
+          },
+          "cultivationFactor": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "description": "Traditional cultivation and self-care factor. Defaults to 0.5."
+          },
+          "language": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Response language. Defaults to en; use zh-CN for Simplified Chinese."
+          },
+          "idempotencyKey": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional idempotency key. Reuse only when retrying the exact same POST request after a network failure."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "year",
+          "month",
+          "day"
+        ],
+        "description": "Traditional life curve input.",
+        "anyOf": [
+          {
+            "description": "Resolve the location from a city.",
+            "required": [
+              "city"
+            ],
+            "properties": {
+              "city": {
+                "type": "string",
+                "minLength": 1,
+                "description": "A non-empty city name.",
+                "pattern": "\\S"
+              }
+            }
+          },
+          {
+            "description": "Use explicit geographic coordinates.",
+            "required": [
+              "latitude",
+              "longitude"
+            ],
+            "properties": {
+              "latitude": {
+                "type": "number",
+                "description": "Explicit latitude."
+              },
+              "longitude": {
+                "type": "number",
+                "description": "Explicit longitude."
+              }
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "lifeCurve": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Complete traditional life curve and model metadata returned by FreeAstroAPI."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "lifeCurve"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.calculate_bazi_synastry",
+      "service": "freeastroapi",
+      "name": "calculate_bazi_synastry",
+      "description": "Analyze compatibility between two BaZi charts with independent calendar and time settings.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "personA": {
+            "type": "object",
+            "properties": {
+              "year": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Year of birth or the date to calculate."
+              },
+              "month": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 12,
+                "description": "Month number."
+              },
+              "day": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 31,
+                "description": "Day of month."
+              },
+              "hour": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 23,
+                "description": "Local clock hour. Defaults to 12."
+              },
+              "minute": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 59,
+                "description": "Local clock minute. Defaults to 0."
+              },
+              "city": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+              },
+              "latitude": {
+                "anyOf": [
+                  {
+                    "type": "number",
+                    "minimum": -90,
+                    "maximum": 90,
+                    "description": "Latitude in degrees."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Latitude in degrees."
+              },
+              "longitude": {
+                "anyOf": [
+                  {
+                    "type": "number",
+                    "minimum": -180,
+                    "maximum": 180,
+                    "description": "Longitude in degrees."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Longitude in degrees."
+              },
+              "timezone": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "IANA timezone or AUTO. Defaults to AUTO and resolves historical offsets from the location."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "IANA timezone or AUTO. Defaults to AUTO and resolves historical offsets from the location."
+              },
+              "timeStandard": {
+                "type": "string",
+                "enum": [
+                  "civil",
+                  "true_solar",
+                  "true_solar_absolute"
+                ],
+                "description": "Time standard: civil clock time, relative true solar time, or absolute true solar time. Defaults to civil."
+              },
+              "calendar": {
+                "type": "string",
+                "enum": [
+                  "gregorian",
+                  "julian"
+                ],
+                "description": "Calendar used for the supplied date. Defaults to gregorian."
+              },
+              "sex": {
+                "type": "string",
+                "enum": [
+                  "M",
+                  "F"
+                ],
+                "description": "Sex used for traditional luck-cycle direction rules. Defaults to M."
+              },
+              "includeTenGods": {
+                "type": "boolean",
+                "description": "Include Ten Gods. Defaults to true."
+              },
+              "includePinyin": {
+                "type": "boolean",
+                "description": "Include pinyin. Defaults to true."
+              },
+              "includeStars": {
+                "type": "boolean",
+                "description": "Include symbolic stars. Defaults to true."
+              },
+              "includeInteractions": {
+                "type": "boolean",
+                "description": "Include pillar interactions. Defaults to true."
+              },
+              "includeProfessional": {
+                "type": "boolean",
+                "description": "Include Day Master strength, patterns, and useful elements. Defaults to true."
+              },
+              "includeDebug": {
+                "type": "boolean",
+                "description": "Include calculation debug data. Defaults to true."
+              },
+              "includeCurrentFlow": {
+                "type": "boolean",
+                "description": "Include current annual flow triggers. Defaults to false."
+              },
+              "language": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Response language. Defaults to en; use zh-CN for Simplified Chinese."
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "year",
+              "month",
+              "day"
+            ],
+            "description": "Complete birth data and BaZi calculation options.",
+            "anyOf": [
+              {
+                "description": "Resolve the location from a city.",
+                "required": [
+                  "city"
+                ],
+                "properties": {
+                  "city": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "A non-empty city name.",
+                    "pattern": "\\S"
+                  }
+                }
+              },
+              {
+                "description": "Use explicit geographic coordinates.",
+                "required": [
+                  "latitude",
+                  "longitude"
+                ],
+                "properties": {
+                  "latitude": {
+                    "type": "number",
+                    "description": "Explicit latitude."
+                  },
+                  "longitude": {
+                    "type": "number",
+                    "description": "Explicit longitude."
+                  }
+                }
+              }
+            ]
+          },
+          "personB": {
+            "type": "object",
+            "properties": {
+              "year": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Year of birth or the date to calculate."
+              },
+              "month": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 12,
+                "description": "Month number."
+              },
+              "day": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 31,
+                "description": "Day of month."
+              },
+              "hour": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 23,
+                "description": "Local clock hour. Defaults to 12."
+              },
+              "minute": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 59,
+                "description": "Local clock minute. Defaults to 0."
+              },
+              "city": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+              },
+              "latitude": {
+                "anyOf": [
+                  {
+                    "type": "number",
+                    "minimum": -90,
+                    "maximum": 90,
+                    "description": "Latitude in degrees."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Latitude in degrees."
+              },
+              "longitude": {
+                "anyOf": [
+                  {
+                    "type": "number",
+                    "minimum": -180,
+                    "maximum": 180,
+                    "description": "Longitude in degrees."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Longitude in degrees."
+              },
+              "timezone": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "IANA timezone or AUTO. Defaults to AUTO and resolves historical offsets from the location."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "IANA timezone or AUTO. Defaults to AUTO and resolves historical offsets from the location."
+              },
+              "timeStandard": {
+                "type": "string",
+                "enum": [
+                  "civil",
+                  "true_solar",
+                  "true_solar_absolute"
+                ],
+                "description": "Time standard: civil clock time, relative true solar time, or absolute true solar time. Defaults to civil."
+              },
+              "calendar": {
+                "type": "string",
+                "enum": [
+                  "gregorian",
+                  "julian"
+                ],
+                "description": "Calendar used for the supplied date. Defaults to gregorian."
+              },
+              "sex": {
+                "type": "string",
+                "enum": [
+                  "M",
+                  "F"
+                ],
+                "description": "Sex used for traditional luck-cycle direction rules. Defaults to M."
+              },
+              "includeTenGods": {
+                "type": "boolean",
+                "description": "Include Ten Gods. Defaults to true."
+              },
+              "includePinyin": {
+                "type": "boolean",
+                "description": "Include pinyin. Defaults to true."
+              },
+              "includeStars": {
+                "type": "boolean",
+                "description": "Include symbolic stars. Defaults to true."
+              },
+              "includeInteractions": {
+                "type": "boolean",
+                "description": "Include pillar interactions. Defaults to true."
+              },
+              "includeProfessional": {
+                "type": "boolean",
+                "description": "Include Day Master strength, patterns, and useful elements. Defaults to true."
+              },
+              "includeDebug": {
+                "type": "boolean",
+                "description": "Include calculation debug data. Defaults to true."
+              },
+              "includeCurrentFlow": {
+                "type": "boolean",
+                "description": "Include current annual flow triggers. Defaults to false."
+              },
+              "language": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Response language. Defaults to en; use zh-CN for Simplified Chinese."
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "year",
+              "month",
+              "day"
+            ],
+            "description": "Complete birth data and BaZi calculation options.",
+            "anyOf": [
+              {
+                "description": "Resolve the location from a city.",
+                "required": [
+                  "city"
+                ],
+                "properties": {
+                  "city": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "A non-empty city name.",
+                    "pattern": "\\S"
+                  }
+                }
+              },
+              {
+                "description": "Use explicit geographic coordinates.",
+                "required": [
+                  "latitude",
+                  "longitude"
+                ],
+                "properties": {
+                  "latitude": {
+                    "type": "number",
+                    "description": "Explicit latitude."
+                  },
+                  "longitude": {
+                    "type": "number",
+                    "description": "Explicit longitude."
+                  }
+                }
+              }
+            ]
+          },
+          "language": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Response language. Defaults to en; use zh-CN for Simplified Chinese."
+          },
+          "idempotencyKey": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional idempotency key. Reuse only when retrying the exact same POST request after a network failure."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "personA",
+          "personB"
+        ],
+        "description": "BaZi compatibility input."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "compatibility": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Complete BaZi compatibility analysis returned by FreeAstroAPI."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "compatibility"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.calculate_ephemeris",
+      "service": "freeastroapi",
+      "name": "calculate_ephemeris",
+      "description": "Calculate celestial positions at an instant or over a date range, including optional aspects, houses, angles, fixed stars, Moon void-of-course data, and table outputs.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "start": {
+            "type": "string",
+            "minLength": 1,
+            "description": "ISO 8601 date or datetime, with an optional UTC offset. Dates expand to offset-free midnight. The endpoint docs do not define timezone-free datetime parsing.",
+            "pattern": "\\S"
+          },
+          "end": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional ISO end date or datetime. Must not precede start.",
+            "pattern": "\\S"
+          },
+          "step": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Positive whole minute/hour/day step such as 5m, 1h, or 1d. Defaults to 1d.",
+            "pattern": "\\S"
+          },
+          "city": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "description": "City or locality name for location lookup.",
+            "pattern": "\\S"
+          },
+          "latitude": {
+            "type": "number",
+            "minimum": -90,
+            "maximum": 90,
+            "description": "Latitude in degrees."
+          },
+          "longitude": {
+            "type": "number",
+            "minimum": -180,
+            "maximum": 180,
+            "description": "Longitude in degrees."
+          },
+          "timezone": {
+            "type": "string",
+            "minLength": 1,
+            "description": "IANA timezone or AUTO for automatic resolution. Defaults to AUTO.",
+            "pattern": "\\S"
+          },
+          "bodies": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "One official celestial body or point name.",
+              "pattern": "\\S"
+            },
+            "description": "Requested celestial bodies or points using official names."
+          },
+          "format": {
+            "type": "string",
+            "enum": [
+              "json",
+              "table"
+            ],
+            "description": "Response layout. Defaults to json."
+          },
+          "tableStyle": {
+            "type": "string",
+            "enum": [
+              "rows",
+              "columns",
+              "grid"
+            ],
+            "description": "Table style; grid is capped at 31 rows."
+          },
+          "zodiacType": {
+            "type": "string",
+            "enum": [
+              "tropical",
+              "sidereal"
+            ],
+            "description": "Zodiac system. Defaults to tropical."
+          },
+          "siderealAyanamsa": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Sidereal ayanamsa when using the sidereal zodiac.",
+            "pattern": "\\S"
+          },
+          "houseSystem": {
+            "type": "string",
+            "minLength": 1,
+            "description": "House system for houses and angles. Defaults to placidus.",
+            "pattern": "\\S"
+          },
+          "includeAspects": {
+            "type": "boolean",
+            "description": "Include aspects for every snapshot."
+          },
+          "includeMinorAspects": {
+            "type": "boolean",
+            "description": "Include minor aspect types."
+          },
+          "includeMoonVoidOfCourse": {
+            "type": "boolean",
+            "description": "Include Moon void-of-course state and next sign ingress and applying aspect."
+          },
+          "includeFixedStars": {
+            "type": "boolean",
+            "description": "Include the default fixed star set."
+          },
+          "fixedStars": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "One official fixed star name.",
+              "pattern": "\\S"
+            },
+            "description": "Optional explicit fixed star names."
+          },
+          "includeHouses": {
+            "type": "boolean",
+            "description": "Include houses; auto-enabled upstream when coordinates are available unless explicitly false."
+          },
+          "includeAngles": {
+            "type": "boolean",
+            "description": "Include angles; auto-enabled upstream when coordinates are available unless explicitly false."
+          },
+          "idempotencyKey": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional idempotency key. Reuse only when retrying the exact same POST request after a network failure."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "start"
+        ],
+        "description": "Ephemeris calculation input."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "ephemeris": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Complete ephemeris response, preserving snapshot, range, and table layouts."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "ephemeris"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.calculate_numerology_profile",
+      "service": "freeastroapi",
+      "name": "calculate_numerology_profile",
+      "description": "Calculate a Pythagorean, Chaldean, Kabbalah/Gematria, or Ank Jyotish profile with method-specific name, date, transliteration, and optional interpretation settings.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "method": {
+            "type": "object",
+            "properties": {
+              "system": {
+                "type": "string",
+                "enum": [
+                  "pythagorean",
+                  "chaldean",
+                  "kabbalah",
+                  "ank_jyotish"
+                ],
+                "description": "Numerology tradition to calculate."
+              },
+              "profile": {
+                "type": "string",
+                "enum": [
+                  "standard",
+                  "raw_date",
+                  "pythagorean-component-preserve-core-v1",
+                  "pythagorean-raw-date-preserve-core-v1",
+                  "current_name",
+                  "birth_name",
+                  "chaldean-cheiro-current-name-v1",
+                  "chaldean-cheiro-birth-name-v1",
+                  "ordinal",
+                  "reduced_letters",
+                  "reduced_total",
+                  "full_letter_names",
+                  "full_letter_names_reduced",
+                  "kabbalah-gematria-hechrechi-v1",
+                  "kabbalah-gematria-siduri-v1",
+                  "kabbalah-gematria-katan-v1",
+                  "kabbalah-gematria-katan-mispari-v1",
+                  "kabbalah-gematria-millui-alef-v1",
+                  "kabbalah-gematria-millui-alef-reduced-v1",
+                  "ank-jyotish-civil-cheiro-navagraha-reduce-all-v1"
+                ],
+                "description": "Profile alias or canonical versioned profile ID belonging to the selected system."
+              },
+              "masterPolicy": {
+                "type": "string",
+                "enum": [
+                  "preserve_core_11_22_33",
+                  "reduce_all",
+                  "not_applicable"
+                ],
+                "description": "Optional compatible master-number policy; normally let the provider derive it from the profile."
+              },
+              "compoundPolicy": {
+                "type": "string",
+                "enum": [
+                  "root_only",
+                  "compound_and_root",
+                  "full_trace"
+                ],
+                "description": "Evidence depth: compound_and_root or full_trace; Pythagorean also supports root_only."
+              },
+              "nameSource": {
+                "type": "string",
+                "enum": [
+                  "birth",
+                  "current"
+                ],
+                "description": "Choose birth or current for Kabbalah and Ank when both names are present. Chaldean uses its profile instead."
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "system"
+            ],
+            "description": "Numerology method and reproducibility settings. Omit profile and policies to use upstream defaults."
+          },
+          "subject": {
+            "type": "object",
+            "properties": {
+              "birthDate": {
+                "type": "string",
+                "description": "Gregorian date in YYYY-MM-DD format.",
+                "format": "date"
+              },
+              "name": {
+                "type": "object",
+                "properties": {
+                  "birth": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 200,
+                    "description": "Nonblank full name, at most 200 characters.",
+                    "pattern": "\\S"
+                  },
+                  "current": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 200,
+                    "description": "Nonblank full name, at most 200 characters.",
+                    "pattern": "\\S"
+                  },
+                  "script": {
+                    "type": "string",
+                    "description": "ISO 15924 script code such as Latn or Hebr. Kabbalah can infer Hebr from unambiguous Hebrew names.",
+                    "pattern": "^[A-Z][a-z]{3}$"
+                  },
+                  "transliteration": {
+                    "type": "object",
+                    "properties": {
+                      "profile": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 100,
+                        "description": "Caller-supplied transliteration profile identifier.",
+                        "pattern": "\\S"
+                      },
+                      "birth": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 200,
+                        "description": "Nonblank full name, at most 200 characters.",
+                        "pattern": "\\S"
+                      },
+                      "current": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 200,
+                        "description": "Nonblank full name, at most 200 characters.",
+                        "pattern": "\\S"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "profile"
+                    ],
+                    "description": "Caller-supplied Latin transliteration. Pythagorean and Chaldean use supplied values even for Latin input; Ank ignores them for Latn.",
+                    "anyOf": [
+                      {
+                        "required": [
+                          "birth"
+                        ]
+                      },
+                      {
+                        "required": [
+                          "current"
+                        ]
+                      }
+                    ]
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Birth and/or current names with explicit script and transliteration when needed.",
+                "anyOf": [
+                  {
+                    "required": [
+                      "birth"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "current"
+                    ]
+                  }
+                ]
+              },
+              "calendar": {
+                "type": "string",
+                "enum": [
+                  "gregory"
+                ],
+                "description": "Calendar identifier. Currently only gregory is supported."
+              },
+              "locale": {
+                "type": "string",
+                "enum": [
+                  "en",
+                  "en-IN",
+                  "hi",
+                  "hi-IN"
+                ],
+                "description": "Subject locale. Interpretations for Pythagorean, Chaldean, and Kabbalah require exact en; Hindi localizes Ank labels."
+              },
+              "timezone": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Pythagorean cycle timezone: an IANA name or AUTO. Required when referenceDate is omitted.",
+                "pattern": "\\S"
+              },
+              "city": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200,
+                "description": "City for AUTO timezone resolution when no reference date is provided.",
+                "pattern": "\\S"
+              },
+              "latitude": {
+                "type": "number",
+                "minimum": -90,
+                "maximum": 90,
+                "description": "Latitude for AUTO timezone resolution; provide longitude together."
+              },
+              "longitude": {
+                "type": "number",
+                "minimum": -180,
+                "maximum": 180,
+                "description": "Longitude for AUTO timezone resolution; provide latitude together."
+              }
+            },
+            "additionalProperties": false,
+            "description": "Numerology subject. Required birth dates and names depend on the selected system."
+          },
+          "dateContext": {
+            "type": "object",
+            "properties": {
+              "referenceDate": {
+                "type": "string",
+                "description": "Explicit personal-cycle reference date. Otherwise provide a timezone in subject.",
+                "format": "date"
+              },
+              "yearAnchor": {
+                "type": "string",
+                "enum": [
+                  "calendar_year"
+                ],
+                "description": "Personal-cycle year anchor. Currently only calendar_year is supported."
+              }
+            },
+            "additionalProperties": false,
+            "description": "Pythagorean personal-cycle date context."
+          },
+          "includeInterpretations": {
+            "type": "boolean",
+            "description": "Opt in to available versioned content. Defaults to false; unavailable content is reported as a nonfatal warning."
+          },
+          "idempotencyKey": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional idempotency key. Reuse only when retrying the exact same POST request after a network failure."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "method",
+          "subject"
+        ],
+        "description": "Numerology profile input with four method-specific variants.",
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "method": {
+                  "properties": {
+                    "system": {
+                      "enum": [
+                        "pythagorean",
+                        "ank_jyotish"
+                      ]
+                    }
+                  }
+                }
+              }
+            },
+            "then": {
+              "properties": {
+                "subject": {
+                  "required": [
+                    "birthDate"
+                  ]
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "method": {
+                  "properties": {
+                    "system": {
+                      "enum": [
+                        "chaldean",
+                        "kabbalah",
+                        "ank_jyotish"
+                      ]
+                    }
+                  }
+                }
+              }
+            },
+            "then": {
+              "properties": {
+                "subject": {
+                  "required": [
+                    "name"
+                  ]
+                }
+              }
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "profile": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Complete numerology profile, including resolved method policies, provenance, optional interpretations, and nonfatal warnings."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "profile"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.calculate_transit_timeline",
+      "service": "freeastroapi",
+      "name": "calculate_transit_timeline",
+      "description": "Calculate transit-to-natal intervals for a calendar month or a long-cycle range up to 366 days, with configurable planets, points, aspects, and orbs. Requires a High plan.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "natal": {
+            "type": "object",
+            "properties": {
+              "year": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Year of birth or the date to calculate."
+              },
+              "month": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 12,
+                "description": "Month number."
+              },
+              "day": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 31,
+                "description": "Day of month."
+              },
+              "hour": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 23,
+                "description": "Birth hour, required for angle-sensitive timelines when birth time is known."
+              },
+              "minute": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 59,
+                "description": "Birth minute."
+              },
+              "city": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200,
+                "description": "City or locality name for location lookup.",
+                "pattern": "\\S"
+              },
+              "latitude": {
+                "type": "number",
+                "minimum": -90,
+                "maximum": 90,
+                "description": "Latitude in degrees."
+              },
+              "longitude": {
+                "type": "number",
+                "minimum": -180,
+                "maximum": 180,
+                "description": "Longitude in degrees."
+              },
+              "name": {
+                "type": "string",
+                "description": "Optional display name for the chart owner."
+              },
+              "timeKnown": {
+                "type": "boolean",
+                "description": "Whether birth time is known. Set false to omit angle-based calculations."
+              },
+              "timezone": {
+                "type": "string",
+                "minLength": 1,
+                "description": "IANA timezone or AUTO for automatic resolution. Defaults to AUTO.",
+                "pattern": "\\S"
+              },
+              "zodiacType": {
+                "type": "string",
+                "enum": [
+                  "tropical",
+                  "sidereal"
+                ],
+                "description": "Zodiac system. Defaults to tropical."
+              },
+              "siderealAyanamsa": {
+                "type": "string",
+                "enum": [
+                  "lahiri",
+                  "raman",
+                  "kp",
+                  "fagan_bradley",
+                  "yukteshwar"
+                ],
+                "description": "Sidereal ayanamsa for the natal and transit calculations."
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "year",
+              "month",
+              "day",
+              "city",
+              "latitude",
+              "longitude"
+            ],
+            "description": "Natal reference chart; provide the birth city and coordinates. Supply hour when birth time is known."
+          },
+          "rangeStart": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Range start as an ISO date or datetime. Date-only values use 00:00:00Z.",
+            "pattern": "\\S"
+          },
+          "rangeEnd": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Range end as an ISO date or datetime. Date-only values use 23:59:59Z.",
+            "pattern": "\\S"
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "month",
+              "year_slow"
+            ],
+            "description": "Timeline mode. Defaults to month; year_slow accepts medium and slow bodies across up to 366 days."
+          },
+          "includeHouses": {
+            "type": "boolean",
+            "description": "Include natal and transit house context when available."
+          },
+          "transitCategories": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "fast",
+                "medium",
+                "slow",
+                "all"
+              ],
+              "description": "One transit category."
+            },
+            "description": "Transit category filter. In year_slow mode use medium, slow, or both."
+          },
+          "transitPlanets": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "One official celestial body or point name.",
+              "pattern": "\\S"
+            },
+            "description": "Official transit planet keys, including nodes, Chiron, and Lilith variants."
+          },
+          "natalPoints": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "One official celestial body or point name.",
+              "pattern": "\\S"
+            },
+            "description": "Official natal point keys, including nodes and angle-derived points when birth time is known."
+          },
+          "aspectTypes": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "One official aspect type.",
+              "pattern": "\\S"
+            },
+            "description": "Aspect type filter. Defaults to the five major aspects."
+          },
+          "orbSettings": {
+            "type": "object",
+            "properties": {
+              "conjunction": {
+                "type": "number",
+                "minimum": 0,
+                "description": "Conjunction orb in degrees."
+              },
+              "sextile": {
+                "type": "number",
+                "minimum": 0,
+                "description": "Sextile orb in degrees."
+              },
+              "square": {
+                "type": "number",
+                "minimum": 0,
+                "description": "Square orb in degrees."
+              },
+              "trine": {
+                "type": "number",
+                "minimum": 0,
+                "description": "Trine orb in degrees."
+              },
+              "opposition": {
+                "type": "number",
+                "minimum": 0,
+                "description": "Opposition orb in degrees."
+              },
+              "byAspect": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "number",
+                  "minimum": 0,
+                  "description": "Orb value in degrees."
+                },
+                "description": "Aspect names mapped to orb values in degrees; default sets the fallback orb."
+              },
+              "byCategory": {
+                "type": "object",
+                "properties": {
+                  "fast": {
+                    "type": "object",
+                    "additionalProperties": {
+                      "type": "number",
+                      "minimum": 0,
+                      "description": "Orb value in degrees."
+                    },
+                    "description": "Aspect names mapped to orb values in degrees; default sets the fallback orb."
+                  },
+                  "medium": {
+                    "type": "object",
+                    "additionalProperties": {
+                      "type": "number",
+                      "minimum": 0,
+                      "description": "Orb value in degrees."
+                    },
+                    "description": "Aspect names mapped to orb values in degrees; default sets the fallback orb."
+                  },
+                  "slow": {
+                    "type": "object",
+                    "additionalProperties": {
+                      "type": "number",
+                      "minimum": 0,
+                      "description": "Orb value in degrees."
+                    },
+                    "description": "Aspect names mapped to orb values in degrees; default sets the fallback orb."
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Category-specific orb overrides."
+              },
+              "byPlanet": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "number",
+                    "minimum": 0,
+                    "description": "Orb value in degrees."
+                  },
+                  "description": "Aspect names mapped to orb values in degrees; default sets the fallback orb."
+                },
+                "description": "Transit planet keys mapped to orb overrides."
+              }
+            },
+            "additionalProperties": {
+              "type": "number",
+              "minimum": 0,
+              "description": "Additional flat per-aspect orb in degrees."
+            },
+            "description": "Orb override policy. Planet overrides take precedence over category and aspect overrides."
+          },
+          "idempotencyKey": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional idempotency key. Reuse only when retrying the exact same POST request after a network failure."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "natal",
+          "rangeStart",
+          "rangeEnd"
+        ],
+        "description": "Transit timeline input."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "timeline": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Complete timeline, retaining true interval boundaries and month-clipped display fields."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "timeline"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.calculate_vedic_chart",
+      "service": "freeastroapi",
+      "name": "calculate_vedic_chart",
+      "description": "Run the V2 integrated Vedic calculation with optional divisional charts, Dasha, Yogas, Panchang, Shadbala, Ashtakavarga, and Avastha.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "year": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Year of birth or the date to calculate."
+          },
+          "month": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 12,
+            "description": "Month number."
+          },
+          "day": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 31,
+            "description": "Day of month."
+          },
+          "hour": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 23,
+            "description": "Birth hour."
+          },
+          "minute": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 59,
+            "description": "Birth minute."
+          },
+          "city": {
+            "anyOf": [
+              {
+                "type": "string",
+                "minLength": 1,
+                "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+          },
+          "latitude": {
+            "anyOf": [
+              {
+                "type": "number",
+                "minimum": -90,
+                "maximum": 90,
+                "description": "Latitude in degrees."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Latitude in degrees."
+          },
+          "longitude": {
+            "anyOf": [
+              {
+                "type": "number",
+                "minimum": -180,
+                "maximum": 180,
+                "description": "Longitude in degrees."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Longitude in degrees."
+          },
+          "timezone": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Timezone override: IANA name, AUTO, or LMT. Defaults to AUTO.",
+            "pattern": "\\S"
+          },
+          "ayanamsha": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Vedic ayanamsha. Defaults to lahiri.",
+            "pattern": "\\S"
+          },
+          "houseSystem": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Vedic house system. Defaults to whole_sign.",
+            "pattern": "\\S"
+          },
+          "nodeType": {
+            "type": "string",
+            "enum": [
+              "mean",
+              "true"
+            ],
+            "description": "Lunar node type."
+          },
+          "vargas": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "One divisional chart number."
+            },
+            "description": "Divisional chart numbers, for example 1, 9, 10, and 60. Defaults to D1."
+          },
+          "includeAvastha": {
+            "type": "boolean",
+            "description": "Include Baladi Avastha planet age states."
+          },
+          "includeYogas": {
+            "type": "boolean",
+            "description": "Include V2 Yoga detection."
+          },
+          "includePanchang": {
+            "type": "boolean",
+            "description": "Include V2 Panchang for the birth date and location."
+          },
+          "includeShadbala": {
+            "type": "boolean",
+            "description": "Include calibrated V2 Shadbala values."
+          },
+          "includeAshtakavarga": {
+            "type": "boolean",
+            "description": "Include V2 Ashtakavarga values."
+          },
+          "dashaLevels": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 3,
+            "description": "Dasha depth: 0 off, 1 Mahadasha, 2 Antardasha, or 3 Pratyantardasha."
+          },
+          "referenceDate": {
+            "type": "string",
+            "description": "Date for active Dasha lookup. Defaults to today in the resolved timezone.",
+            "format": "date"
+          },
+          "idempotencyKey": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional idempotency key. Reuse only when retrying the exact same POST request after a network failure."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "year",
+          "month",
+          "day",
+          "hour",
+          "minute"
+        ],
+        "description": "Integrated Vedic calculation input.",
+        "anyOf": [
+          {
+            "description": "Resolve the location from a city.",
+            "required": [
+              "city"
+            ],
+            "properties": {
+              "city": {
+                "type": "string",
+                "minLength": 1,
+                "description": "A non-empty city name.",
+                "pattern": "\\S"
+              }
+            }
+          },
+          {
+            "description": "Use explicit geographic coordinates.",
+            "required": [
+              "latitude",
+              "longitude"
+            ],
+            "properties": {
+              "latitude": {
+                "type": "number",
+                "description": "Explicit latitude."
+              },
+              "longitude": {
+                "type": "number",
+                "description": "Explicit longitude."
+              }
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "calculation": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Complete V2 Vedic calculation with all requested component results and ruleset metadata."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "calculation"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.correct_bazi_time",
+      "service": "freeastroapi",
+      "name": "correct_bazi_time",
+      "description": "Convert local civil time to local mean and relative or absolute true solar time.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "year": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Year of birth or the date to calculate."
+          },
+          "month": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 12,
+            "description": "Month number."
+          },
+          "day": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 31,
+            "description": "Day of month."
+          },
+          "hour": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 23,
+            "description": "Local clock hour. Defaults to 12."
+          },
+          "minute": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 59,
+            "description": "Local clock minute. Defaults to 0."
+          },
+          "city": {
+            "anyOf": [
+              {
+                "type": "string",
+                "minLength": 1,
+                "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "City name for coordinate lookup. Provide a city or both latitude and longitude."
+          },
+          "latitude": {
+            "anyOf": [
+              {
+                "type": "number",
+                "minimum": -90,
+                "maximum": 90,
+                "description": "Latitude in degrees."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Latitude in degrees."
+          },
+          "longitude": {
+            "anyOf": [
+              {
+                "type": "number",
+                "minimum": -180,
+                "maximum": 180,
+                "description": "Longitude in degrees."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Longitude in degrees."
+          },
+          "timezone": {
+            "anyOf": [
+              {
+                "type": "string",
+                "minLength": 1,
+                "description": "IANA timezone or AUTO. Defaults to AUTO and resolves historical offsets from the location."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "IANA timezone or AUTO. Defaults to AUTO and resolves historical offsets from the location."
+          },
+          "language": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Response language. Defaults to en; use zh-CN for Simplified Chinese."
+          },
+          "idempotencyKey": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional idempotency key. Reuse only when retrying the exact same POST request after a network failure."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "year",
+          "month",
+          "day"
+        ],
+        "description": "Solar time correction input.",
+        "anyOf": [
+          {
+            "description": "Resolve the location from a city.",
+            "required": [
+              "city"
+            ],
+            "properties": {
+              "city": {
+                "type": "string",
+                "minLength": 1,
+                "description": "A non-empty city name.",
+                "pattern": "\\S"
+              }
+            }
+          },
+          {
+            "description": "Use explicit geographic coordinates.",
+            "required": [
+              "latitude",
+              "longitude"
+            ],
+            "properties": {
+              "latitude": {
+                "type": "number",
+                "description": "Explicit latitude."
+              },
+              "longitude": {
+                "type": "number",
+                "description": "Explicit longitude."
+              }
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "correction": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Solar time correction details returned by FreeAstroAPI."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "correction"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.get_bazi_dictionary",
+      "service": "freeastroapi",
+      "name": "get_bazi_dictionary",
+      "description": "Get the stable ID mappings for BaZi interactions and symbolic stars.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "language": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Response language. Defaults to en; use zh-CN for Simplified Chinese."
+          }
+        },
+        "additionalProperties": false,
+        "description": "BaZi dictionary lookup input."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "dictionary": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Complete BaZi ID dictionary returned by FreeAstroAPI."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "dictionary"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.get_chinese_calendar",
+      "service": "freeastroapi",
+      "name": "get_chinese_calendar",
+      "description": "Convert a Gregorian date to the Chinese lunar calendar, zodiac, solar terms, and festivals.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "date": {
+            "type": "string",
+            "description": "Gregorian date in YYYY-MM-DD format.",
+            "format": "date"
+          },
+          "language": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Response language. Defaults to en; use zh-CN for Simplified Chinese."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "date"
+        ],
+        "description": "Chinese calendar lookup input."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "calendar": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Complete Chinese calendar conversion returned by FreeAstroAPI."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "calendar"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.get_current_pillars",
+      "service": "freeastroapi",
+      "name": "get_current_pillars",
+      "description": "Get the four pillars and element balance at the current UTC instant.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "language": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Response language. Defaults to en; use zh-CN for Simplified Chinese."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Current pillars lookup input."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "pillars": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Current timestamp, date, pillars, Day Master, and element balance returned by FreeAstroAPI."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "pillars"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.get_moon_calendar",
+      "service": "freeastroapi",
+      "name": "get_moon_calendar",
+      "description": "Get a complete monthly moon calendar with optional SVG visuals, eclipses, forecasts, sign intervals, and ingress events. Requires an Entry or High plan.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "year": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 9999,
+            "description": "Four-digit calendar year."
+          },
+          "month": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 12,
+            "description": "Month number."
+          },
+          "city": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "description": "City or locality name for location lookup.",
+            "pattern": "\\S"
+          },
+          "latitude": {
+            "type": "number",
+            "minimum": -90,
+            "maximum": 90,
+            "description": "Latitude in degrees."
+          },
+          "longitude": {
+            "type": "number",
+            "minimum": -180,
+            "maximum": 180,
+            "description": "Longitude in degrees."
+          },
+          "timezone": {
+            "type": "string",
+            "minLength": 1,
+            "description": "IANA timezone or AUTO for automatic resolution. Defaults to AUTO.",
+            "pattern": "\\S"
+          },
+          "includeZodiac": {
+            "type": "boolean",
+            "description": "Include the Moon's tropical zodiac sign. Defaults to false."
+          },
+          "includeVisuals": {
+            "type": "boolean",
+            "description": "Include the moon SVG and shadow ratio. Defaults to false."
+          },
+          "includeSpecial": {
+            "type": "boolean",
+            "description": "Include special moon labels such as supermoon and harvest moon. Defaults to false."
+          },
+          "includeEclipse": {
+            "type": "boolean",
+            "description": "Include nearby solar or lunar eclipse details and local visibility when a location is provided. Defaults to false."
+          },
+          "includeForecast": {
+            "type": "boolean",
+            "description": "Include next moon phases, lunar eclipse, and solar eclipse forecasts. Defaults to false."
+          },
+          "includeTraditionalMoon": {
+            "type": "boolean",
+            "description": "Include traditional North American full moon names. Defaults to false."
+          },
+          "moonColor": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Hex color for illuminated moon SVG fill. Defaults to #E0E0E0.",
+            "pattern": "\\S"
+          },
+          "shadowColor": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Hex color for moon SVG shadow. Defaults to #1A1A1A.",
+            "pattern": "\\S"
+          },
+          "includeSignTimeline": {
+            "type": "boolean",
+            "description": "Include sign intervals and ingress events for the month. Defaults to false."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "year",
+          "month"
+        ],
+        "description": "Monthly moon calendar input."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "calendar": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Complete monthly moon calendar, daily snapshots, and any sign timeline and ingress events."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "calendar"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.get_moon_phase",
+      "service": "freeastroapi",
+      "name": "get_moon_phase",
+      "description": "Get moon phase, illumination, and optional zodiac, rise/set, eclipse, forecasts, interpretation, and SVG visuals for a date or the current instant.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "date": {
+            "type": "string",
+            "minLength": 1,
+            "description": "ISO date or datetime, or now. Defaults to the current instant.",
+            "pattern": "\\S"
+          },
+          "city": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "description": "City or locality name for location lookup.",
+            "pattern": "\\S"
+          },
+          "latitude": {
+            "type": "number",
+            "minimum": -90,
+            "maximum": 90,
+            "description": "Latitude in degrees."
+          },
+          "longitude": {
+            "type": "number",
+            "minimum": -180,
+            "maximum": 180,
+            "description": "Longitude in degrees."
+          },
+          "timezone": {
+            "type": "string",
+            "minLength": 1,
+            "description": "IANA timezone or AUTO for automatic resolution. Defaults to AUTO.",
+            "pattern": "\\S"
+          },
+          "includeZodiac": {
+            "type": "boolean",
+            "description": "Include the Moon's tropical zodiac sign. Defaults to false."
+          },
+          "includeVisuals": {
+            "type": "boolean",
+            "description": "Include the moon SVG and shadow ratio. Defaults to false."
+          },
+          "includeSpecial": {
+            "type": "boolean",
+            "description": "Include special moon labels such as supermoon and harvest moon. Defaults to false."
+          },
+          "includeEclipse": {
+            "type": "boolean",
+            "description": "Include nearby solar or lunar eclipse details and local visibility when a location is provided. Defaults to false."
+          },
+          "includeForecast": {
+            "type": "boolean",
+            "description": "Include next moon phases, lunar eclipse, and solar eclipse forecasts. Defaults to false."
+          },
+          "includeTraditionalMoon": {
+            "type": "boolean",
+            "description": "Include traditional North American full moon names. Defaults to false."
+          },
+          "moonColor": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Hex color for illuminated moon SVG fill. Defaults to #E0E0E0.",
+            "pattern": "\\S"
+          },
+          "shadowColor": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Hex color for moon SVG shadow. Defaults to #1A1A1A.",
+            "pattern": "\\S"
+          },
+          "includeRiseSet": {
+            "type": "boolean",
+            "description": "Include moon rise and set times; requires a city or paired coordinates. Defaults to false."
+          },
+          "includeInterpretation": {
+            "type": "boolean",
+            "description": "Include the optional Moon sign, phase, and decan interpretation. Defaults to false."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Moon phase input."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "moon": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Complete moon phase data and all requested optional results."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "moon"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.list_sky_events",
+      "service": "freeastroapi",
+      "name": "list_sky_events",
+      "description": "Get planetary ingresses, exact aspects, stations, and lunations for a local calendar date. This returns event data for downstream notifications.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "date": {
+            "type": "string",
+            "description": "Gregorian calendar date in YYYY-MM-DD format.",
+            "format": "date"
+          },
+          "timezone": {
+            "type": "string",
+            "minLength": 1,
+            "description": "IANA timezone defining local-day boundaries. Defaults to UTC.",
+            "pattern": "\\S"
+          },
+          "preset": {
+            "type": "string",
+            "enum": [
+              "quiet",
+              "daily",
+              "full"
+            ],
+            "description": "Event-volume preset. Explicit include flags override the preset. Defaults to quiet."
+          },
+          "includeMoon": {
+            "type": "boolean",
+            "description": "Include Moon sign ingress events."
+          },
+          "includeExactHits": {
+            "type": "boolean",
+            "description": "Include exact major planetary aspects."
+          },
+          "includeMoonExactHits": {
+            "type": "boolean",
+            "description": "Include exact Moon aspects."
+          },
+          "includeIngresses": {
+            "type": "boolean",
+            "description": "Include non-Moon planetary ingresses."
+          },
+          "includeRetrogrades": {
+            "type": "boolean",
+            "description": "Include retrograde and direct stations."
+          },
+          "includeLunations": {
+            "type": "boolean",
+            "description": "Include new and full moons."
+          },
+          "includeFormulation": {
+            "type": "boolean",
+            "description": "Include deterministic notification phrases."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "date"
+        ],
+        "description": "Daily sky event input."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "events": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Complete sky event feed with metadata, timestamps, and optional notification phrases."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "events"
+        ],
+        "description": "The FreeAstroAPI calculation result."
+      }
+    },
+    {
+      "id": "freeastroapi.search_cities",
+      "service": "freeastroapi",
+      "name": "search_cities",
+      "description": "Search cities and localities, including province-qualified queries, and return coordinates and IANA timezones for subsequent chart calculations.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "minLength": 2,
+            "description": "City-name prefix or a city and province query such as Jingzhou, Hubei. At least two characters.",
+            "pattern": "\\S"
+          },
+          "country": {
+            "type": "string",
+            "description": "Optional ISO 3166-1 alpha-2 country filter.",
+            "pattern": "^\\s*[A-Za-z]{2}\\s*$"
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 50,
+            "description": "Maximum number of results. Defaults to 10; queries shorter than four characters are capped upstream at five."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "query"
+        ],
+        "description": "City search input."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "cities": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "description": "City or locality name."
+                },
+                "country": {
+                  "type": "string",
+                  "description": "Country code."
+                },
+                "state": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "State or province when available."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "State or province when available."
+                },
+                "district": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Indian district when available."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Indian district when available."
+                },
+                "latitude": {
+                  "type": "number",
+                  "minimum": -90,
+                  "maximum": 90,
+                  "description": "Latitude in degrees."
+                },
+                "longitude": {
+                  "type": "number",
+                  "minimum": -180,
+                  "maximum": 180,
+                  "description": "Longitude in degrees."
+                },
+                "timezone": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "IANA timezone when available."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "IANA timezone when available."
+                },
+                "population": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "description": "Population used by the upstream search ranking."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Population used by the upstream search ranking."
+                },
+                "raw": {
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": true,
+                  "description": "Complete upstream city record, including future fields."
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "name",
+                "country",
+                "state",
+                "district",
+                "latitude",
+                "longitude",
+                "timezone",
+                "population",
+                "raw"
+              ],
+              "description": "A matching location ready for use in chart inputs."
+            },
+            "description": "Matching cities in upstream result order."
+          },
+          "count": {
+            "type": "integer",
+            "description": "Number of returned city results."
+          },
+          "raw": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Complete upstream search response, including future fields."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "cities",
+          "count",
+          "raw"
+        ],
+        "description": "City search results."
+      }
+    }
+  ]
+}