Use IChing.Rocks with AI Assistants

IChing.Rocks provides an MCP-compatible interface for structured I Ching hexagram data: original translations, Chinese text and pinyin, trigrams, judgments, images, line texts, changing-line context, and two-hexagram reading transitions.

Compatible AI assistants such as Claude, ChatGPT, Le Chat, and Perplexity can retrieve this material directly from IChing.Rocks instead of relying on generic model memory — use the source, not a summary.

MCP Server URL (paste this into your AI client):

https://mcp.iching.rocks/mcp

What the Connector Can Do

Once connected, your AI assistant can:

• Look up any of the 64 hexagrams by King Wen number.
• Retrieve the full text fields: judgment, image, line texts, Chinese characters, and pinyin.
• Work with changing lines: when you provide changing lines, the server derives the relating hexagram and transition context.
• Search the hexagram texts by keyword.
• Fetch the complete 64-hexagram dataset in one call.
• List the hexagrams in four canonical orderings: King Wen, Mawangdui, Eight Palaces, and binary.
• Compare a primary hexagram and its relating hexagram side by side.
• Look up the eight trigrams and their attributes.

Connect from Claude

Steps verified against Claude as of July 2026 — menus may move.

Connectors Directory (Team and Enterprise): IChing.Rocks is listed in the Claude Connectors Directory — an owner can search for "IChing.Rocks" under the organization's connector settings and enable it.

Custom connector: Claude's current docs list remote custom connectors as available on Free, Pro, Max, Team, and Enterprise plans (beta; Free accounts are limited to one custom connector).

1. On Free, Pro, or Max, open Customize > Connectors, click +, then Add custom connector. On Team or Enterprise, an owner manages connectors from organization settings.
2. Paste https://mcp.iching.rocks/mcp as the remote MCP server URL. No authentication is required.
3. Click Add.
4. In a conversation, open the chat's + menu, choose Connectors, and enable IChing.Rocks.

First prompt to try: "Use IChing.Rocks to look up Hexagram 11."

Connect from ChatGPT

Steps verified against ChatGPT as of July 2026 — menus may move.

ChatGPT adds custom MCP connectors through developer mode:

1. Open Settings > Apps & Connectors > Advanced settings and enable developer mode.
2. Open Settings > Connectors > Create. Name: IChing.Rocks; Description: "Structured I Ching hexagram lookup, changing-line context, and reading support."; Connector URL: https://mcp.iching.rocks/mcp. This server needs no authentication — if ChatGPT asks for authentication settings, choose no authentication or leave the authentication fields empty.
3. In a new chat, click +, choose More, and select IChing.Rocks.

Note: some clients, ChatGPT included, may not display source attribution prominently. Every response still carries it — see the attribution section below.

First prompt to try: "Use IChing.Rocks to look up Hexagram 11."

Connect from Le Chat

Steps verified against Le Chat as of July 2026 — menus may move.

Custom MCP connectors are available on all Le Chat plans, including Free (on personal plans the account owner is the administrator by default), and work on web and mobile:

1. In Le Chat (chat.mistral.ai), open the sidebar and go to Intelligence > Connectors.
2. Click + Add Connector and switch to the Custom MCP Connector tab.
3. Connector name: IChingRocks (Le Chat connector names cannot contain spaces); Server URL: https://mcp.iching.rocks/mcp; click Connect. Le Chat detects the authentication method automatically — this server requires none.
4. In a conversation, open Tools and enable the IChingRocks connector.

First prompt to try: "Use IChing.Rocks to look up Hexagram 11."

Connect from Perplexity

Steps verified against Perplexity as of July 2026 — menus may move.

Custom remote connectors require a paid Perplexity plan (Pro or Max; Enterprise via an administrator):

1. Open account settings and go to Connectors, then click + Custom connector and select Remote.
2. Name: IChing.Rocks; MCP Server URL: https://mcp.iching.rocks/mcp; Authentication: None; Transport: Streamable HTTP.
3. Check the custom-connector acknowledgement and click Add, then click the connector card to enable it.
4. In a thread, confirm the connector is selected under the + / sources menu.

First prompt to try: "Use IChing.Rocks to look up Hexagram 11."

Other MCP Clients

Any client that supports remote MCP servers over Streamable HTTP can connect using the endpoint above. For clients that install from a registry, IChing.Rocks is published on the Official MCP Registry as rocks.iching/hexagram-mcp and is also listed on Glama.

The Gemini consumer app does not currently support custom MCP connectors (Google's MCP support is in Gemini Enterprise and the Gemini CLI). Verified as of July 2026 — menus may move.

Developers using CLI tools can connect the same endpoint — e.g. Claude Code:

claude mcp add --transport http iching-rocks https://mcp.iching.rocks/mcp

Example Prompts

Once the connector is enabled, try asking:

• "Use IChing.Rocks to look up Hexagram 11."
• "Use IChing.Rocks to give the Chinese, pinyin, judgment, image, and line texts for Hexagram 29."
• "Use IChing.Rocks to explain Hexagram 11 changing at lines 2 and 5, including the resulting hexagram."
• "Use IChing.Rocks to compare Hexagram 11 and Hexagram 12."
• "Use IChing.Rocks to search the hexagram texts for 'perseverance'."
• "Use IChing.Rocks to show the eight trigrams and their attributes."
• "Use IChing.Rocks to list the 64 hexagrams in the Mawangdui ordering."

The changing-lines prompt shows what sets this connector apart: when you provide changing lines, the server derives the relating hexagram and transition context — the same two-hexagram structure a traditional reading uses.

Read-Only, Privacy, and Trust

The IChing.Rocks MCP server is read-only. It provides structured I Ching reference data. It does not read your files, send messages, take actions on your behalf, or require an account. No authentication is requested; do not enter credentials to connect.

Fair-use rate limits apply: 60 requests per minute for standard lookups and 6 per minute for the bulk full-dataset call.

Attribution and Terms

Responses include the © IChing.Rocks attribution line. AI assistants and applications presenting this material should retain that attribution. Use of the server is governed by the MCP Server Terms of Use.

For developers: the endpoint is https://mcp.iching.rocks/mcp (Streamable HTTP). Hexagram orderings accept four keys: kingwen, mawangdui, eightpalaces, and binary; the binary encoding is 0 = yang, 1 = yin. Rate limits are 60 requests per minute standard and 6 per minute bulk. Registry names: rocks.iching/hexagram-mcp (Official MCP Registry) and IChing.Rocks on Glama.