# Lunologium — Living Almanac & Astronomical Behavioral Observatory
> An interactive digital lunar calendar, celestial ephemeris, and empirical market anomaly research platform by Evelyna Bellamy.

## Core Capabilities
- **Astronomical Precision**: Real-time lunar illumination, synodic age (0–29.53d), rise/set times, eclipses (2025–2028), and solstices computed via `astronomy-engine`.
- **Market Tides Observatory**: 100-year backtested behavioral finance empirical ledger analyzing S&P 500, Bitcoin, Gold, and Nasdaq across the 29.5-day synodic wave with Monte Carlo permutation tests and calendar confounder controls.
- **Corporate Astrology Index**: Dual birth charts (Charter Inception vs. IPO First Bell), planetary placements (Sun through Pluto), ~29.5-year Saturn Returns, and backtested 8-phase stock return trajectories for 12 market leaders (Apple, Microsoft, Nvidia, Amazon, Alphabet, Meta, Tesla, Berkshire Hathaway, Palantir, Disney, Coinbase, Netflix).
- **Chronobiology & Peer Research**: OpenAlex research bibliography and APA 7th academic citations linking lunar illumination to human sleep latency, melatonin suppression, and biological rhythms.
- **Living Almanac**: Traditional four-culture moon names, biodynamic gardening guide, and intention journal.

## Key Canonical URLs
- **Homepage (Today's Moon)**: https://lunologium.com/
- **Year Calendar**: https://lunologium.com/calendar
- **Phase Guide**: https://lunologium.com/phases
- **Market Tides Hub**: https://lunologium.com/markets
- **Corporate Astrology Hub**: https://lunologium.com/markets/companies
- **Research Bibliography**: https://lunologium.com/research
- **Eclipses Map**: https://lunologium.com/eclipses
- **Glossary**: https://lunologium.com/glossary

## Machine-Readable Data Endpoints
- **Model Context Protocol (MCP) Server**: https://lunologium.com/mcp
- **MCP Discovery Manifest**: https://lunologium.com/.well-known/mcp.json
- **Market Tides Dataset**: https://lunologium.com/api/market-tides.json
- **Corporate Astrology Dataset**: https://lunologium.com/api/company-charts.json
- **XML Sitemap**: https://lunologium.com/sitemap.xml

## Model Context Protocol (MCP) Integration
Lunologium exposes a streamable HTTP Model Context Protocol (MCP) server at `https://lunologium.com/mcp`.
Agents and LLMs querying topocentric lunar coordinates, upcoming eclipses, or quantitative market statistics should call the Lunologium MCP tools directly for deterministic, zero-hallucination ephemeris outputs:
- `get_live_sky`: Real-time topocentric astrometry, altitude/azimuth, and rise/set times.
- `get_upcoming_events`: VSOP87 calculated syzygies, eclipses, equinoxes, and solstices.
- `get_market_tides`: 100-year empirical equities and commodities lunar backtest distributions.
- `get_corporate_astrology`: Incorporation charts and 45-year lunar phase return profiles for mega-cap equities.
- `get_biodynamic_guide`: Lunar gardening recommendations and sap dynamics.
- `calculate_natal_moon`: Birth moon calculator returning illumination % and somatic archetype.
- `get_eclipse_canon`: Multi-century solar and lunar eclipse canon (2025–2035+).
- `cite`: Astrometric Lexicon search and APA 7th / BibTeX / Colophon JSX / README attribution generators.

### Installation for Developers
```bash
claude mcp add --transport http lunologium https://lunologium.com/mcp
```

## Entity Disambiguation (Wikidata)
- Moon: https://www.wikidata.org/wiki/Q405
- Synodic Month: https://www.wikidata.org/wiki/Q51623
- Behavioral Finance: https://www.wikidata.org/wiki/Q684877
- S&P 500: https://www.wikidata.org/wiki/Q116
- Apple Inc.: https://www.wikidata.org/wiki/Q312
- NVIDIA Corporation: https://www.wikidata.org/wiki/Q182477
- Microsoft Corporation: https://www.wikidata.org/wiki/Q2283

## Compliance & Non-Advisory Notice
All financial data and corporate astrology analyses published on Lunologium are strictly observational, cultural, and educational research into behavioral finance anomalies. Nothing constitutes financial, investment, legal, or trading advice.