birthdata_capabilities
ChatGPTUse this when you need to inspect Astrofaith's saved birth-data contract, available fields, effective permissions, and concurrency requirements before using other saved-data tools.
Other
Overview
Astrofaith resolves locations, calculates authoritative astrology charts and transit comparisons, finds planet-in-house transit periods, and securely manages the connected member's saved birth profiles.
Tools
birthdata_create
ChatGPTUse this when the user explicitly asks to create a saved birth-data profile. Search for duplicates first, preserve supplied provenance, and use a unique idempotencyKey so a retried request does not create a duplicate.
birthdata_delete
ChatGPTUse this when the user explicitly confirms permanent deletion of one saved birth-data profile. Read it immediately first and supply the returned ETag in ifMatch. This action cannot be undone through the plugin.
birthdata_get
ChatGPTUse this when you need to read one connected-member birth-data profile by ID. The result includes its current ETag for a later safe update or deletion. Do not use it to modify the profile.
birthdata_groups
ChatGPTUse this when you need to list the connected member's saved birth-data groups and their IDs before filtering or assigning a profile. Do not use it to modify groups.
birthdata_list
ChatGPTUse this when you need to list or search the connected member's saved birth-data profiles. The optional search matches names, places, groups, dates, and times. Do not use it to modify records.
birthdata_update
ChatGPTUse this when the user explicitly asks to update one saved birth-data profile. Read it immediately first and supply the returned ETag in ifMatch so newer changes are not overwritten.
calculate_bazi
ChatGPTUse this when you need to calculate Four Pillars, ten gods, five elements and luck cycles using Swiss Ephemeris solar terms. Supply birth or profileId, never both; a saved profile also requires birthdata:read. Explicit rules select solar time and day boundaries. Reuse this result with calculate_yi({bazi: result.data}) for Heluo Lishu from the same pillars. Optional sex selects a traditional male/female calculation convention independently of gender identity; omit it to compare both luck variants. Comparison annual sequences are opt-in through annualCount or annualStartYear. Never infer the convention from a saved profile's gender. For interpretation, first check rules_capabilities and, when read access is granted, list_rules even if rules were not mentioned. Resolve the choice and read get_rule before choosing reading settings or interpreting. Skip automatic lookup for calculation-only requests or a user opt-out/different requested method.
calculate_chart
ChatGPTUse this when you need an authoritative Astrofaith natal chart calculated with the Swiss Ephemeris engine. Provide either one saved profileId or one explicit birth object, never both. A profileId also requires birthdata:read access. For interpretation, first check rules_capabilities and, when read access is granted, list_rules even if rules were not mentioned. Resolve the choice and read get_rule before choosing reading settings or interpreting. Skip automatic lookup for calculation-only requests or a user opt-out/different requested method.
calculate_transit_comparison
ChatGPTUse this when you need an authoritative Astrofaith bi-wheel comparison between a saved natal profile and an explicit transit chart. It returns the inner and outer charts plus cross-chart aspects as one result. Resolve an ambiguous transit location first. For interpretation, first check rules_capabilities and, when read access is granted, list_rules even if rules were not mentioned. Resolve the choice and read get_rule before choosing reading settings or interpreting. Skip automatic lookup for calculation-only requests or a user opt-out/different requested method.
calculate_workspace
ChatGPTUse this when you need a single chart or bi-wheel transit, secondary progression, Solar Arc or Solar Return using the API workspace contract. Each wheel accepts explicit birth data or an owned profileId; saved profiles additionally require birthdata:read. Supply the outer target date/time/location and solarReturnYear for a return; the engine finds the return moment. Use output.view compact for concise readings or full for reusable settings. This does not change the user's saved data or browser workspace. For interpretation, first check rules_capabilities and, when read access is granted, list_rules even if rules were not mentioned. Resolve the choice and read get_rule before choosing reading settings or interpreting. Skip automatic lookup for calculation-only requests or a user opt-out/different requested method.
calculate_yi
ChatGPTUse this when you need Yi Astrology — Heluo Lishu (河洛理数): heaven/earth numbers, pre/post-heaven hexagrams, Yuan Tang and line/year cycles. Supply exactly one of birth, profileId or bazi. Reuse calculated pillars with calculate_yi({bazi: baziResult.data}); do not pass the response envelope or wrap it in data. bazi needs pillars and calendar.solarYear/solarHalfYear and performs no birth-date recalculation. Retained sex and annual controls are inherited; conflicting outer controls are rejected. A profileId also requires birthdata:read. Optional sex selects a traditional convention independently of gender identity; omit it from both the request and retained bazi data to compare both. Comparison annual sequences are opt-in through annualCount or annualStartYear. Never infer sex from profile gender. Results identify the classical edition and special-case rules. For interpretation, first check rules_capabilities and, when read access is granted, list_rules even if rules were not mentioned. Resolve the choice and read get_rule before choosing reading settings or interpreting. Skip automatic lookup for calculation-only requests or a user opt-out/different requested method.
dignities_capabilities
ChatGPTUse this when you need to inspect the canonical schema, defaults, granted permissions and safe-write requirements for planetary dignity settings. Includes sign-based domicile, exaltation, detriment and fall assignments. This returns generic capabilities without revealing saved personal settings.
find_longitude_crossings
ChatGPTUse this when you need strict previous, at-reference and next crossings of a selected planet through one absolute zodiac longitude, using Swiss Ephemeris and explicit search bounds. Repeated direct/retrograde passes remain distinct. This is a longitude search, not an exhaustive transit-aspect interval search; honour not-found/search-limit results.
find_longitude_event
ChatGPTUse this when you need the next or previous crossing, touch or uncertain station candidate for a planet and target longitude. Always report status and quality.nearestEventEstablished. A candidate need not reach the target; Df identifies search uncertainty, not a measured position error. To continue, choose a startUtc strictly beyond the returned event in the search direction.
find_transit_house_periods
ChatGPTUse this when you need the exact intervals in an inclusive date range when one transiting planet occupies a selected natal house. Supply either profileId (requires birthdata:read) or explicit natal birth/options, without saving a profile. It returns refined ingress and egress times and repeated retrograde crossings; do not approximate this by sampling separate charts.
orbs_capabilities
ChatGPTUse this when you need to inspect the canonical schema, defaults, granted permissions and safe-write requirements for aspect and orb settings. Includes enabled aspects, orb tolerances, out-of-sign rules and profile assignments. This returns generic capabilities without revealing saved personal settings.
resolve_location
ChatGPTUse this when a place name must be resolved to canonical candidate labels, coordinates, countries, regions, and IANA timezones before saving birth data or calculating a chart. Ask the user to choose when results are ambiguous.
reverse_bazi
ChatGPTUse this when you need all time intervals matching four Bazi pillars in an inclusive year range. Supply location and rules when known; omitted location uses a disclosed UTC+08:00 reference clock, never an inferred birthplace. Returned representatives are samples within intervals, not proven exact birth times. A representative can be passed into calculate_bazi for confirmation.
rules_capabilities
ChatGPTUse this when preparing a chart interpretation to check saved-rule read access, or to inspect the rules schema, account limits and safe-write requirements. Returns generic capabilities without revealing saved rules. For interpretation, first check rules_capabilities and, when read access is granted, list_rules even if rules were not mentioned. Resolve the choice and read get_rule before choosing reading settings or interpreting. Skip automatic lookup for calculation-only requests or a user opt-out/different requested method.
theme_capabilities
ChatGPTUse this when you need to inspect the shared Astrofaith colour/font schema, defaults, granted appearance permissions and safe-write requirements without reading the saved personal theme. Sizes, spacing and layout cannot be customised.
Capabilities
Writes
Example Prompts
Click any prompt to copy it.
Links
App Stats
21
Tools
3
Prompts
ChatGPT
Platforms
Category
Personal ReadingsWorks with
ChatGPT
Similar Apps
Data refreshed daily