🧭 Fortune Compass Agent

An AI-powered fortune telling divination Agent (ChatGPT App/MCP) that integrates traditional Tarot, Zhouyi (I Ching), and Guangong Oracle into a unified digital experience. The agent performs real-world drawing logic (shuffling and orientation) and uses LLM intelligence to interpret the results.

Deploy at AI Agent A2Z Agent Deployment Workspace Doc and Live URL https://derekzz.aiagenta2z.com/fortune-compass-agent/mcp

🔮 Agent ChatGPT App Features

🃏 Tarot

• Complete Deck: Randomly draws from all 78 cards.
• Orientation Logic: 1. Simulates a physical draw with a 50/50 chance. 2. If 0: Display the Upright meaning. 3. If 1: Display the Reversed meaning.
• Example Prompt: "What should I focus on to succeed in my career right now?"

☯️ Zhouyi (I Ching)

• Hexagram Generation: Generates a 6-line hexagram using randomized binary logic ($2^6 = 64$ combinations).
• Binary Mapping: Maps results to specific assets based on binary strings (e.g., 000000.jpg).

🏮 Guangong Oracle

• Divine Lots: Traditional temple-style randomized draws for spiritual guidance.

🚀 Getting Started

1. Installation & Build

Install dependencies and compile the TypeScript source code into executable JavaScript:

pnpm install
pnpm build

# Start the static file server (Port 4444)
pnpm run serve &
# Start the main agent server
pnpm start

Change port

PORT=9000 pnpm start

2. Tool

The agent exposes the following primary tool to the LLM:

tell_fortune: Tell Your Fortune by Divination via Tarot, ZhouYi, or Guangong Drawing and Asking prompt: The question you want to ask method: all,tarot,zhouyi,guangong

3. Deployment

Deploy to DeepNLP Workspalce and Live URL(https://derekzz.aiagenta2z.fortune-compass-agent/mcp)