# I Ching Hexagram Engine AI Agent Connect

> Calculate primary, transformed, and nuclear hexagrams from line values or coin tosses.

## Overview
- **Category:** mathematics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_8clxzJV1uPDfQ0OetxnUudGpSSOLcgRce9JfndqM/ai-agent-connect
- **Tags:** iching, hexagram, trigram, divination, calculator

## Description

This MCP server provides a deterministic engine for the I Ching (Book of Changes). It allows AI agents to perform complex hexagram calculations, including identifying primary, transformed, and nuclear hexagrams. Users can provide direct line values (6, 7, 8, or 9) using `calculate_hexagram` or convert coin toss sequences into line values using `interpret_coin_toss`. The engine also supports retrieving specific trigram compositions via `get_trigram_details`.

## Tools

### calculate_hexagram
Computes the full suite of hexagram data based on provided line values

### get_trigram_details
Retrieves the name and composition of a specific trigram

### interpret_coin_toss
g., "HHT") into the corresponding I Ching line values.

Converts a sequence of coin toss results into numeric line values

## Prompt Examples

**Prompt:** 
```
Calculate the hexagram for these line values: [7, 8, 7, 7, 8, 7]
```

**Response:** 
```
The primary hexagram is 11. Tai / Peace.
```

**Prompt:** 
```
What is the hexagram for the coin toss sequence: ['HHT', 'TTH', 'HHH', 'TTT', 'HHT', 'TTH']?
```

**Response:** 
```
The resulting hexagram is 1. Qián / The Creative.
```

**Prompt:** 
```
Tell me about the trigram 'Heaven'.
```

**Response:** 
```
The trigram is Heaven, characterized by a pattern of three Yang lines.
```

## Frequently Asked Questions

**What are the valid line values?**
The valid line values are 6 (Old Yin), 7 (Young Yang), 8 (Young Yin), and 9 (Old Yang).

**How do I use coin tosses?**
You can use the `interpret_coin_toss` tool by providing an array of six 3-character strings representing the results of three coin tosses for each line.

**What is a nuclear hexagram?**
A nuclear hexagram is a hidden hexagram derived from the internal lines (2-3-4 and 3-4-5) of the primary hexagram.