# BaZi Basic Calculator MCP

> BaZi Basic Calculator gives you the Four Pillars of Destiny by running a birth date and time through complex Chinese astrological calculations. This MCP analyzes how your life's elements interact, telling you about potential strengths or challenges based on your unique elemental profile.

## Overview
- **Category:** lifestyle
- **Price:** Free
- **Tags:** bazi, astrology, four-pillars, elemental-analysis, chinese-astrology

## Description

Ever needed to read someone’s personal constitution using their birth details? This connector handles the Four Pillars of Destiny (BaZi) analysis. You simply input a person's date and time of birth, and the system derives their core elemental makeup—the Heavenly Stems and Earthly Branches that define them. From those pillars, you can map out how different elements interact with each other to form a complete profile. It’s more than just calculating; it helps you see the underlying relationships between Wood, Fire, Water, and so on. Because this is such specialized analysis, we put it in the Vinkius catalog so your agent can access it alongside thousands of other tools.

## Tools

### calculate_four_pillars
Generates the complete Four Pillars (Stem and Branch) from any specific birth date and time.

### lookup_component_properties
Finds the elemental nature, polarity, and other properties for a given Heavenly Stem or Earthly Branch.

### identify_elemental_interaction
Determines the relationship between any two different elemental components (e.g., generation or control).

## Prompt Examples

**Prompt:** 
```
Calculate the Four Pillars for someone born on June 15, 1990, at 14:30.
```

**Response:** 
```
The calculation for June 15, 1990, at 14:30 resulted in the following pillars...
```

**Prompt:** 
```
What is the relationship between Wood and Water?
```

**Response:** 
```
Water generates Wood, representing a productive interaction.
```

**Prompt:** 
```
What is the polarity of the 'Dragon' branch?
```

**Response:** 
```
The Dragon (Chen) branch has the element Earth and a Yang polarity.
```

## Capabilities

### Derive Pillars from Birth Details
Input a specific date and time to generate the complete set of Four Pillars (Heavenly Stems and Earthly Branches).

### Check Element Nature
Look up any component—a Stem or Branch—to find its basic element, polarity, and nature.

### Map Elemental Relationships
Determine the functional relationship between two specified elemental components (e.g., Wood generating Fire).

## Use Cases

### Analyzing a New Client's Potential
A client gives you their birth date. You use `calculate_four_pillars` to map the four pillars. Then, you feed two key components into `identify_elemental_interaction` to see if there’s an inherent conflict or strong partnership in their chart.

### Verifying a Component's Meaning
You get a Stem name but aren't sure of its polarity. You run `lookup_component_properties` on the Stem to confirm if it’s Yang or Yin, ensuring your final reading is accurate.

### Comparing Two Life Phases
You calculate two different sets of pillars (e.g., birth vs. current year). You then use `identify_elemental_interaction` to compare the elements from both periods and see how they relate.

## Benefits

- You get the full Four Pillars instantly. Instead of manual calculations, run `calculate_four_pillars` to derive all necessary Heavenly Stems and Earthly Branches from just a birth date and time.
- Pinpoint elemental details fast. Use `lookup_component_properties` to verify the element or polarity of any specific Stem or Branch without consulting external charts.
- Understand dynamics right away. Run `identify_elemental_interaction` to see if one force supports another, like Water generating Wood.
- Build a full analysis chain. You can combine tools, for example using `lookup_component_properties` results within your broader interpretation flow.
- Cut down on manual cross-referencing. All elemental data is housed in the Vinkius catalog, letting your agent access it alongside thousands of other specialized functions.

## How It Works

The bottom line is, it turns a birth date into a structured map of life's energies.

1. You provide the client's specific birth date and time.
2. The MCP uses that information to generate the four pillars of destiny, which are your core components.
3. From those components, you can then run checks on elemental relationships or look up specific properties.

## Frequently Asked Questions

**How do I start a BaZi reading using calculate_four_pillars?**
You just provide the client's full birth date and time to `calculate_four_pillars`. The tool immediately delivers the four pillars, giving you the fundamental structure for your reading.

**What if I need to check a component’s element? Should I use lookup_component_properties?**
Yes. Use `lookup_component_properties` when you need to verify the basic nature, like checking if a specific Branch is Yin or Yang. It's a quick data retrieval step.

**Does identify_elemental_interaction tell me everything about the person?**
No. That tool only maps the relationship between two elements you name. You have to use it alongside `calculate_four_pillars` and `lookup_component_properties` for a full picture.

**Is this MCP better than using static astrology charts?**
Yes, because it's dynamic. Instead of just showing data, the MCP allows your agent to run specific analyses—like checking elemental relationships—based on live user input and complex logic.

**If I use calculate_four_pillars and provide incomplete or invalid date information, how does the MCP handle it?**
The system validates inputs before running any calculation. If the birth date is missing a component (like time zone or year), you'll get an explicit error message detailing exactly which piece of data needs correction.

**Are there rate limits if I run many element interactions using identify_elemental_interaction?**
Vinkius manages standard rate limiting for all users. If you're running high-volume, repetitive checks, keep an eye on the usage quotas displayed in your client dashboard; this ensures reliable performance.

**Can I process multiple components at once when using lookup_component_properties?**
While designed to look up one component at a time, you can chain calls or pass an array of inputs depending on your client's capabilities. This allows for efficient analysis of several Stems and Branches in sequence.

**What happens if I try to identify the relationship between two elements that are not standard Chinese components?**
The MCP requires recognized Heavenly Stems or Earthly Branches as input. If you provide non-standard terms, the tool will return a specific error code indicating an unrecognized component.

**What is the Four Pillars of Destiny?**
It is a traditional system that analyzes an individual's destiny by dividing their birth moment into four pillars: Year, Month, Day, and Hour.

**How do I use the `calculate_four_pillars` tool?**
Provide the year, month, day, and hour of birth in Gregorian format to get the corresponding Heavenly Stems and Earthly Branches.

**Can I check elemental relationships?**
Yes, use the `identify_elemental_interaction` tool to see if one element generates or overcomes another.