get_birthdate

Production

Status: Production — most tested with get_compatibility. Formerly get_card_for_birthdate.

One birth date in → birth card and layered systems for that date: tarot (minor + dual major Greer and Tarot School), medicine, Lenormand, runes, ogham, geomancy, sidereal wheels, moon phase, season, retrogrades, and more.

One call returns 26 symbolic systems across 20+ traditions — cards, tarot, five astrology wheels, numerology, chakras, moon phase, retrogrades, and multi-calendar years — as ~750 deterministic fields from a single date.


Input	`birth_date` (YYYY-MM-DD)
Range	`1900-01-01` … `2100-12-31` → `temporal_context: "full"`; nearby dates outside that window (e.g. 1850, 2101) → `"extended"`; farther out → `"birth_card_only"`
Version	`v2.8.0`
MCP URL	`https://mcp.geometry.app/mcp`

Ask (summary):

Get the card for birthdate 1985-03-15.

Ask (raw JSON / full payload):

give raw json for birthdate 1985-03-15 card

That phrase calls get_birthdate and tells the agent to paste the tool result verbatim (not summarize). There is still only one tool input: birth_date. “Raw JSON” and “full payload” are the same object. The sample below is a shortened teaching excerpt (values from a live call). A full tool response for the same date includes every block (medicine, lenormand, full astro_wheels, full retrogrades_active, and the rest). Full payload / raw JSON: the tool always returns the complete object. Read the MCP or HTTP response body in code. In chat, use the “raw json” line above so the model does not summarize.

Example response

