add_note
ChatGPTCreate a note on a saved chart. Timeline notes (CHART_TRANSITS, SECONDARY_PROGRESSIONS, SOLAR_RETURN, LUNAR_RETURN) require event_date; SYNASTRY and COMPOSITE_CHART require secondary_chart; NATAL and DRACONIC_CHART need neither. A chart has exactly one NATAL note.
create_folder
ChatGPTCreate a new chart folder. Folder names are unique per account; creating a name that already exists is an error (use the existing folder instead — move_charts also creates missing folders on its own).
delete_note
ChatGPTPermanently delete a chart note. This cannot be undone — always confirm with the user before calling this tool.
get_biwheel
ChatGPTA biwheel over a saved chart (transits, secondary progressions, solar/lunar return, or draconic). Returns both wheels and the cross-chart aspects as the same text the in-app copy button produces. time is the transit/progression moment or return anchor (default: now; solar_return defaults to the most recent birthday); it does not apply to draconic. location overrides the transit location (defaults to the chart’s saved transit location). A settings profile pinned to the chart applies. When the user has Profections enabled, the transits/progressions/return output carries a Profections section right after the root chart’s header: the annual (and, if enabled, monthly) profected sign, its whole-sign house, and its lord as of the wheel’s moment. Use this to answer profection questions for a given date.
get_chart
ChatGPTA saved chart's calculated data (placement positions, aspects, and aspected fixed stars) as the same text the in-app copy button produces, using the user's saved settings (a settings profile pinned to the chart applies, as in the app). When the user has Profections enabled, the output carries a Profections section right after the chart header: the annual (and, if enabled, monthly) profected sign, its whole-sign house, and its lord as of today. For the profections of another date use get_biwheel.
get_composite
ChatGPTThe midpoint composite chart of two saved charts (one derived wheel with its own placements and aspects) as the same text the in-app copy button produces. A settings profile pinned to chart_a applies.
get_note
ChatGPTA single note in full: metadata plus the body as Markdown (images come back as Markdown image links with their full URL; astrological glyphs as their text token, e.g. ☉ or :shortcode:).
get_synastry
ChatGPTSynastry between two saved charts (both charts’ placements and the cross-chart aspects) as the same text the in-app copy button produces. chart_a is the root (houses) chart; a settings profile pinned to chart_a applies.
get_transits
ChatGPTThe current sky (realtime transits) as chart text. Defaults to now at the user's home location; pass time and/or location to look elsewhere or elsewhen. The resolved location and UTC offset are echoed in the header.
get_vimshottari_dasha
ChatGPTVimshottari dasha periods for a saved chart, starting from the nakshatra of the Moon (or the Ascendant, per the user's setting or start_from). Returns the nested period levels around a query date: level 1 Mahadashas of 6 to 20 years (the first starts at birth with its remaining balance), then Antardasha, Pratyantardasha, Sookshma, and Prana sub-periods, each a proportional subdivision of its parent. Nakshatras are sidereal, so a tropical chart's starting longitude is shifted by the user's ayanamsha. An active marker shows the period containing the query date at each level. A settings profile pinned to the chart applies.
get_zodiacal_releasing
ChatGPTZodiacal releasing periods for a saved chart, released from a hermetic lot (the user's setting by default, usually Lot of Fortune). Returns the nested period levels around a query date: level 1 spans life chapters of years, cascading down to level 5's sub-periods of hours. Annotations: peak periods (1st/4th/7th/10th from Fortune), Culminating (10th from that level's starting sign), Completion (return to that level's starting sign), LB (loosing of the bond, a jump to the opposite sign), and an active marker on the period containing the query date at each level. A settings profile pinned to the chart applies.
list_charts
ChatGPTList the user's saved charts (name, birth date/time, location, folder). Supports name search, folder filtering, and pagination; total is the full count of matching charts regardless of pagination.
list_folders
ChatGPTThe user's chart folders with per-folder chart counts, plus the number of unfiled charts (in no folder) and the total chart count.
list_notes
ChatGPTA chart's notes as summaries (id, type, title, event date, partner chart, timestamps) — undated notes first, then the timeline in chronological order. Partner-anchored notes (SYNASTRY, COMPOSITE_CHART) appear for both charts of the pairing. Use get_note for a note's body.
move_charts
ChatGPTMove up to 500 charts into a folder, or out of any folder. folder accepts a folder id or name — a name that matches no existing folder creates that folder; null or the literal "unfiled" removes the charts from their folders. Nothing is moved unless every chart reference resolves.
rename_folder
ChatGPTRename a chart folder. folder accepts the folder id or its name (case-insensitive).
update_note
ChatGPTUpdate a note's title, body (Markdown — replaces the whole body), event_date, and/or location. event_date and location only apply to timeline notes (CHART_TRANSITS, SECONDARY_PROGRESSIONS, SOLAR_RETURN, LUNAR_RETURN).
whoami
ChatGPTThe authenticated Astrotheoros account: email plus chart, folder, and note counts.
add_note
Claudecreate_folder
Claudedelete_note
Claudeget_biwheel
Claudeget_chart
Claudeget_composite
Claudeget_note
Claudeget_synastry
Claudeget_transits
Claudeget_vimshottari_dasha
Claudeget_zodiacal_releasing
Claudelist_charts
Claudelist_folders
Claudelist_notes
Claudemove_charts
Clauderename_folder
Claudeupdate_note
Claudewhoami
Claude