get_date

Production

Status: Production.

One date in → the Cosmic card for that date plus layered systems: tarot (minor + dual major Greer and Tarot School), medicine, Lenormand, runes, ogham, geomancy, sidereal wheels, moon phase, season, retrogrades, weekday planetary ruler (day_ruler), karmic source/spirit, 14 planetary Life-spread cards, and more.

When to use: any single Gregorian date for moon phase (incl. blue / blood / supermoon flags, Earth–Moon distance, prev/next blue or blood dates), season / equinox–solstice anchors, classical retrogrades (retrogrades_active), calendars, lunar year, Cosmic card, weekday / leap year / day-of-year / days remaining (calendar_meta), weekday planetary ruler (day_ruler — Roman / Greek / Norse), or full date identity. Not for two-person scoring → get_compatibility. Not for name text → get_name.

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


Input	`date` (YYYY-MM-DD)
Range	`1900-01-01` … `2100-12-31` → `temporal_context.band=full` + `payload_scope=full`; nearby outside that window (e.g. 1850, 2101) → `band=extended` + `payload_scope=full`; farther out → `band=out_of_range` with Cosmic-card-only scope
Version	`v2.8.1.1`
MCP URL	`https://mcp.geometry.app/mcp`

Ask (summary):

Get the card for date 1985-03-15.

Ask (raw JSON / full payload):

give raw json for date 1985-03-15 card

That phrase calls get_date and tells the agent to paste the tool result verbatim (not summarize). There is still only one tool input: 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

{
  "tool": "get_date",
  "tool_version": "v2.8.1.1",
  "engine_chain": "v0.66",
  "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": "🃈",
    "also_called": ["birth_card", "life_card", "sun_card"],
    "identity_note": "birth card = life card = sun card (same card; see planetary_spread.sun)",
    "karma": {
      "flow": "source -> main -> spirit",
      "is_self_karma": false,
      "source": { "card_no": 20, "unicard_symbol": "7♣", "unicard_name": "seven of clubs" },
      "spirit": { "card_no": 51, "unicard_symbol": "Q♠", "unicard_name": "queen of spades" }
    },
    "planetary_spread": {
      "sun": {
        "planet_name": "sun",
        "spread_pos": 1,
        "unicard_symbol": "8♦",
        "is_sun_birth_card": true,
        "also_called": ["birth_card", "life_card", "sun_card"],
        "identity_note": "sun card = birth card = life card (same card)"
      },
      "moon": { "planet_name": "moon", "spread_pos": 2, "unicard_symbol": "…" },
      "rahu": { "planet_name": "rahu", "spread_pos": 12, "unicard_symbol": "…" },
      "midheaven": { "planet_name": "midheaven", "spread_pos": 13, "unicard_symbol": "…" },
      "phoenix": { "planet_name": "phoenix", "spread_pos": 14, "unicard_symbol": "…" }
    },
    "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,
    "is_full_moon": false,
    "is_blue_moon_monthly": false,
    "is_blue_moon_seasonal": false,
    "is_blood_moon": false,
    "is_supermoon": false,
    "is_micromoon": false,
    "earth_moon_distance_km": 0,
    "apparent_diameter_arcmin": 0,
    "phase_gmt": "none",
    "eclipse_code": "none",
    "eclipse_type": "none",
    "prev_blue_moon_monthly_dt": "1982-12-30",
    "next_blue_moon_monthly_dt": "1985-07-31",
    "prev_blood_moon_dt": "1982-12-30",
    "next_blood_moon_dt": "1985-05-04"
  },
  "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_majors": {
    "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↓",
    "direction": "south",
    "arcs": {
      "label": "grouse",
      "energy": "passion",
      "persona": "warrior",
      "role": "growth",
      "action": "ignite",
      "core": "sacred_spiral",
      "strength": "courage",
      "shadow": "impulsiveness",
      "quality": "trust",
      "nature": "active",
      "symbolism": "grouse",
      "title": "warm courage"
    }
  },
  "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",
    "modern_name": "great_invigorating",
    "glyph": "䷡",
    "upper_trigram": "thunder",
    "lower_trigram": "heaven",
    "yin_yang_code": "YYYYNN",
    "seq_no": 4,
    "binary_no": 15,
    "sign_no": 9,
    "atomic_no": 34,
    "element_symbol": "Se",
    "element_name": "selenium",
    "pinyin": "da_zhuang"
  },
  "numerology": {
    "birth_day_no": 74,
    "gregorian": {
      "lifepath": 5,
      "lifepath_sum": 32,
      "lifepath_base": 5,
      "is_master_lifepath": false,
      "is_money_lifepath": false
    },
    "vedic": { "lifepath": 1, "lifepath_sum": 28, "lifepath_base": 1 },
    "hebrew": { "lifepath": 1, "lifepath_sum": 28, "lifepath_base": 1 },
    "solar_cancer": { "lifepath": 6, "lifepath_sum": 132, "lifepath_base": 6 },
    "solar_capricorn": { "lifepath": 9, "lifepath_sum": 126, "lifepath_base": 9 }
  },
  "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": {
    "year_no": 1985,
    "month_no": 3,
    "day_no": 15,
    "weekday": "friday",
    "weekday_no": 5,
    "week_no": 11,
    "day_of_year": 74,
    "days_elapsed": 74,
    "days_remaining": 291,
    "days_in_year": 365,
    "is_weekend": false,
    "is_leap_year": false
  },
  "day_ruler": {
    "day_of_week": 5,
    "ruling_planet": "venus",
    "planet_no": 6,
    "planet_symbol": "♀",
    "roman": "venus",
    "greek": "aphrodite",
    "norse": {
      "day_name": "frjádagr",
      "deity": "freya"
    }
  },
  "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": { "band": "full", "payload_scope": "full" }
}

