# Ancient Echoes

> Ancient Echoes is a freemium MCP server for astrology. Deterministic BaZi, Zi Wei Dou Shu and other Chinese metaphysics calculations for agents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://www.ancientechoes.ai/lingxi
- **Repository:** https://github.com/flamescn/ancient-echoes-mcp
- **MCP Registry name:** io.github.FlamesCN/ancient-echoes-mcp
- **Categories:** astrology
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.ancientechoes.ai/api/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [Natal Chart Lab](https://ai-powered.com/mcp/natal-chart-lab): Natal Chart Lab is an open-source MCP server for astrology.
- [VedicDost: Vedic Astrology, Kundli & AI Astrologer](https://ai-powered.com/mcp/vedicdost-vedic-astrology-kundli-and-ai-astrologer): VedicDost: Vedic Astrology, Kundli & AI Astrologer is a free MCP server for astrology.
- [AstroLogics](https://ai-powered.com/mcp/astrologics): AstroLogics is a freemium MCP server for astrology.
- [GenesisCore Astrology (Western + Vedic)](https://ai-powered.com/mcp/genesiscore-astrology-western-vedic): GenesisCore Astrology (Western + Vedic) is a free MCP server for astrology.
- [Céu Natal](https://ai-powered.com/mcp/ceu-natal): Céu Natal is an open-source MCP server for astrology.
- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.
- [12 Chinese Zodiac Signs](https://ai-powered.com/mcp/12-chinese-zodiac-signs): 12 Chinese Zodiac Signs is a free MCP server for astrology.
- [Get Chinese Astrology](https://ai-powered.com/mcp/get-chinese-astrology): Get Chinese Astrology is a free MCP server for astrology.

---
Source: https://ai-powered.com/mcp/ancient-echoes
