12andus Astrology

Run an astrology calculation against a saved profile. Use this for ALL personalized astrology requests once the user has a profile_token (issued by setup_profile). No PII fields — birth data lives in the saved profile, referenced only by the opaque token. Parameters: action: One of: "birth_chart" — full natal chart + interpretation "forecast" — transits to the user's chart (requires forecast_date + days) "relationship" — synastry + composite for the user and a partner (requires partner_token) "relationship_forecast" — transits to the composite chart (requires partner_token + forecast_date + days) profile_token: prof_xxx token from setup_profile (the user's chart). partner_token: prof_xxx token for the second person (relationship*). forecast_date: YYYY-MM-DD (forecast / relationship_forecast). days: 1–365 (forecast / relationship_forecast). Use 1 for today, 7 for week, 30 for month, etc. language: ISO code, default "en". If profile_token is missing or invalid, call setup_profile first.

Open the visual astrology picker — saved profiles + a one-click action grid (birth chart, love, career, today/week/month/year forecasts, relationship readings). Each button sends a follow-up message that triggers the appropriate astro_action call. No PII leaves the widget. Call this tool when the user: - asks what you / this app / the connector can do, asks for "menu", "help", "options" - greets you ("hi" / "hello" / equivalent) and hasn't taken any other action yet - asks for "a reading" without specifying which kind - is genuinely uncertain ("show me something", "what should I ask") - asks for THEIR OWN chart / reading without naming someone else: "read my chart", "show me my chart", "do my reading", "what does my chart say", "tell me about myself astrologically", and any equivalent in any language. The menu shows their profile as a card and a one-click "Show my chart" action — much better UX than going straight to a long text reading. DO NOT call this tool when: - the user (or a previous follow-up message) explicitly named a different tool — "call setup_profile", "open the form", "manage profiles", "delete X", etc. Obey the explicit instruction and call THAT tool only. - the user is in the middle of an action you just started; never re-open the menu over the top of another widget. If the user has no saved profiles, the menu prompts them to run setup_profile first. No arguments.

Delete a saved birth chart by name. Uses the user's email from sign-in automatically.

⭐ VISUAL CHART DISPLAY - Use this tool when user wants to SEE, SHOW, VIEW, or DISPLAY a birth chart wheel or aspect grid. ALWAYS USE THIS TOOL for visual/display requests like: - "show [name]'s chart wheel" - "display [name]'s birth chart" - "can I see [name]'s chart" - "view the wheel for [name]" - "show me the aspect grid" Requirements: Person must have saved birth data. Use list_saved_charts to check. NOT for: Calculating new charts (use get_birth_chart) or analysis/interpretation (use get_birth_chart). Returns an interactive visual widget with zoomable chart wheel and aspect grid images.

Get personalized astrology memes based on birth chart placements. Returns a gallery of memes tailored to the person's unique astrological profile. Great for fun, shareable content based on their Sun sign, aspects, and placements.

Open the profile manager — an inline widget showing the user's saved profiles with Edit and Delete buttons. Edit opens the profile setup form pre-filled with the existing data; Delete asks for confirmation, then removes the profile. Call this when the user asks to "manage", "edit", "update", or "delete" a saved profile. No arguments. The widget includes the identity_token needed to authenticate widget→backend calls.

Resolve a picked birth place to latitude, longitude and timezone. Call this with the exact place name the user selected from search_cities. Returns the coordinates and timezone the profile form needs to save a chart. Parameters: place: the full place name (e.g. "Kiev, Ukraine").

Save birth data for future readings. THIS TOOL IS AVAILABLE - use it! Stores name, birth date/time, and location under the user's account. After saving, the person can be referenced by name in get_relationship_by_names. birth_time_known is optional - if not provided, it's inferred from whether hour is given. 🔴 ALWAYS offer to save after calculating a new chart (get_birth_chart or view_chart_visual). Example: "Would you like me to save Mauro's chart for future readings?" Useful for quick access to readings without re-entering data each time.

Suggest cities/towns for the birth-location field of the profile form. Fast typeahead: returns up to 8 place suggestions for a partial name, with NO geocoding. This backs the profile form's location autocomplete so it works on mobile ChatGPT; call resolve_city on the one the user picks. Parameters: term: what the user has typed so far (2+ characters). session: optional Google Places session token from the widget, to group the keystrokes of one search.

Search for a city/location and get precise coordinates and timezone. WHEN TO USE THIS TOOL: - Small towns, villages, or neighborhoods you're not 100% confident about - Places outside major world cities - When user specifies a district/area within a city (e.g., "Brooklyn, NY" or "Shibuya, Tokyo") - Any place where you're uncertain about exact coordinates - When precise coordinates matter (they always do for astrology!) For major world capitals (London, Paris, Tokyo, New York) you may use your knowledge, but for anything smaller, USE THIS TOOL to ensure accuracy. Returns cities with latitude, longitude, and timezone needed for birth charts.