TimeMap MCP

What it does

TimeMap MCP provides AI agents with precise Chinese metaphysics calculations, including BaZi (Four Pillars of Destiny), Tong Shu (Almanac), and Feng Shui. It uses a verified engine checked against professional reference data and NASA JPL ephemeris for exact solar term calculations.

Tools

• get_natal_chart: Generates complete BaZi charts including Luck Pillars and 10 Gods.
• get_daily_pillars: Retrieves year, month, and day pillars for any date.
• get_day_quality: Provides Tong Shu indicators like Day Officer and 28 Constellations.
• get_daily_interactions: Checks for natal clashes, combinations, and breakers.
• get_hourly_pillars: Maps 12 two-hour energy blocks for a specific day.
• get_luck_pillars: Calculates the 10-year Luck Pillar timeline.
• lookup_hexagram: Finds Xuan Kong Da Gua hexagrams by stem-branch pairs.
• get_solar_term: Determines the exact date of the 24 solar terms.

Installation

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "timemap": {
      "command": "uvx",
      "args": ["timemap-mcp"]
    }
  }
}

Supported hosts

• Claude Desktop
• Cursor