Deck faces on the Cosmic card_no include cosmic, tarot (minor map), medicine, and lenormand — each a sibling object (one Lenormand object beside cosmic, never nested under it). Sibling iching carries hexagram identity plus upper_trigram / lower_trigram / yin_yang_code / seq_no / binary_no / sign_no. Major Arcana methods live under wire key tarot_majors 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. Cosmic card identity: the date’s Cosmic card is the same card as birth / life / sun. Live JSON may list those aliases under cosmic.also_called and planetary_spread.sun — one card, not three. 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. The Cosmic card still resolves from month/day (same card as birth / life / sun).

Band	Example	`temporal_context`	Notes
Extended	`1850-06-15`, `2101-01-01`	`{ "band": "extended", "payload_scope": "full" }`	Outside the published window — full temporal fields still returned, labeled honestly
Out	`1776-07-04`, `2200-01-01`	`{ "band": "out_of_range", "payload_scope": "cosmic_card_only" }`	Farther out — soft error envelope; Cosmic card from month/day only · no `day_ruler`. Flag `cosmic_card_available: true`.

Planetary spread order (`spread_pos`)

cosmic.planetary_spread is a keyed object (planet name → slot). JSON object key order is not reliable — clients and gateways may reshuffle keys. Each slot carries spread_pos (integer 1–14) = Life-spread order from cosmic_planets.sort_no. Consumer rule: sort slots by spread_pos ascending. Do not rely on Object.keys() / iteration order.

`spread_pos`	Planet key
1	`sun` (Cosmic card = birth / life / sun)
2	`moon`
3	`mercury`
4	`venus`
5	`mars`
6	`jupiter`
7	`saturn`
8	`uranus`
9	`neptune`
10	`pluto`
11	`chiron`
12	`rahu`
13	`midheaven`
14	`phoenix`

Same field on get_compatibility for Cosmic card A / B (….cosmic.planetary_spread on each side’s date profile). retrogrades_active is already an ordered array — no spread_pos there.

Day ruler (weekday planetary ruler)

Weekday planetary ruler ships on get_date when temporal_context.payload_scope is full (published 1900–2100 and extended pad years). Out-of-range Cosmic-card-only calls omit day_ruler.

Field	Meaning
`day_of_week`	Weekday number — `0` Sunday … `6` Saturday
`ruling_planet` / `planet_no` / `planet_symbol`	Classical weekday planet
`roman` / `greek`	Planet name in those traditions
`norse.day_name` / `norse.deity`	Old Norse weekday name + deity

Ask:

What’s the planetary day ruler for 2026-07-23?

Norse Saturday: norse.deity is null on Saturdays (laugardagr / bath day has no deity). That is the only sanctioned null in a public payload — see Field glossary.

get_compatibility — two dates
get_name — name → Cosmic cards
Cosmic day cards — full 366-face month × day calendar
What you get — tool menu + repeating shapes
Field glossary — _no keys and the Norse null exception
Where your key goes

Get started

Tools

Reference

Example response

Out of published range

Planetary spread order (`spread_pos`)

Day ruler (weekday planetary ruler)

​Example response

​Out of published range

​Planetary spread order (spread_pos)

​Day ruler (weekday planetary ruler)

​Related

Example response

Out of published range

Planetary spread order (`spread_pos`)

Day ruler (weekday planetary ruler)

Related