Skip to content
MCP server

Ancient Echoes

Deterministic BaZi, Zi Wei Dou Shu and other Chinese metaphysics calculations for agents

Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.0.1
Listing updated
3 days ago

About Ancient Echoes

Ancient Echoes is a freemium MCP server for astrology. It runs as a hosted remote server, so there is nothing to install locally.

The computation stays on Ancient Echoes' servers, and every result carries calculationCapability and calculationVersion fields so it can be reproduced across releases. The README lists BaZi (Four Pillars), Zi Wei Dou Shu, Qi Men Dun Jia, Qi Zheng Si Yu, Vedic and Western astrology, Liu Yao, Mei Hua, Da Liu Ren, Xiao Liu Ren, Tai Yi, almanac and election-day evidence. The site counts 36 read-only tools on one endpoint.

A free account can use the basic chart, divination and election tools. Topic tools such as pattern analysis, favorable elements, wealth, group, naming and family are in paid plans, and a RAG query tool is billed against your AI plan. Calls must pass an explicit civil time, calendar and timezone. The default limit is 200 calls a day and 30 a minute per user.

Access uses a Web API key (sk-) or a device token (lxd_) from the User Center, or OAuth with PKCE. Hosts that support MCP Apps render BaZi results as an interactive chart. The repository also holds a portable agent plugin and usage skill. The website pages are partly in Chinese and describe a separate LingXi assistant.

Install

Run in a terminal

claude mcp add --transport http ancient-echoes-mcp https://www.ancientechoes.ai/api/v1/mcp

Add to Settings → Connectors → Add custom connector

https://www.ancientechoes.ai/api/v1/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ancient-echoes-mcp": {
      "url": "https://www.ancientechoes.ai/api/v1/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ancient-echoes-mcp": {
      "type": "http",
      "url": "https://www.ancientechoes.ai/api/v1/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ancient-echoes-mcp": {
      "serverUrl": "https://www.ancientechoes.ai/api/v1/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ancient-echoes-mcp": {
      "type": "http",
      "url": "https://www.ancientechoes.ai/api/v1/mcp"
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

bazi.calculate_chart
Calculates a BaZi chart from birth details.
lingxi.rag_query
Queries the knowledge base, billed against your AI plan.

What it does

Many divination systems
BaZi, Zi Wei Dou Shu, Qi Men Dun Jia, Liu Yao, Western and Vedic astrology and more.
Reproducible results
Each response carries a capability and calculation version.
Interactive charts
MCP Apps hosts render BaZi results as a chart.
Almanac and election day
Evidence for choosing dates.
Protocol versions
Supports 2026-07-28 and older handshakes.
Quota controls
Per-user daily and per-minute limits.

Good for

  • Calculate a BaZi chart from a birth time
  • Look up almanac data for choosing a date
  • Run a divination query inside a coding or chat agent
  • Compare Western and Chinese chart results
  • Verify results against a calculation version

Pricing

Freemium

Basic tools on a free account; topic tools in paid plans, prices not published

Prices change. Check ancientechoes.ai before you buy.

Ancient Echoes FAQ

Which tools are free?

Basic chart, divination and election tools are available on a free account; topic tools need a paid plan.

How do I authenticate?

With a Web API key or device token from the User Center, or OAuth with PKCE.

What are the limits?

The site lists 200 calls a day and 30 a minute per user.

Are results reproducible?

Each result includes calculationCapability and calculationVersion.

Where does it run?

The engine runs on Ancient Echoes' servers; the repository holds the client skill and setup notes.

Is Ancient Echoes free?

Ancient Echoes has a free plan, with paid plans for more usage or features.

How do I add Ancient Echoes to Claude Code?

Run this command in your terminal: claude mcp add --transport http ancient-echoes-mcp https://www.ancientechoes.ai/api/v1/mcp

What are the best alternatives to Ancient Echoes?

The closest alternatives to Ancient Echoes are Natal Chart Lab, VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic) and Céu Natal.

Alternatives to Ancient Echoes

  1. Natal Chart Lab

    MCP server

    Keyless MCP server for planet positions, retrogrades, Moon phases and birth placements

    Runs locally
    • 5 tools
    • Open source
    • Astrology
  2. AstroLogics

    MCP server

    Vedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching

    • 23 tools
    • Remote
    • Freemium
    • Astrology
  3. Céu Natal

    MCP server

    Swiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese

    • 9 tools
    • Remote
    • Open source
    • Astrology
  4. Deterministic Korean tax, payroll, labor and calendar calculators served over MCP

    • 76 tools
    • Remote
    • Free
    • Finance and payments