12andus Astrology

Delete a saved birth chart by name.

Uses the user's email from sign-in automatically.

Calculate and ANALYZE a birth chart with interpretation and visual 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_birth_chart).

Returns an interactive visual widget with zoomable chart wheel and aspect grid images.

Get astrological forecast showing planetary transits affecting the person.

birth_time_known is optional - auto-inferred from whether hour is provided.

Use this when the user asks about TIMING: 'today', 'this week', 'this month', 'next 3 months', 'what's coming up', or any future-oriented question.

Parameters:

• forecast_date: Start date in YYYY-MM-DD format (use today's date for 'now')
• days: Number of days to analyze (1-365). Use 1 for today, 7 for week, 30 for month, etc.

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.

🔴 USE THIS for "compare X with Y" - gives SYNASTRY + COMPOSITE chart analysis.

This is the CORRECT tool for relationship/compatibility. Returns:

• Synastry aspects (how their charts interact)
• Composite chart (the relationship as its own entity)

🚫 DO NOT call get_birth_chart twice for comparisons - that's WRONG! ✓ Call get_relationship ONCE with both people's data.

⚠️ PARAMETER FORMAT: All parameters are FLAT (not nested objects). Example: person1_name="Carlo", person1_day=4, person1_month=4, person1_year=1977, ... person2_name="Jiab", person2_day=21, person2_month=6, person2_year=1977, ...

🔴 WORKFLOW for "compare X with Y": 1. If you just calculated X's chart → you have their data in memory, USE IT 2. Call list_birth_charts to check if Y is saved → if yes, use that data 3. Call THIS tool with FLAT params for BOTH people 4. After response, offer to save any unsaved person

birth_time_known is optional - auto-inferred from whether hour is provided.

Relationship compatibility using SAVED charts only. Both people MUST already be saved.

🚫 DO NOT use this if you just calculated someone's chart in this conversation! 🚫 DO NOT use this without checking list_birth_charts first!

✓ USE THIS ONLY when:

• You have NOT calculated any charts in this conversation
• User mentions two names that are BOTH definitely saved

🔴 IF YOU JUST CALCULATED SOMEONE'S CHART: → Use get_relationship instead (you have their data in memory!) → Call list_birth_charts to get the other person's saved data → Then call get_relationship with BOTH people's full data

Example: User says "chart for Carlo" then "compare with Jiab" → You have Carlo's data (just calculated!) → Call list_birth_charts → find Jiab's saved data → Call get_relationship with Carlo + Jiab data (NOT this tool!)

Get relationship timing forecast with transits to composite chart. Use for relationship timing questions. forecast_date should be YYYY-MM-DD format. days is 1-365.

birth_time_known is optional - auto-inferred from whether hour is provided.

CRITICAL: This tool only works with EXACTLY 2 people. If user mentions 3+ people:

• STOP - do NOT call this tool
• do NOT call this tool multiple times for different pairs
• do NOT make up or hallucinate forecast data
• Ask user which pair to compare and WAIT for their response

PREFERRED: Get relationship timing forecast using saved birth data. Just provide the two names.

CRITICAL: This tool only works with EXACTLY 2 people. If user mentions 3+ people:

• STOP - do NOT call this tool
• do NOT call this tool multiple times for different pairs
• Instead, respond: "I can only analyze relationships between two people at a time. Which pair would you like me to compare?"
• WAIT for the user to choose before calling this tool

forecast_date should be YYYY-MM-DD format. days is 1-365. Automatically looks up saved birth charts. If either person is not found, tells you which data is missing.

Get user's saved birth charts with FULL birth data (all fields needed for get_relationship).

🔴 CALL THIS when user says "compare with [name]" to get that person's saved data.

Returns complete data: name, day, month, year, hour, minute, latitude, longitude, timezone. Use this data directly in get_relationship calls.

Example: User says "compare Carlo with Jiab" → You have Carlo's data (just calculated) → Call list_birth_charts → find Jiab with full birth data → Call get_relationship(person1=Carlo data, person2=Jiab data from this result)

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.

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.

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.