@oomol-lab/open-connector 1.8.0 → 1.9.0

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

@@ -0,0 +1,2244 @@
+{
+  "service": "yuanfenju",
+  "displayName": "Yuanfenju",
+  "homepageUrl": "https://yuanfenju.com/",
+  "iconUrl": "https://yuanfenju.com/Public/img/favicon.ico",
+  "categories": [
+    "Data & Analytics"
+  ],
+  "authTypes": [
+    "api_key"
+  ],
+  "auth": [
+    {
+      "type": "api_key",
+      "label": "Development API Key",
+      "placeholder": "YUANFENJU_API_KEY",
+      "description": "Yuanfenju development API key. Register or sign in at https://portal.yuanfenju.com/ and copy the Development Key from your merchant account. Calls use your account's plan and quota; tarot readings require paid membership."
+    }
+  ],
+  "actions": [
+    {
+      "id": "yuanfenju.analyze_bazi_compatibility",
+      "service": "yuanfenju",
+      "name": "analyze_bazi_compatibility",
+      "description": "Analyze two people's Bazi charts for relationship or marriage entertainment using the official matching interface selected by the caller. Marriage uses firstPerson as the male partner and secondPerson as the female partner. Each lunar date in 1900-2100 adds a conversion call; other non-leap lunar dates use native input.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "scenario": {
+            "type": "string",
+            "description": "The matching scenario: relationship for general matching or marriage for the traditional male/female marriage interface. Defaults to relationship.",
+            "default": "relationship",
+            "enum": [
+              "relationship",
+              "marriage"
+            ]
+          },
+          "firstPerson": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1,
+                "description": "The name displayed on the chart.",
+                "pattern": "\\S"
+              },
+              "calendarType": {
+                "type": "string",
+                "description": "The input calendar. Defaults to solar (Gregorian).",
+                "default": "solar",
+                "enum": [
+                  "solar",
+                  "lunar"
+                ]
+              },
+              "year": {
+                "type": "integer",
+                "description": "The input year."
+              },
+              "month": {
+                "type": "integer",
+                "description": "The input month. Negative values represent lunar leap months, such as -6 for leap June.",
+                "enum": [
+                  -12,
+                  -11,
+                  -10,
+                  -9,
+                  -8,
+                  -7,
+                  -6,
+                  -5,
+                  -4,
+                  -3,
+                  -2,
+                  -1,
+                  1,
+                  2,
+                  3,
+                  4,
+                  5,
+                  6,
+                  7,
+                  8,
+                  9,
+                  10,
+                  11,
+                  12
+                ]
+              },
+              "day": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 31,
+                "description": "The input day of month."
+              },
+              "hour": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 23,
+                "description": "The local hour, from 0 to 23."
+              },
+              "minute": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 59,
+                "description": "The minute. Defaults to 0 when unknown.",
+                "default": 0
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "name",
+              "year",
+              "month",
+              "day",
+              "hour"
+            ],
+            "description": "The first person's birth details; in the marriage scenario this is the male partner.",
+            "allOf": [
+              {
+                "if": {
+                  "properties": {
+                    "calendarType": {
+                      "const": "lunar"
+                    }
+                  },
+                  "required": [
+                    "calendarType"
+                  ]
+                },
+                "then": {
+                  "if": {
+                    "properties": {
+                      "month": {
+                        "maximum": -1
+                      }
+                    }
+                  },
+                  "then": {
+                    "properties": {
+                      "year": {
+                        "minimum": 1900,
+                        "maximum": 2100
+                      }
+                    }
+                  }
+                },
+                "else": {
+                  "properties": {
+                    "month": {
+                      "minimum": 1
+                    }
+                  }
+                }
+              }
+            ]
+          },
+          "secondPerson": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1,
+                "description": "The name displayed on the chart.",
+                "pattern": "\\S"
+              },
+              "calendarType": {
+                "type": "string",
+                "description": "The input calendar. Defaults to solar (Gregorian).",
+                "default": "solar",
+                "enum": [
+                  "solar",
+                  "lunar"
+                ]
+              },
+              "year": {
+                "type": "integer",
+                "description": "The input year."
+              },
+              "month": {
+                "type": "integer",
+                "description": "The input month. Negative values represent lunar leap months, such as -6 for leap June.",
+                "enum": [
+                  -12,
+                  -11,
+                  -10,
+                  -9,
+                  -8,
+                  -7,
+                  -6,
+                  -5,
+                  -4,
+                  -3,
+                  -2,
+                  -1,
+                  1,
+                  2,
+                  3,
+                  4,
+                  5,
+                  6,
+                  7,
+                  8,
+                  9,
+                  10,
+                  11,
+                  12
+                ]
+              },
+              "day": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 31,
+                "description": "The input day of month."
+              },
+              "hour": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 23,
+                "description": "The local hour, from 0 to 23."
+              },
+              "minute": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 59,
+                "description": "The minute. Defaults to 0 when unknown.",
+                "default": 0
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "name",
+              "year",
+              "month",
+              "day",
+              "hour"
+            ],
+            "description": "The second person's birth details; in the marriage scenario this is the female partner.",
+            "allOf": [
+              {
+                "if": {
+                  "properties": {
+                    "calendarType": {
+                      "const": "lunar"
+                    }
+                  },
+                  "required": [
+                    "calendarType"
+                  ]
+                },
+                "then": {
+                  "if": {
+                    "properties": {
+                      "month": {
+                        "maximum": -1
+                      }
+                    }
+                  },
+                  "then": {
+                    "properties": {
+                      "year": {
+                        "minimum": 1900,
+                        "maximum": 2100
+                      }
+                    }
+                  }
+                },
+                "else": {
+                  "properties": {
+                    "month": {
+                      "minimum": 1
+                    }
+                  }
+                }
+              }
+            ]
+          },
+          "scoringMode": {
+            "type": "string",
+            "description": "The scoring mode: traditional binary scoring or graded flexible scoring (recommended and the connector default).",
+            "default": "graded",
+            "enum": [
+              "traditional",
+              "graded"
+            ]
+          },
+          "language": {
+            "type": "string",
+            "enum": [
+              "zh-cn",
+              "zh-tw",
+              "en-us"
+            ],
+            "description": "The result language: simplified Chinese, traditional Chinese or English."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "firstPerson",
+          "secondPerson"
+        ],
+        "description": "The two people and scoring options for Bazi compatibility."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "analysis": {
+            "type": "object",
+            "properties": {
+              "male": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The provider's first-person chart, under its native male field."
+              },
+              "female": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The provider's second-person chart, under its native female field."
+              },
+              "all_score": {
+                "type": "number",
+                "description": "The overall matching score returned by the provider."
+              },
+              "master_evaluation": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The provider's combined evaluation and entertainment interpretation."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The complete matching scores, two charts and interpretations returned for the selected scenario."
+          },
+          "notice": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The provider's cultural research and entertainment notice."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The provider's cultural research and entertainment notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "analysis",
+          "notice"
+        ],
+        "description": "The two-person Bazi analysis result."
+      }
+    },
+    {
+      "id": "yuanfenju.convert_calendar",
+      "service": "yuanfenju",
+      "name": "convert_calendar",
+      "description": "Convert Gregorian and Chinese lunar dates in either direction, including negative lunar month numbers for leap months.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "direction": {
+            "type": "string",
+            "enum": [
+              "solar_to_lunar",
+              "lunar_to_solar"
+            ],
+            "description": "The calendar conversion direction."
+          },
+          "year": {
+            "type": "integer",
+            "minimum": 1900,
+            "maximum": 2100,
+            "description": "The year to convert, from 1900 to 2100."
+          },
+          "month": {
+            "type": "integer",
+            "description": "The input month. Negative values represent lunar leap months, such as -6 for leap June.",
+            "enum": [
+              -12,
+              -11,
+              -10,
+              -9,
+              -8,
+              -7,
+              -6,
+              -5,
+              -4,
+              -3,
+              -2,
+              -1,
+              1,
+              2,
+              3,
+              4,
+              5,
+              6,
+              7,
+              8,
+              9,
+              10,
+              11,
+              12
+            ]
+          },
+          "day": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 31,
+            "description": "The input day of month."
+          },
+          "hour": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 23,
+            "description": "The hour to convert. Defaults to 0.",
+            "default": 0
+          },
+          "minute": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 59,
+            "description": "The minute. Defaults to 0 when unknown.",
+            "default": 0
+          },
+          "second": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 59,
+            "description": "The second to convert. Defaults to 0.",
+            "default": 0
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "direction",
+          "year",
+          "month",
+          "day"
+        ],
+        "description": "The date and time to convert between Gregorian and lunar calendars.",
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "direction": {
+                  "const": "solar_to_lunar"
+                }
+              }
+            },
+            "then": {
+              "properties": {
+                "month": {
+                  "minimum": 1
+                }
+              }
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "date": {
+            "type": "object",
+            "properties": {
+              "lunar_year": {
+                "type": "integer",
+                "description": "The lunar year returned by the provider."
+              },
+              "lunar_month": {
+                "type": "integer",
+                "description": "The lunar month returned by the provider."
+              },
+              "lunar_day": {
+                "type": "integer",
+                "description": "The lunar day returned by the provider."
+              },
+              "lunar_hour": {
+                "type": "integer",
+                "description": "The lunar hour returned by the provider."
+              },
+              "lunar_minute": {
+                "type": "integer",
+                "description": "The lunar minute returned by the provider."
+              },
+              "lunar_second": {
+                "type": "integer",
+                "description": "The lunar second returned by the provider."
+              },
+              "solar_year": {
+                "type": "integer",
+                "description": "The solar year returned by the provider."
+              },
+              "solar_month": {
+                "type": "integer",
+                "description": "The solar month returned by the provider."
+              },
+              "solar_day": {
+                "type": "integer",
+                "description": "The solar day returned by the provider."
+              },
+              "solar_hour": {
+                "type": "integer",
+                "description": "The solar hour returned by the provider."
+              },
+              "solar_minute": {
+                "type": "integer",
+                "description": "The solar minute returned by the provider."
+              },
+              "solar_second": {
+                "type": "integer",
+                "description": "The solar second returned by the provider."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The converted lunar and Gregorian date/time fields. Negative lunar_month values indicate leap months."
+          },
+          "notice": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The provider's cultural research and entertainment notice."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The provider's cultural research and entertainment notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "date",
+          "notice"
+        ],
+        "description": "The calendar conversion result."
+      }
+    },
+    {
+      "id": "yuanfenju.find_auspicious_dates",
+      "service": "yuanfenju",
+      "name": "find_auspicious_dates",
+      "description": "Find dates marked suitable for a selected traditional activity within the next 7 days, half month, month or three months, for cultural research and entertainment. Use get_almanac for a selected date's hourly details.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "activityId": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 35,
+            "description": "The official activity ID: 0 moving, 1 renovation, 2 entering a home, 3 engagement/marriage, 4 wedding/registration, 5 seeking children/childbirth, 6 receiving wealth, 7 opening a business, 8 trading, 9 property purchase, 10 earthwork, 11 travel, 12 burial, 13 ancestor rites, 14 prayer, 15 bathing, 16 alliance, 17 son-in-law marriage, 18 grave repair, 19 ground breaking, 20 burial, 21 monument erection, 22 living-person grave construction, 23 coffin preparation, 24 encoffining, 25 coffin transfer, 26 logging, 27 well digging, 28 plaque hanging, 29 planting, 30 school admission, 31 haircut, 32 meeting relatives/friends, 33 taking office, 34 seeking medical care, 35 treatment."
+          },
+          "period": {
+            "type": "string",
+            "description": "The future search period: seven_days (default), half_month, one_month or three_months.",
+            "default": "seven_days",
+            "enum": [
+              "seven_days",
+              "half_month",
+              "one_month",
+              "three_months"
+            ]
+          },
+          "language": {
+            "type": "string",
+            "enum": [
+              "zh-cn",
+              "zh-tw"
+            ],
+            "description": "The result language: simplified or traditional Chinese."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "activityId"
+        ],
+        "description": "The traditional activity and future period for date selection."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "selection": {
+            "type": "object",
+            "properties": {
+              "detail_info": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "yangli": {
+                      "type": "string",
+                      "description": "The Gregorian date."
+                    },
+                    "yinli": {
+                      "type": "string",
+                      "description": "The lunar date display text."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "One matching date's almanac details."
+                },
+                "description": "The dates matching the selected traditional activity."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The full date selection result returned by Yuanfenju."
+          },
+          "notice": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The provider's cultural research and entertainment notice."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The provider's cultural research and entertainment notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "selection",
+          "notice"
+        ],
+        "description": "The traditional date selection result."
+      }
+    },
+    {
+      "id": "yuanfenju.get_account",
+      "service": "yuanfenju",
+      "name": "get_account",
+      "description": "Get the connected Yuanfenju account's membership, expiry and applicable remaining quota. This query does not consume call credits.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "The input for querying the connected account."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "account": {
+            "type": "object",
+            "properties": {
+              "merchant_type": {
+                "type": "string",
+                "description": "The account membership type."
+              },
+              "merchant_email": {
+                "type": "string",
+                "description": "The account registration email."
+              },
+              "merchant_nickname": {
+                "type": "string",
+                "description": "The account nickname."
+              },
+              "merchant_register_time": {
+                "type": "string",
+                "description": "The account registration time."
+              },
+              "merchant_expire_time": {
+                "type": "string",
+                "description": "The annual plan expiration time, or -- when not applicable."
+              },
+              "merchant_remaining_call_times": {
+                "type": "string",
+                "description": "The remaining calls for usage-based and free accounts; annual accounts return --."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The account information returned by Yuanfenju."
+          },
+          "notice": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The provider's cultural research and entertainment notice."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The provider's cultural research and entertainment notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "account",
+          "notice"
+        ],
+        "description": "The account query result."
+      }
+    },
+    {
+      "id": "yuanfenju.get_almanac",
+      "service": "yuanfenju",
+      "name": "get_almanac",
+      "description": "Get the Chinese almanac for a Gregorian date within 90 days before or after today, for cultural research and entertainment.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "date": {
+            "type": "string",
+            "description": "The Gregorian date in YYYY-MM-DD format, within the provider's rolling 90-day window.",
+            "format": "date"
+          },
+          "language": {
+            "type": "string",
+            "enum": [
+              "zh-cn",
+              "zh-tw"
+            ],
+            "description": "The result language: simplified or traditional Chinese."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "date"
+        ],
+        "description": "The date and language for an almanac query."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "almanac": {
+            "type": "object",
+            "properties": {
+              "yangli": {
+                "type": "string",
+                "description": "The Gregorian date."
+              },
+              "yinli": {
+                "type": "string",
+                "description": "The lunar date display text."
+              },
+              "yi": {
+                "type": "string",
+                "description": "The traditional activities marked suitable."
+              },
+              "ji": {
+                "type": "string",
+                "description": "The traditional activities marked unsuitable."
+              },
+              "ganzhi": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The year, month, day and time heavenly stems and earthly branches."
+              },
+              "detail_info": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": true,
+                  "description": "One traditional hourly period's almanac details."
+                },
+                "description": "The twelve traditional hourly period details."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The full Chinese almanac, including lunar date, stems/branches, activities and hourly details."
+          },
+          "notice": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The provider's cultural research and entertainment notice."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The provider's cultural research and entertainment notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "almanac",
+          "notice"
+        ],
+        "description": "The almanac query result."
+      }
+    },
+    {
+      "id": "yuanfenju.get_annual_usage",
+      "service": "yuanfenju",
+      "name": "get_annual_usage",
+      "description": "Get the current 24-hour cycle's used call count and reset timing for a Yuanfenju annual-plan account. This free query is only available to annual members.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "The input for querying annual-plan call usage."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "usage": {
+            "type": "object",
+            "properties": {
+              "call_times": {
+                "description": "The calls already used in the current 24-hour cycle.",
+                "type": [
+                  "string",
+                  "integer"
+                ]
+              },
+              "expire_time": {
+                "type": "integer",
+                "description": "The seconds remaining until the cycle resets. The countdown starts on the first API call."
+              },
+              "expire_time_message": {
+                "type": "string",
+                "description": "The human-readable remaining-time message."
+              },
+              "reset_time": {
+                "type": "string",
+                "description": "The estimated quota reset timestamp."
+              },
+              "reset_time_message": {
+                "type": "string",
+                "description": "The human-readable quota reset message."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The annual-plan call count and reset information returned by Yuanfenju."
+          },
+          "notice": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The provider's cultural research and entertainment notice."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The provider's cultural research and entertainment notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "usage",
+          "notice"
+        ],
+        "description": "The annual-plan usage query result."
+      }
+    },
+    {
+      "id": "yuanfenju.get_bazi_chart",
+      "service": "yuanfenju",
+      "name": "get_bazi_chart",
+      "description": "Calculate a standard Bazi chart with four pillars, five elements and luck cycles for cultural research and entertainment. Lunar dates in 1900-2100 are converted first, including leap months, using an additional API call. Other non-leap lunar dates use native lunar input.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The name displayed on the chart.",
+            "pattern": "\\S"
+          },
+          "sex": {
+            "type": "string",
+            "enum": [
+              "male",
+              "female"
+            ],
+            "description": "The sex used by the provider's traditional chart calculation."
+          },
+          "calendarType": {
+            "type": "string",
+            "description": "The input calendar. Defaults to solar (Gregorian).",
+            "default": "solar",
+            "enum": [
+              "solar",
+              "lunar"
+            ]
+          },
+          "year": {
+            "type": "integer",
+            "description": "The input year."
+          },
+          "month": {
+            "type": "integer",
+            "description": "The input month. Negative values represent lunar leap months, such as -6 for leap June.",
+            "enum": [
+              -12,
+              -11,
+              -10,
+              -9,
+              -8,
+              -7,
+              -6,
+              -5,
+              -4,
+              -3,
+              -2,
+              -1,
+              1,
+              2,
+              3,
+              4,
+              5,
+              6,
+              7,
+              8,
+              9,
+              10,
+              11,
+              12
+            ]
+          },
+          "day": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 31,
+            "description": "The input day of month."
+          },
+          "hour": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 23,
+            "description": "The local hour, from 0 to 23."
+          },
+          "minute": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 59,
+            "description": "The minute. Defaults to 0 when unknown.",
+            "default": 0
+          },
+          "sect": {
+            "type": "integer",
+            "description": "The late Zi-hour convention: 1 uses the next day's pillar; 2 uses the same day (default).",
+            "default": 2,
+            "enum": [
+              1,
+              2
+            ]
+          },
+          "trueSolarTime": {
+            "type": "string",
+            "description": "The true solar time mode: none (default), china using province/city, or global using coordinates/timezone.",
+            "default": "none",
+            "enum": [
+              "none",
+              "china",
+              "global"
+            ]
+          },
+          "province": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The Chinese province required for china true solar time.",
+            "pattern": "\\S"
+          },
+          "city": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The Chinese city required for china true solar time. Use the official Yuanfenju place names.",
+            "pattern": "\\S"
+          },
+          "longitude": {
+            "type": "number",
+            "minimum": -180,
+            "maximum": 180,
+            "description": "The longitude required for global true solar time, with at most six decimal places."
+          },
+          "latitude": {
+            "type": "number",
+            "minimum": -90,
+            "maximum": 90,
+            "description": "The latitude required for global true solar time, with at most six decimal places."
+          },
+          "timezone": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The birth location IANA timezone for global true solar time. Defaults to Asia/Shanghai.",
+            "pattern": "\\S"
+          },
+          "language": {
+            "type": "string",
+            "enum": [
+              "zh-cn",
+              "zh-tw"
+            ],
+            "description": "The result language: simplified or traditional Chinese."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "name",
+          "sex",
+          "year",
+          "month",
+          "day",
+          "hour"
+        ],
+        "description": "The birth details for a standard Bazi chart.",
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "trueSolarTime": {
+                  "const": "china"
+                }
+              },
+              "required": [
+                "trueSolarTime"
+              ]
+            },
+            "then": {
+              "required": [
+                "province",
+                "city"
+              ]
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "trueSolarTime": {
+                  "const": "global"
+                }
+              },
+              "required": [
+                "trueSolarTime"
+              ]
+            },
+            "then": {
+              "required": [
+                "longitude",
+                "latitude"
+              ]
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "calendarType": {
+                  "const": "lunar"
+                }
+              },
+              "required": [
+                "calendarType"
+              ]
+            },
+            "then": {
+              "if": {
+                "properties": {
+                  "month": {
+                    "maximum": -1
+                  }
+                }
+              },
+              "then": {
+                "properties": {
+                  "year": {
+                    "minimum": 1900,
+                    "maximum": 2100
+                  }
+                }
+              }
+            },
+            "else": {
+              "properties": {
+                "month": {
+                  "minimum": 1
+                }
+              }
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "chart": {
+            "type": "object",
+            "properties": {
+              "base_info": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The birth details, chart classification and five-element analysis."
+              },
+              "detail_info": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The four pillars, childhood period and major/yearly luck cycles."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The complete standard Bazi chart, including all provider-defined fields."
+          },
+          "notice": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The provider's cultural research and entertainment notice."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The provider's cultural research and entertainment notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "chart",
+          "notice"
+        ],
+        "description": "The standard Bazi chart result."
+      }
+    },
+    {
+      "id": "yuanfenju.get_natal_chart",
+      "service": "yuanfenju",
+      "name": "get_natal_chart",
+      "description": "Calculate a Western astrology natal chart from the original Gregorian local birth time for cultural research and entertainment. Returns celestial data, official interpretations and the SVG chart when provided. The provider handles timezone/DST and transport compression; no true solar time correction is applied.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "year": {
+            "type": "integer",
+            "description": "The input year."
+          },
+          "month": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 12,
+            "description": "The input month, 1 to 12."
+          },
+          "day": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 31,
+            "description": "The input day of month."
+          },
+          "hour": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 23,
+            "description": "The local hour, from 0 to 23."
+          },
+          "minute": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 59,
+            "description": "The minute. Defaults to 0 when unknown.",
+            "default": 0
+          },
+          "sex": {
+            "type": "string",
+            "enum": [
+              "male",
+              "female"
+            ],
+            "description": "The sex used by the provider's traditional chart calculation."
+          },
+          "longitude": {
+            "type": "number",
+            "minimum": -180,
+            "maximum": 180,
+            "description": "The birth longitude, at most six decimal places. If omitted, the provider uses Beijing longitude."
+          },
+          "latitude": {
+            "type": "number",
+            "minimum": -90,
+            "maximum": 90,
+            "description": "The birth latitude, at most six decimal places. If omitted, the provider uses Beijing latitude."
+          },
+          "timezone": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The IANA timezone of the original local birth time. Defaults to Asia/Shanghai; the provider handles historical daylight saving time.",
+            "default": "Asia/Shanghai",
+            "pattern": "\\S"
+          },
+          "houseSystem": {
+            "type": "string",
+            "description": "The house system code. Defaults to P (Placidus).",
+            "default": "P",
+            "enum": [
+              "P",
+              "K",
+              "O",
+              "R",
+              "C",
+              "A",
+              "E",
+              "W",
+              "T",
+              "M",
+              "B",
+              "X",
+              "V"
+            ]
+          },
+          "additionalObjects": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 16,
+              "description": "One additional celestial object ID."
+            },
+            "description": "Additional celestial objects: 1 Vertex, 2 Chiron, 3 Ceres, 4 Pallas, 5 Juno, 6 Vesta, 7 Part of Fortune, 8 true Node, 9 mean Lilith, 10 Psyche, 11 Eros, 12 Haumea, 13 Eris, 14 Makemake, 15 mean Node, 16 south Node.",
+            "uniqueItems": true
+          },
+          "orbModel": {
+            "type": "string",
+            "description": "The aspect orb model: strict, standard (default), wide or custom.",
+            "default": "standard",
+            "enum": [
+              "strict",
+              "standard",
+              "wide",
+              "custom"
+            ]
+          },
+          "customOrbs": {
+            "type": "object",
+            "properties": {
+              "conjunction": {
+                "type": "number",
+                "description": "The conjunction orb (0-degree aspect). The official default is 8 degrees."
+              },
+              "semisextile": {
+                "type": "number",
+                "description": "The semisextile orb (30-degree aspect). The official default is 2 degrees."
+              },
+              "sextile": {
+                "type": "number",
+                "description": "The sextile orb (60-degree aspect). The official default is 6 degrees."
+              },
+              "square": {
+                "type": "number",
+                "description": "The square orb (90-degree aspect). The official default is 6 degrees."
+              },
+              "trine": {
+                "type": "number",
+                "description": "The trine orb (120-degree aspect). The official default is 6 degrees."
+              },
+              "quincunx": {
+                "type": "number",
+                "description": "The quincunx orb (150-degree aspect). The official default is 3 degrees."
+              },
+              "opposition": {
+                "type": "number",
+                "description": "The opposition orb (180-degree aspect). The official default is 8 degrees."
+              }
+            },
+            "additionalProperties": false,
+            "description": "Custom aspect orbs in degrees, used only with orbModel=custom. Omitted values use the official defaults."
+          },
+          "language": {
+            "type": "string",
+            "enum": [
+              "zh-cn",
+              "zh-tw",
+              "en-us"
+            ],
+            "description": "The result language: simplified Chinese, traditional Chinese or English."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "year",
+          "month",
+          "day",
+          "hour",
+          "sex"
+        ],
+        "description": "The Gregorian birth details and Western astrology chart options. Use the original local time, not true solar time.",
+        "allOf": [
+          {
+            "if": {
+              "required": [
+                "customOrbs"
+              ]
+            },
+            "then": {
+              "properties": {
+                "orbModel": {
+                  "const": "custom"
+                }
+              },
+              "required": [
+                "orbModel"
+              ]
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "chart": {
+            "type": "object",
+            "properties": {
+              "base_info": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The natal chart's birth details and calculation settings."
+              },
+              "detail_info": {
+                "type": "object",
+                "properties": {
+                  "chart_data": {
+                    "type": "object",
+                    "properties": {},
+                    "additionalProperties": true,
+                    "description": "The houses, celestial objects, aspects, statistics and chart patterns."
+                  },
+                  "chart_description": {
+                    "type": "object",
+                    "properties": {},
+                    "additionalProperties": true,
+                    "description": "The official natal chart interpretations in the requested language."
+                  },
+                  "chart_svg": {
+                    "type": "string",
+                    "description": "The SVG chart source returned by the provider."
+                  }
+                },
+                "additionalProperties": true,
+                "description": "The celestial data, official interpretations and SVG chart."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The full natal chart returned by Yuanfenju."
+          },
+          "notice": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The provider's cultural research and entertainment notice."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The provider's cultural research and entertainment notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "chart",
+          "notice"
+        ],
+        "description": "The Western astrology natal chart result."
+      }
+    },
+    {
+      "id": "yuanfenju.get_solar_terms",
+      "service": "yuanfenju",
+      "name": "get_solar_terms",
+      "description": "Get the year's 12 seasonal nodes or all 24 solar terms with Gregorian and lunar timestamps for the supplied date.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "calendarType": {
+            "type": "string",
+            "description": "The input calendar. Defaults to solar (Gregorian).",
+            "default": "solar",
+            "enum": [
+              "solar",
+              "lunar"
+            ]
+          },
+          "year": {
+            "type": "integer",
+            "description": "The input year."
+          },
+          "month": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 12,
+            "description": "The input month, 1 to 12."
+          },
+          "day": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 31,
+            "description": "The input day of month."
+          },
+          "includeAllTerms": {
+            "type": "boolean",
+            "description": "Whether to return all 24 solar terms. Defaults to false, returning 12 seasonal nodes.",
+            "default": false
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "year",
+          "month",
+          "day"
+        ],
+        "description": "The reference date and solar term selection."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "terms": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "jieqi_name": {
+                  "type": "string",
+                  "description": "The solar term name."
+                },
+                "jieqi_simple_time": {
+                  "type": "string",
+                  "description": "The Gregorian date of the solar term."
+                },
+                "jieqi_detail_time": {
+                  "type": "string",
+                  "description": "The Gregorian date and precise time."
+                },
+                "jieqi_lunar_time_isleap": {
+                  "type": "string",
+                  "description": "Whether the lunar date is in a leap month: 1 yes, 0 no."
+                },
+                "jieqi_simple_lunar_time": {
+                  "type": "string",
+                  "description": "The lunar date of the solar term."
+                },
+                "jieqi_detail_lunar_time": {
+                  "type": "string",
+                  "description": "The lunar date and precise time."
+                }
+              },
+              "additionalProperties": true,
+              "description": "One solar term with Gregorian and lunar date/time representations."
+            },
+            "description": "The year's solar terms returned by Yuanfenju."
+          },
+          "notice": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The provider's cultural research and entertainment notice."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The provider's cultural research and entertainment notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "terms",
+          "notice"
+        ],
+        "description": "The solar term query result."
+      }
+    },
+    {
+      "id": "yuanfenju.get_ziwei_chart",
+      "service": "yuanfenju",
+      "name": "get_ziwei_chart",
+      "description": "Calculate a Ziwei Doushu chart with twelve palaces and star placements for cultural research and entertainment. Lunar dates in 1900-2100 are converted first using an additional call; other non-leap lunar dates use native input.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The name displayed on the chart.",
+            "pattern": "\\S"
+          },
+          "sex": {
+            "type": "string",
+            "enum": [
+              "male",
+              "female"
+            ],
+            "description": "The sex used by the provider's traditional chart calculation."
+          },
+          "calendarType": {
+            "type": "string",
+            "description": "The input calendar. Defaults to solar (Gregorian).",
+            "default": "solar",
+            "enum": [
+              "solar",
+              "lunar"
+            ]
+          },
+          "year": {
+            "type": "integer",
+            "description": "The input year."
+          },
+          "month": {
+            "type": "integer",
+            "description": "The input month. Negative values represent lunar leap months, such as -6 for leap June.",
+            "enum": [
+              -12,
+              -11,
+              -10,
+              -9,
+              -8,
+              -7,
+              -6,
+              -5,
+              -4,
+              -3,
+              -2,
+              -1,
+              1,
+              2,
+              3,
+              4,
+              5,
+              6,
+              7,
+              8,
+              9,
+              10,
+              11,
+              12
+            ]
+          },
+          "day": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 31,
+            "description": "The input day of month."
+          },
+          "hour": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 23,
+            "description": "The local hour, from 0 to 23."
+          },
+          "minute": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 59,
+            "description": "The minute. Defaults to 0 when unknown.",
+            "default": 0
+          },
+          "sect": {
+            "type": "integer",
+            "description": "The late Zi-hour convention: 1 uses the next day's pillar; 2 uses the same day (default).",
+            "default": 2,
+            "enum": [
+              1,
+              2
+            ]
+          },
+          "trueSolarTime": {
+            "type": "string",
+            "description": "The true solar time mode: none (default), china using province/city, or global using coordinates/timezone.",
+            "default": "none",
+            "enum": [
+              "none",
+              "china",
+              "global"
+            ]
+          },
+          "province": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The Chinese province required for china true solar time.",
+            "pattern": "\\S"
+          },
+          "city": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The Chinese city required for china true solar time. Use the official Yuanfenju place names.",
+            "pattern": "\\S"
+          },
+          "longitude": {
+            "type": "number",
+            "minimum": -180,
+            "maximum": 180,
+            "description": "The longitude required for global true solar time, with at most six decimal places."
+          },
+          "latitude": {
+            "type": "number",
+            "minimum": -90,
+            "maximum": 90,
+            "description": "The latitude required for global true solar time, with at most six decimal places."
+          },
+          "timezone": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The birth location IANA timezone for global true solar time. Defaults to Asia/Shanghai.",
+            "pattern": "\\S"
+          },
+          "language": {
+            "type": "string",
+            "enum": [
+              "zh-cn",
+              "zh-tw"
+            ],
+            "description": "The result language: simplified or traditional Chinese."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "name",
+          "sex",
+          "year",
+          "month",
+          "day",
+          "hour"
+        ],
+        "description": "The birth details and true solar time options for a Ziwei chart.",
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "trueSolarTime": {
+                  "const": "china"
+                }
+              },
+              "required": [
+                "trueSolarTime"
+              ]
+            },
+            "then": {
+              "required": [
+                "province",
+                "city"
+              ]
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "trueSolarTime": {
+                  "const": "global"
+                }
+              },
+              "required": [
+                "trueSolarTime"
+              ]
+            },
+            "then": {
+              "required": [
+                "longitude",
+                "latitude"
+              ]
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "calendarType": {
+                  "const": "lunar"
+                }
+              },
+              "required": [
+                "calendarType"
+              ]
+            },
+            "then": {
+              "if": {
+                "properties": {
+                  "month": {
+                    "maximum": -1
+                  }
+                }
+              },
+              "then": {
+                "properties": {
+                  "year": {
+                    "minimum": 1900,
+                    "maximum": 2100
+                  }
+                }
+              }
+            },
+            "else": {
+              "properties": {
+                "month": {
+                  "minimum": 1
+                }
+              }
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "chart": {
+            "type": "object",
+            "properties": {
+              "base_info": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The Ziwei birth details and basic chart information."
+              },
+              "gong_pan": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": true,
+                  "description": "One Ziwei palace's stars and associated chart details."
+                },
+                "description": "The twelve palaces in the provider's original order (indices 0 to 11)."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The complete Ziwei chart, preserving all provider-defined chart and interpretation fields."
+          },
+          "notice": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The provider's cultural research and entertainment notice."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The provider's cultural research and entertainment notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "chart",
+          "notice"
+        ],
+        "description": "The Ziwei Doushu chart result."
+      }
+    },
+    {
+      "id": "yuanfenju.interpret_bazi",
+      "service": "yuanfenju",
+      "name": "interpret_bazi",
+      "description": "Get Yuanfenju's official Bazi interpretation for cultural research and entertainment, including five-element, relationship, wealth and life interpretation text. Lunar dates in 1900-2100 are converted first using an additional call; other non-leap lunar dates use native input.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The name displayed on the chart.",
+            "pattern": "\\S"
+          },
+          "sex": {
+            "type": "string",
+            "enum": [
+              "male",
+              "female"
+            ],
+            "description": "The sex used by the provider's traditional chart calculation."
+          },
+          "calendarType": {
+            "type": "string",
+            "description": "The input calendar. Defaults to solar (Gregorian).",
+            "default": "solar",
+            "enum": [
+              "solar",
+              "lunar"
+            ]
+          },
+          "year": {
+            "type": "integer",
+            "description": "The input year."
+          },
+          "month": {
+            "type": "integer",
+            "description": "The input month. Negative values represent lunar leap months, such as -6 for leap June.",
+            "enum": [
+              -12,
+              -11,
+              -10,
+              -9,
+              -8,
+              -7,
+              -6,
+              -5,
+              -4,
+              -3,
+              -2,
+              -1,
+              1,
+              2,
+              3,
+              4,
+              5,
+              6,
+              7,
+              8,
+              9,
+              10,
+              11,
+              12
+            ]
+          },
+          "day": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 31,
+            "description": "The input day of month."
+          },
+          "hour": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 23,
+            "description": "The local hour, from 0 to 23."
+          },
+          "minute": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 59,
+            "description": "The minute. Defaults to 0 when unknown.",
+            "default": 0
+          },
+          "sect": {
+            "type": "integer",
+            "description": "The late Zi-hour convention: 1 uses the next day's pillar (default for interpretation); 2 uses the same day.",
+            "default": 1,
+            "enum": [
+              1,
+              2
+            ]
+          },
+          "trueSolarTime": {
+            "type": "string",
+            "description": "The true solar time mode: none (default), china using province/city, or global using coordinates/timezone.",
+            "default": "none",
+            "enum": [
+              "none",
+              "china",
+              "global"
+            ]
+          },
+          "province": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The Chinese province required for china true solar time.",
+            "pattern": "\\S"
+          },
+          "city": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The Chinese city required for china true solar time. Use the official Yuanfenju place names.",
+            "pattern": "\\S"
+          },
+          "longitude": {
+            "type": "number",
+            "minimum": -180,
+            "maximum": 180,
+            "description": "The longitude required for global true solar time, with at most six decimal places."
+          },
+          "latitude": {
+            "type": "number",
+            "minimum": -90,
+            "maximum": 90,
+            "description": "The latitude required for global true solar time, with at most six decimal places."
+          },
+          "timezone": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The birth location IANA timezone for global true solar time. Defaults to Asia/Shanghai.",
+            "pattern": "\\S"
+          },
+          "language": {
+            "type": "string",
+            "enum": [
+              "zh-cn",
+              "zh-tw",
+              "en-us"
+            ],
+            "description": "The result language: simplified Chinese, traditional Chinese or English."
+          },
+          "adjustInterpretations": {
+            "type": "boolean",
+            "description": "Whether to apply the provider's adjustment factor to reduce repetition in relationship, wealth and life interpretation text. Defaults to false.",
+            "default": false
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "name",
+          "sex",
+          "year",
+          "month",
+          "day",
+          "hour"
+        ],
+        "description": "The birth details and options for an official Bazi interpretation.",
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "trueSolarTime": {
+                  "const": "china"
+                }
+              },
+              "required": [
+                "trueSolarTime"
+              ]
+            },
+            "then": {
+              "required": [
+                "province",
+                "city"
+              ]
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "trueSolarTime": {
+                  "const": "global"
+                }
+              },
+              "required": [
+                "trueSolarTime"
+              ]
+            },
+            "then": {
+              "required": [
+                "longitude",
+                "latitude"
+              ]
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "calendarType": {
+                  "const": "lunar"
+                }
+              },
+              "required": [
+                "calendarType"
+              ]
+            },
+            "then": {
+              "if": {
+                "properties": {
+                  "month": {
+                    "maximum": -1
+                  }
+                }
+              },
+              "then": {
+                "properties": {
+                  "year": {
+                    "minimum": 1900,
+                    "maximum": 2100
+                  }
+                }
+              }
+            },
+            "else": {
+              "properties": {
+                "month": {
+                  "minimum": 1
+                }
+              }
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "reading": {
+            "type": "object",
+            "properties": {
+              "base_info": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The interpreted chart's birth details and basic information."
+              },
+              "bazi_info": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The four-pillar chart information accompanying the interpretation."
+              },
+              "wuxing": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The official five-element interpretation."
+              },
+              "yinyuan": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The official relationship interpretation for entertainment."
+              },
+              "caiyun": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The official wealth interpretation for entertainment."
+              },
+              "mingyun": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The official life interpretation for entertainment."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The full official Bazi interpretation, including all provider-defined sections."
+          },
+          "notice": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The provider's cultural research and entertainment notice."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The provider's cultural research and entertainment notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "reading",
+          "notice"
+        ],
+        "description": "The official Bazi interpretation result."
+      }
+    },
+    {
+      "id": "yuanfenju.interpret_tarot",
+      "service": "yuanfenju",
+      "name": "interpret_tarot",
+      "description": "Draw and interpret a full-deck tarot spread for entertainment using the current Yuanfenju interface. Drawing is automatic; paid membership is required.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "spreadId": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 17,
+            "description": "The spread: 1 single card, 2 choice, 3 holy triangle, 4 time arrow, 5 four elements, 6 lover pyramid, 7 five elements, 8 lovers, 9 cross, 10 hexagram, 11 compound, 12 seven planets, 13 nine-grid, 14 deep relationship, 15 Celtic cross, 16 tree of life, 17 annual cycle."
+          },
+          "topicId": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 5,
+            "description": "The topic: 1 love/marriage, 2 work/study, 3 relationships/wealth, 4 health/lifestyle, 5 general."
+          },
+          "language": {
+            "type": "string",
+            "enum": [
+              "zh-cn",
+              "zh-tw",
+              "en-us"
+            ],
+            "description": "The tarot result language: simplified Chinese, traditional Chinese or English."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "spreadId",
+          "topicId"
+        ],
+        "description": "The tarot spread and interpretation topic."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "reading": {
+            "type": "object",
+            "properties": {
+              "cards": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "positions_index": {
+                      "type": "integer",
+                      "description": "The card position index, starting at 1."
+                    },
+                    "positions_name": {
+                      "type": "string",
+                      "description": "The card position name."
+                    },
+                    "positions_desc": {
+                      "type": "string",
+                      "description": "The meaning of this position in the spread."
+                    },
+                    "orientation_code": {
+                      "type": "integer",
+                      "description": "The card orientation: 1 upright or 0 reversed."
+                    },
+                    "orientation_text": {
+                      "type": "string",
+                      "description": "The card orientation display text."
+                    },
+                    "card_no": {
+                      "type": "integer",
+                      "description": "The tarot card number, from 1 to 78."
+                    },
+                    "card_name": {
+                      "type": "string",
+                      "description": "The tarot card name."
+                    },
+                    "card_keywords": {
+                      "type": "string",
+                      "description": "The card keywords."
+                    },
+                    "card_astrology": {
+                      "type": "string",
+                      "description": "The card's astrological association."
+                    },
+                    "card_element": {
+                      "type": "string",
+                      "description": "The card's elemental association."
+                    },
+                    "card_description": {
+                      "type": "string",
+                      "description": "The card illustration description."
+                    },
+                    "card_interpretation": {
+                      "type": "object",
+                      "properties": {
+                        "general": {
+                          "type": "string",
+                          "description": "The general card interpretation."
+                        },
+                        "topic": {
+                          "type": "string",
+                          "description": "The interpretation for the selected topic."
+                        },
+                        "advice": {
+                          "type": "string",
+                          "description": "The entertainment interpretation advice."
+                        }
+                      },
+                      "additionalProperties": true,
+                      "description": "The card's general meaning, topic interpretation and advice."
+                    },
+                    "image_id": {
+                      "type": "integer",
+                      "description": "The card image resource index."
+                    },
+                    "image_url": {
+                      "type": "string",
+                      "description": "The card image URL."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "A drawn tarot card with its position, orientation, interpretation and image."
+                },
+                "description": "The automatically drawn tarot cards."
+              },
+              "overall_interpretation": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The combined reading and oracle message."
+              },
+              "environment": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "The calculation time and associated cultural context."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The complete tarot reading returned by Yuanfenju."
+          },
+          "notice": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The provider's cultural research and entertainment notice."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The provider's cultural research and entertainment notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "reading",
+          "notice"
+        ],
+        "description": "The tarot reading result."
+      }
+    }
+  ]
+}