AstroWay Chinese metaphysics
Chinese metaphysics API for agents: BaZi, Zi Wei Dou Shu, Chinese calendar and feng shui
- 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/chineseAdd to Settings → Connectors → Add custom connector
https://mcp.astroway.info/mcp/chineseAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"chinese": {
"url": "https://mcp.astroway.info/mcp/chinese"
}
}
}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
Natal Chart Lab
MCP serverKeyless MCP server for planet positions, retrogrades, Moon phases and birth placements
Runs locally- 5 tools
- Open source
- Astrology

Vedic astrology calculations for AI: kundli, guna milan, panchang, dosha and muhurat
- 10 tools
- Remote
- Free
- Astrology

AstroLogics
MCP serverVedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching
- 23 tools
- Remote
- Freemium
- Astrology

GenesisCore Astrology (Western + Vedic)
MCP serverFree Western and Vedic chart signs, retrogrades and ingresses from a date and place
- 4 tools
- Remote
- Free
- Astrology
Céu Natal
MCP serverSwiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese
- 9 tools
- Remote
- Open source
- Astrology

OIYO Korea Calculators
MCP serverDeterministic Korean tax, payroll, labor and calendar calculators served over MCP
- 76 tools
- Remote
- Free
- Finance and payments