MCP App Store
by KeenEthics

Overview

Astrotheoros links your saved chart library to the assistant. Once you sign in, it can look up any chart in your account, calculate transits, progressions, returns, synastry, and composites against those charts, and read or write the notes attached to them, all with the house system, zodiac, aspects, and other settings you already use in the app. The assistant returns the same output as the app's copy button, so the numbers match what you see on screen, and you never have to type birth data into a chat. Timing tools cover secondary progressions, solar and lunar returns, draconic charts, annual profections, zodiacal releasing, and Vimshottari dasha. Notes can be natal, synastry, composite, draconic, or dated timeline entries, and they appear in the app right away. You can also sort charts into folders from the conversation. The assistant works only with charts already in your account. It cannot create, edit, or delete charts, and it cannot change your settings. Requires an Astrotheoros account.

Tools

add_note

ChatGPT
Create 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

ChatGPT
Create 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

ChatGPT
Permanently delete a chart note. This cannot be undone — always confirm with the user before calling this tool.

get_biwheel

ChatGPT
A 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

ChatGPT
A 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

ChatGPT
The 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

ChatGPT
A 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

ChatGPT
Synastry 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

ChatGPT
The 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

ChatGPT
Vimshottari 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

ChatGPT
Zodiacal 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

ChatGPT
List 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

ChatGPT
The 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

ChatGPT
A 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

ChatGPT
Move 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

ChatGPT
Rename a chart folder. folder accepts the folder id or its name (case-insensitive).

update_note

ChatGPT
Update 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

ChatGPT
The authenticated Astrotheoros account: email plus chart, folder, and note counts.

add_note

Claude

create_folder

Claude

delete_note

Claude

get_biwheel

Claude

get_chart

Claude

get_composite

Claude

get_note

Claude

get_synastry

Claude

get_transits

Claude

get_vimshottari_dasha

Claude

get_zodiacal_releasing

Claude

list_charts

Claude

list_folders

Claude

list_notes

Claude

move_charts

Claude

rename_folder

Claude

update_note

Claude

whoami

Claude

Similar Apps