Install

There is one service address:

https://ziwei-mcp.x-haose.com/mcp

Streamable HTTP, no authentication, public and free. On Claude Code and Codex, install the plugin and the reading method (the Skill) arrives with the service. Every other client takes this URL, plus the instructions under When there is no Skill.

Install the plugin

The plugin ships the Skill. The Skill makes the model confirm the birth data first, then call the tools, and keep chart facts, knowledge-pack text and its own analysis apart.

Claude Code

In a session, enter:

/plugin marketplace add x-haose/x-ziwei
/plugin install ziwei@x-ziwei

Codex

codex plugin marketplace add x-haose/x-ziwei

After adding the marketplace, install ziwei from the Codex plugin list.

ChatGPT

The public plugin directory listing is still being prepared, so it cannot be found there yet. Until then, add it as a custom MCP server:

This path has no Skill, so paste the instructions under When there is no Skill into your custom instructions. Official steps: Add custom MCP server.

URL only

Any client that accepts a remote MCP URL uses the same address. Do not add an authentication header. If other servers are already configured, merge in only the "ziwei" entry rather than overwriting the file.

Cursor reads ~/.cursor/mcp.json for the user, or .cursor/mcp.json inside a project:

{
  "mcpServers": {
    "ziwei": {
      "url": "https://ziwei-mcp.x-haose.com/mcp"
    }
  }
}

Claude needs one more field than Cursor, "type": "http". Claude Code reads .mcp.json at the project root, or mcpServers in the user config:

{
  "mcpServers": {
    "ziwei": {
      "type": "http",
      "url": "https://ziwei-mcp.x-haose.com/mcp"
    }
  }
}

Codex reads ~/.codex/config.toml, or use the equivalent command. Do not add a bearer token and do not run codex mcp login:

[mcp_servers.ziwei]
url = "https://ziwei-mcp.x-haose.com/mcp"

codex mcp add ziwei --url https://ziwei-mcp.x-haose.com/mcp

For Grok on the web, open grok.com/connectors, New Connector → Custom, enter the address above and leave authentication empty. For Grok Build:

grok mcp add --transport http ziwei https://ziwei-mcp.x-haose.com/mcp

Cascade (Windsurf / Devin Desktop) uses serverUrl for a remote HTTP entry:

{
  "mcpServers": {
    "ziwei": {
      "serverUrl": "https://ziwei-mcp.x-haose.com/mcp"
    }
  }
}

When there is no Skill

Paste the block below into the system prompt or custom instructions. It is a short form of the plugin Skill; the full text is SKILL.md in the repository. It is only the default method, and you can replace it with your own way of reading.

You read Zi Wei Dou Shu charts with the Ziwei tools. The tools compute the chart; the reading is yours.

Confirm the birth data first: calendar (solar or lunar), date, gender, and the birth clock time or hour. Ask for whatever is missing. Do not guess.
Pass a clock time as birth.clock (HH:MM); if only the traditional hour is known, pass birth.time_index (0 early Zi, 12 late Zi). 23:00 is 12, not 0.
For a lunar date, confirm whether the month is a leap month and pass birth.leap. Do not convert between calendars yourself.

Tools:
- ziwei_get_natal_chart: the full natal chart.
- ziwei_get_horoscope: decadal, yearly, monthly, daily and hourly layers for a date; both the target date and hour must be explicit.
- ziwei_get_topic_palaces: what the knowledge pack selects for a kind of question (romance, career, wealth and so on).
- ziwei_list_knowledge / ziwei_lookup_knowledge: the knowledge pack's catalog and entry text.

When answering:
- Do not state a star, palace, mutagen or pattern the tools did not return. Do not fill in from memory.
- Keep chart facts, knowledge-pack text (one school's reference view) and your own analysis distinguishable.
- If a tool fails, say so. Do not make up a result.
- Do not assert lifespan, a medical diagnosis, or that a misfortune will certainly happen.

What to say once it is installed

You do not need to memorise parameter names. Say it in plain words and the model fills them in.

What the tools hand back is chart facts and knowledge-pack text, not a finished "your career will be…". The model does the talking; the tools do the computing.