Skip to content
MCP server

AstroWay Chinese metaphysics

Chinese metaphysics API for agents: BaZi, Zi Wei Dou Shu, Chinese calendar and feng shui

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Remotely
Version
0.4.7
Listing updated
1 day ago

About AstroWay Chinese metaphysics

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

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.astroway.info/mcp/chinese
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "chinese": {
      "url": "https://mcp.astroway.info/mcp/chinese"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

What it does

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

Pricing

Freemium, from $5 a month

Free 10,000 credits/month; Indie from $5/mo; larger tiers and packs available

Prices change. Check api.astroway.info before you buy.

AstroWay Chinese metaphysics 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 to AstroWay Chinese metaphysics

  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