{
  "birth_date": "1985-03-15",
  "cosmic": {
    "card_no": 34,
    "suit_name": "diamonds",
    "suit_symbol": "♦",
    "unicard_name": "eight of diamonds",
    "unicard_symbol": "8♦",
    "ruling_planet": "mars",
    "unicard_emoji": "🃈",
    "word_groups": {
      "core": "concentration",
      "action": "acquire",
      "energy": "focus",
      "shadow": "obsession",
      "strength": "consolidation"
    },
    "classical_element": {
      "element_no": 1700,
      "element_name": "earth",
      "element_symbol": "🜃"
    },
    "periodic_element": {
      "element_no": 34,
      "atomic_no": 34,
      "element_name": "selenium",
      "element_symbol": "Se"
    }
  },
  "season": {
    "season_name": "winter",
    "prev_anchor_name": "winter_solstice",
    "prev_anchor_dt": "1984-12-21",
    "next_anchor_name": "spring_equinox",
    "next_anchor_dt": "1985-03-20",
    "days_since_prev": 84,
    "days_until_next": 5
  },
  "moon_phase": {
    "phase_name": "waning_crescent",
    "phase_type": "intermediate",
    "prev_anchor": "last_quarter",
    "next_anchor": "new_moon",
    "days_until_next": 6
  },
  "astro_wheels": {
    "tropical": {
      "sign_name": "pisces",
      "sign_symbol": "♓︎",
      "house": { "house_no": 12, "house_name": "twelfth house" },
      "ruling_planet": "poseidon",
      "body_part": "feet"
    },
    "sidereal_true": {
      "sign_name": "pisces",
      "system_slug": "sidereal_true"
    },
    "sidereal_iau": {
      "sign_name": "pisces",
      "system_slug": "sidereal_iau"
    },
    "fagan_bradley": {
      "sign_name": "aquarius",
      "system_slug": "fagan_bradley"
    },
    "vedic_rasi": {
      "sign_name": "pisces",
      "nakshatra": {
        "nakshatra_name": "revati",
        "pada_no": 3,
        "deity": "pushan"
      }
    }
  },
  "tarot": {
    "unicard_name": "eight of pentacles",
    "arcana_class": "minor",
    "tarot_no": 72
  },
  "tarot_birth_cards": {
    "greer": {
      "card_count": 1,
      "is_same_card": true,
      "personality": {
        "tarot_no": 5,
        "tarot_name": "the hierophant",
        "tarot_roman": "V",
        "tarot_symbol": "5★"
      },
      "soul": {
        "tarot_no": 5,
        "tarot_name": "the hierophant",
        "tarot_roman": "V",
        "tarot_symbol": "5★"
      },
      "hidden_factor": { "in_chain": false }
    },
    "tarot_school": {
      "card_count": 2,
      "is_19_chain": false,
      "major_1": {
        "tarot_no": 14,
        "tarot_name": "temperance",
        "tarot_roman": "XIV",
        "tarot_symbol": "14★"
      },
      "major_2": {
        "tarot_no": 5,
        "tarot_name": "the hierophant",
        "tarot_roman": "V",
        "tarot_symbol": "5★"
      },
      "major_3": { "in_chain": false }
    }
  },
  "medicine": {
    "card_no": 34,
    "deck_type": "medicine",
    "unicard_name": "grouse",
    "unicard_slug": "grouse",
    "unirank_code": "a",
    "unicard_symbol": "34↓"
  },
  "lenormand": {
    "card_no": 34,
    "deck_type": "lenormand",
    "unicard_name": "key",
    "unicard_slug": "key",
    "unicard_symbol": "8♦",
    "in_lenormand_tradition": true
  },
  "lunar": {
    "sign_name": "ox",
    "year_no": 1985,
    "han_symbol": "牛",
    "sign_emoji": "🐂"
  },
  "iching": {
    "iching_no": 34,
    "iching_name": "great_power",
    "glyph": "䷡",
    "pinyin": "da_zhuang"
  },
  "numerology": {
    "birth_day_no": 74,
    "lifepath_gregorian": 32,
    "lifepath_vedic": 28,
    "lifepath_hebrew": 28
  },
  "calendar_years": {
    "hebrew": { "year": 5745, "month": 6, "day": 22 },
    "persian": { "year": 1363, "month": 12, "day": 24 },
    "chinese": { "year_no": 1985 },
    "mayan": { "tzolkin_kin": 258, "longcount_kin": 1861857 },
    "vedic_saka": { "year": 1906 }
  },
  "calendar_meta": {
    "weekday": "friday",
    "week_no": 11,
    "is_weekend": false,
    "is_leap_year": false
  },
  "retrogrades_active": [
    {
      "planet_name": "pluto",
      "phase": "retrograde",
      "sign_tropical": "scorpio",
      "retro_start_dt": "1985-02-06",
      "retro_end_dt": "1985-07-12"
    },
    {
      "planet_name": "venus",
      "phase": "retrograde",
      "sign_tropical": "aries",
      "cazimi_dt": "1985-04-03",
      "retro_start_dt": "1985-03-13",
      "retro_end_dt": "1985-04-25"
    },
    {
      "planet_name": "saturn",
      "phase": "retrograde",
      "sign_tropical": "scorpio",
      "retro_start_dt": "1985-03-07",
      "retro_end_dt": "1985-07-25"
    }
  ],
  "norse_runes": {
    "rune_name": "berkano",
    "rune_glyph": "ᛒ",
    "sign_emoji": "🌱"
  },
  "celtic_ogham": {
    "sign_name": "nion",
    "ogham_glyph": "ᚅ",
    "tree_name": "nion"
  },
  "geomancy": {
    "figures": [
      { "geomancy_name": "laetitia", "geomancy_symbol": "𜻨" }
    ]
  },
  "temporal_context": "full"
}

Deck faces on the birth card_no include cosmic, tarot (minor map), medicine, and lenormand. Major Arcana birth cards live under tarot_birth_cards with both methods every call: greer (Mary K. Greer — common default) and tarot_school (Amberstone). Cultural glyph systems include norse_runes, celtic_ogham, and geomancy. The retrogrades_active array in this sample is shortened; a live response includes major planets, asteroids, TNPs, and points. A full response carries ~30 systems for one date. Which numbers to build on: see the Field glossary. It separates tradition numbers like card_no and tarot_no from opaque catalog ids like system_no, and explains why element_no reads differently in the classical and periodic blocks.

Out of published range

Dates outside 1900–2100 do not crash the tool. Birth-card identity still follows month/day.

Band	Example	`temporal_context`	Notes
Extended	`1850-06-15`, `2101-01-01`	`extended`	Outside the published window — full temporal fields still returned, labeled honestly
Out	`1776-07-04`, `2200-01-01`	`birth_card_only`	Farther out — soft error envelope + birth card from month/day only

get_compatibility — two dates
get_day — calendar day (beta)
get_name — name → cosmic cards (beta)
Where your key goes

Get started

Tools

Reference

Example response

Out of published range

​Example response

​Out of published range

​Related

Example response

Out of published range

Related