# AstroWay Chinese metaphysics

> AstroWay Chinese metaphysics is a freemium MCP server for astrology. Chinese metaphysics API for agents: BaZi, Zi Wei Dou Shu, Chinese calendar and feng shui. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $5 a month
- **Platforms:** API, CLI
- **Website:** https://api.astroway.info/en/examples/mcp/
- **MCP Registry name:** info.astroway/chinese
- **Categories:** astrology
- **Listing updated:** 2026-11-16

## About

This is the Chinese-tradition endpoint of AstroWay's hosted MCP service, covering BaZi four pillars, Zi Wei Dou Shu, the Chinese calendar and feng shui. The whole AstroWay API is generated into tools from its OpenAPI spec, 843 on the hosted server and 735 in the npm package, which runs locally over stdio as @astroway/mcp.

Both modes need an AstroWay API key (aw_test_ or aw_live_), sent as a bearer header for the hosted server or as an environment variable for stdio. The page notes that the Claude custom connector dialog cannot carry an Authorization header, so Claude Desktop connects through the mcp-remote bridge. Cursor hides about 90 tools whose names exceed its length cap, and tool groups can be registered as a subset to save context.

The free tier gives 10,000 credits a month with no card; each endpoint costs a fixed number of credits, and identical requests within five minutes are served from cache without charge. The hosted endpoint is rate limited to 120 requests a minute per IP. The package states it sends no telemetry.

## Features

- **Chinese systems:** Covers BaZi, Zi Wei Dou Shu, the calendar and feng shui.
- **Generated tool catalogue:** Tools are built from the live OpenAPI spec.
- **Hosted or local:** Connects over HTTP or runs as an npm stdio package.
- **Subset registration:** Limits tool groups to keep model context small.
- **Read-only mode:** An option restricts the server to read-only tools.
- **Request caching:** Repeat requests within five minutes cost no credits.
- **No telemetry:** The package says it does not report usage.

## Good for

- Compute a BaZi chart from a birth date
- Add Zi Wei Dou Shu readings to a chatbot
- Look up Chinese calendar dates
- Build a feng shui helper for an app

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http chinese https://mcp.astroway.info/mcp/chinese
```

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

```sh
https://mcp.astroway.info/mcp/chinese
```

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

```json
{
  "mcpServers": {
    "chinese": {
      "url": "https://mcp.astroway.info/mcp/chinese"
    }
  }
}
```

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

```json
{
  "servers": {
    "chinese": {
      "type": "http",
      "url": "https://mcp.astroway.info/mcp/chinese"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "chinese": {
      "serverUrl": "https://mcp.astroway.info/mcp/chinese"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "chinese": {
      "type": "http",
      "url": "https://mcp.astroway.info/mcp/chinese"
    }
  }
}
```

## FAQ

### Do I need an API key?

Yes, an AstroWay key; the free tier is 10,000 credits a month with no card.

### What is the difference between hosted and npm?

Hosted has 843 tools; the npm package carries 735 and runs locally.

### Why can't I add it as a Claude custom connector?

That dialog takes only a name and URL, so it cannot send the Authorization header; use mcp-remote.

### What does it cost to go beyond free?

Plans start at $5 a month for Indie, with per-endpoint credit costs.

### Is AstroWay Chinese metaphysics free?

AstroWay Chinese metaphysics has a free plan, with paid plans for more usage or features. Paid plans start at $5 a month.

### How do I add AstroWay Chinese metaphysics to Claude Code?

Run this command in your terminal: claude mcp add --transport http chinese https://mcp.astroway.info/mcp/chinese

### What are the best alternatives to AstroWay Chinese metaphysics?

The closest alternatives to AstroWay Chinese metaphysics 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.
- [Moon Phase Software](https://ai-powered.com/mcp/moon-phase-software): Moon Phase Software is a free MCP server for astrology.
- [Zodiac Compatibility](https://ai-powered.com/mcp/zodiac-compatibility): Zodiac Compatibility is a free MCP server for astrology.

---
Source: https://ai-powered.com/mcp/astroway-chinese-metaphysics
