MingGe MCP
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
MingGe MCP server — BaZi, Zi Wei Dou Shu, Qi Zheng Si Yu and divination for AI agents
MingGe (mingge.org) is a deterministic engine for Chinese metaphysics, exposed as a remote MCP server and a REST API. Your agent gets structured, checkable results — charts, scores with their scale, verdicts with grounds, timing windows — and explains them to the user in their own language.
MCP (API key or x402):
https://mingge.org/mcpMCP (sign in with a MingGe account, OAuth):
https://mingge.org/mcp/accountREST:
https://api.akifukaku.com/v1/mingge/<tool>· OpenAPI · pricesDocs for agents: mingge.org/llms.txt · llms-full.txt · skill
Pay per call, a few US cents: skeleton tools $0.01, judgement tools $0.05–0.15. Repeat calls with the same input within 30 days are free. No signup needed.
Connect in ten seconds
Claude Code:
claude mcp add --transport http mingge https://mingge.org/mcpThen ask your agent to call create_api_key (free, includes a small trial credit) and set the key as the server's bearer token:
claude mcp add --transport http mingge https://mingge.org/mcp --header "Authorization: Bearer $AKI_API_KEY"Any MCP client (Cursor, Windsurf, VS Code, …):
{
"mcpServers": {
"mingge": { "url": "https://mingge.org/mcp", "headers": { "Authorization": "Bearer YOUR_AKI_API_KEY" } }
}
}Have a MingGe account? Use https://mingge.org/mcp/account instead: the client opens a sign-in page, the account gets monthly API credits (more for members), and my_charts / chart_id use the user's saved charts.
REST, one line:
curl -s -X POST https://api.akifukaku.com/v1/mingge/bazi_chart \
-H "Authorization: Bearer $AKI_API_KEY" -H 'Content-Type: application/json' \
-d '{"birth":{"year":1990,"month":5,"day":1,"hour":14,"minute":30,"longitude":121.47,"tz":"Asia/Shanghai"},"gender":"female"}'Related MCP server: timemap-mcp
Tools
Layer | Tools |
Free (key required) |
|
Skeleton (facts) |
|
Judgement |
|
Divination |
|
Reference |
|
Live prices: api.akifukaku.com/v1/pricing. Every tool's MCP description also ends with its price.
Paying
API key + prepaid credits —
POST https://api.akifukaku.com/v1/keys(no signup); top up by card or USDC withtopup_link.x402 — no account: retry the call with a
PAYMENT-SIGNATUREheader (USDC on Base) built from the 402'sPAYMENT-REQUIRED. Manifest: api.akifukaku.com/.well-known/x402.MingGe account — OAuth at
https://mingge.org/mcp/account; monthly credits included, then pay per call.
Failed calls are not charged.
Rules for agents
Every judgement comes from the engine. Relay it; never recompute a chart, change a verdict or invent numbers. Quote scores with their scale.
Same input + same engine version → the same result, byte for byte (
engine_versionis in every response).Verdict text is in Chinese (
verdict_lang: "zh"); translate it without changing the judgement.Cultural and reflective content, not medical, legal or financial advice.
Birth data is computed in memory and never stored or logged.
Terms of use for the API: mingge.org/terms#agent-api.
This repository
Docs and metadata only; the server is hosted. server.json is the entry in the official MCP Registry (org.mingge/mingge). skill/SKILL.md is an Agent Skill you can drop into Claude Code or any agent that reads skills.
Operated by Aki Fukaku, Australia. Contact: support@mingge.org.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Deterministic BaZi and Chinese metaphysics tools for AI agents: charts, divination, almanac.
Free BaZi, I Ching, tarot, Zi Wei and bilingual learning tools with transparent methods. No API key.
BaZi four pillars, Chinese zodiac, lunisolar calendar and almanac days for AI agents.
BaZi MCP gateway: 14 tools (6 fortune / 5 forum / 3 meta). API key required. Entertainment only.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI tools to perform Chinese fortune-telling analysis including Ziwei Doushu (Purple Star Astrology) and Bazi (Four Pillars) chart generation, fortune reading, and element analysis. Supports multiple calendar systems and output formats for comprehensive divination services.727 PyPI6MIT
- AlicenseAqualityCmaintenanceEnables AI agents to perform Chinese metaphysics calculations including BaZi charts, Tong Shu indicators, solar terms, and more, using a verified engine with 740+ tests.88MIT
- AlicenseAqualityBmaintenanceProvides traditional Chinese astrology (Bazi, Ziwei) and divination (Liuyao, Meihua, Qimen, etc.) calculations as MCP tools for AI assistants.18266 npm131Apache 2.0
- AlicenseAqualityCmaintenanceProvides Chinese metaphysical tools (bazi, qimen, five elements) as MCP tools for AI agents to give personalized advice on timing, compatibility, and daily energy.592 npm2MIT