# MingGe

> MingGe is a paid MCP server for ai models and llm tooling. Pay-per-call BaZi, Zi Wei and divination engine for AI agents, via MCP or REST. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI, Web
- **Website:** https://mingge.org/agents
- **Repository:** https://github.com/akifukaku/mingge-mcp
- **MCP Registry name:** org.mingge/mingge
- **Categories:** [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

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

```sh
https://mingge.org/mcp
```

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

```json
{
  "mcpServers": {
    "mingge": {
      "url": "https://mingge.org/mcp"
    }
  }
}
```

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

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

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

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

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

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

## Tools

- `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.

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

## Alternatives

- [headroom](https://ai-powered.com/mcp/headroom-3): headroom is an open-source MCP server for ai models and llm tooling.
- [omniget](https://ai-powered.com/mcp/omniget): omniget is an open-source MCP server for ai models and llm tooling.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [unity-mcp](https://ai-powered.com/mcp/unity-mcp-2): unity-mcp is an open-source MCP server for ai models and llm tooling.
- [fastapi_mcp](https://ai-powered.com/mcp/fastapi-mcp): fastapi_mcp is an open-source MCP server for ai models and llm tooling.
- [tyk](https://ai-powered.com/mcp/tyk): tyk is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mingge
