12andus Astrology

Setup Profile

Open an inline form to create or update an astrology profile. Call this tool — DO NOT ask the user for birth details in plain text — when the user wants a personalized reading but has no saved profile yet, OR when they explicitly ask to update / edit / change a saved birth profile. Specifically: - User asks "read my chart" / "do my reading" / "tell me my horoscope" and astrology_menu / list_birth_charts shows zero saved profiles for them → call setup_profile so the inline form opens.

Astrology Menu

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

Manage Profiles

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.

Astro Action

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) "rel

Save Birth Chart

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 acce

Search Cities

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.

Resolve City

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").

Search Location

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 k

Delete Birth Chart

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

Get Chart Images

⭐ 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_

View Chart Visual

Generate visual birth chart (wheel image + aspect grid) for ONE person. Use when user says "show/see/view chart" with birth data. For text analysis/interpretation, use get_birth_chart instead. 🔴 MANDATORY AFTER THIS TOOL - YOU MUST: 1. End response with: "Would you like me to save [name]'s chart for future readings?" 2. Offer: "I can explain the chart or compare with someone else." 🔴 REMEMBER the birth data for later use in get_relationship.

Get Memes

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.