Skip to content
MCP server

MingGe

Pay-per-call BaZi, Zi Wei and divination engine for AI agents, via MCP or REST

Install
Pricing
Paid
Platforms
API, CLI, Web
Runs
Remotely
Version
2.0.1
Listing updated
1 day ago

Similar MCP servers

About MingGe

MingGe is a paid MCP server for ai models and llm tooling. It runs as a hosted remote server, so there is nothing to install locally.

The README describes MingGe as a deterministic engine for Chinese metaphysics that agents can call instead of generating readings themselves. Charts, scores and timing windows come back as structured data, so an assistant relays the engine's verdicts rather than recomputing them. Coverage spans BaZi, Zi Wei Dou Shu, Qi Zheng Si Yu, synastry, date selection, the Chinese almanac and six divination methods.

Connection is available over Streamable HTTP at one MCP endpoint, authenticated either with an API key and prepaid credits, per-call x402 payment in USDC on Base, or a MingGe account sign-in. Several helper tools such as birth_form and list_options are free, while chart and judgement tools are priced from about half a cent to 30 cents per call. Repeat calls with identical input are not charged again within 30 days.

The product suits developers building assistants or apps that need consistent, reproducible astrology-style outputs, and it publishes cross-check cases so results can be verified against external charting sites. Birth data is said to be computed in memory and not stored or logged.

Install

Run in a terminal

claude mcp add --transport http mingge https://mingge.org/mcp

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "mingge": {
      "type": "http",
      "url": "https://mingge.org/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "mingge": {
      "serverUrl": "https://mingge.org/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "mingge": {
      "type": "http",
      "url": "https://mingge.org/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (26)

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

birth_form
Turns a description of birth details into the birth object the chart tools take.
list_options
Lists school and rule options accepted by each tool, with defaults.
my_charts
Lists the user's saved charts in MingGe.
verify_vectors
Provides public cross-check cases with expected results.
almanac_day
Returns the Chinese almanac for a date.
bazi_pillars
Returns the BaZi skeleton: four pillars, hidden stems, ten gods and related facts.
calendar_convert
Converts dates between Gregorian, lunar and stem-branch calendars.
lexicon
Looks up Chinese metaphysics terms, stars and patterns.
ziwei_board
Returns the Zi Wei Dou Shu board with palaces and stars.
cast_xiaoliuren
Returns a Xiao Liu Ren quick reading for the moment of asking.
draw_lingqian
Draws a temple lot.
bazi_chart
Returns a full BaZi chart with scores and verdicts.
bazi_period
Returns scores and grounds for a given year, month or day.
cast_liuren
Returns a Da Liu Ren reading for the moment of asking.
cast_liuyao
Returns a Liu Yao hexagram reading for one question.
cast_meihua
Returns a Plum Blossom divination reading.
cast_qimen
Returns a Qi Men Dun Jia chart for the moment of asking.
ziwei_chart
Returns a Zi Wei Dou Shu natal chart.
hepan
Returns a synastry reading for two people's birth data.
qizheng_transit
Returns Qi Zheng Si Yu transits against the natal chart.
zeri_pick
Selects usable days for an event within a date range.
ziwei_limits
Returns Zi Wei decade, annual, monthly and daily limits.
bazi_luck
Returns the full BaZi luck curve with yearly scores.
bazi_timing
Returns life-event timing windows from a BaZi chart.
qizheng_chart
Returns a Qi Zheng Si Yu natal chart.
reading_pack
Returns a combined BaZi reading: chart, luck and timing.

What it does

Deterministic chart engine
Identical input and engine version return byte-identical results, with the engine version included in each response.
Per-call pricing
Tools are priced individually from $0.005 to $0.30, with helper tools free and failed calls not charged.
Multiple payment routes
Supports prepaid credits, x402 payment in USDC on Base, or a MingGe account with monthly allowance.
Verifiable cross-checks
A free verify_vectors tool supplies public test cases with expected results for independent checking.
Adjustable school options
Options such as day boundary and Qi Men palace method can be changed, with the defaults listed by list_options.
Remote MCP and REST access
Connects to MCP clients like Claude Code and Cursor over HTTP, or to a REST endpoint for each tool.

Good for

  • Adding BaZi chart readings to a chatbot or companion app
  • Selecting auspicious dates for weddings, moves or signings via zeri_pick
  • Running synastry checks for relationship or partnership questions
  • Generating Liu Yao or Plum Blossom divination results on demand
  • Looking up Chinese almanac entries and solar term timings for scheduling tools

Pricing

Paid

Pay per call from $0.005 to $0.30; free helper tools; prepaid credits, x402 or account allowance.

Prices change. Check mingge.org before you buy.

MingGe FAQ

What does an MCP connection require?

The README says you can connect with an API key sent as a bearer token, or sign in with a MingGe account at the /mcp/account endpoint. An x402 option pays per call without an account.

How is usage billed?

Each tool has a listed per-call price, from $0.005 to $0.30 in the content. Repeat calls with the same account and input are charged once per 30 days, and failed calls are not charged.

Is the output stored or used for medical or financial advice?

The README states birth data is computed in memory and not stored or logged. It also says the outputs are cultural and reflective content, not medical, legal or financial advice.

Is the server open source?

The repository contains docs and metadata only; the README states the server itself is hosted.

Is MingGe free?

No. MingGe is a paid product.

How do I add MingGe to Claude Code?

Run this command in your terminal: claude mcp add --transport http mingge https://mingge.org/mcp

What are the best alternatives to MingGe?

The closest alternatives to MingGe are headroom, omniget, next-ai-draw-io, mcp-for-blender and Claude Code Ultimate Guide.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers