# Feng Shui Bagua Mapper MCP

> Feng Shui Bagua Mapper uses ancient energy principles to map your physical floor plan onto the universal Bagua energy grid. Simply input your home's main entrance direction and dimensions, and this MCP calculates exactly which life areas—like Wealth or Career—correspond to every room in your house. It turns a simple blueprint into an actionable guide for optimizing space flow.

## Overview
- **Category:** architecture
- **Price:** Free
- **Tags:** bagua, floor-plan, orientation, energy-mapping, spatial-intelligence

## Description

Designing a space shouldn't be guesswork. This MCP connects the physical structure of your home to the spiritual energy map used in Feng Shui. By giving your agent the orientation of your main doorway, you first determine the rotational offset needed for the entire house. Next, you apply this rotation to specific coordinates or room layouts. The system calculates which major life areas—such as Love, Wealth, or Career—are governing each space. This process bridges architectural drawing and spatial energy analysis, helping designers optimize rooms before a single wall is built. You connect your agent through Vinkius, accessing thousands of specialized tools across the catalog to make sure every design choice has an energetic purpose.

## Tools

### get_orientation_offset
Converts various entrance descriptions into a standardized numerical rotation value used across the map.

### analyze_room_layout
Takes a group of rooms and produces a complete mapping linking room names to their governing Life Areas.

### map_coordinate_to_area
Determines which single Life Area covers any specific point in space once the rotation offset is applied.

## Prompt Examples

**Prompt:** 
```
What is the rotation offset for a North entrance?
```

**Response:** 
```
A North entrance corresponds to a 0 degree rotation offset.
```

**Prompt:** 
```
Analyze this room: Name: Kitchen, X: 5, Y: -2 with a 45 degree offset.
```

**Response:** 
```
The Kitchen is located in the Wealth & Prosperity sector.
```

**Prompt:** 
```
Map a layout with two rooms: Living Room (0, 0) and Bedroom (2, 2), rotation offset 90.
```

**Response:** 
```
The Living Room maps to the Career & Life Path area, and the Bedroom maps to the Children & Creativity area.
```

## Capabilities

### Determine Entrance Angle
Converts common entrance descriptions into a precise numerical degree offset.

### Map Room Areas by Layout
Takes a collection of room names and assigns them to their corresponding Bagua Life Area.

### Identify Energy at Coordinates
Pinpoints the single governing life area for any specific point (X, Y) on your floor plan based on rotation.

## Use Cases

### Redesigning an Office Space
An architect needs to redesign a corporate office floor plan for optimal team performance. They use the MCP to run `analyze_room_layout` on all department rooms, ensuring that key meeting areas map strongly to 'Career & Life Path' before presenting the final concept.

### Assessing New Home Purchases
A client buys a house and needs to know its energetic potential. They feed the room names into the MCP, which then maps them using `analyze_room_layout` against the main entrance direction found via `get_orientation_offset`, providing an immediate energy report.

### Optimizing a Bedroom Layout
A decorator wants to place a new bed. Instead of guessing, they use `map_coordinate_to_area` at the exact coordinates where the headboard will sit, ensuring that spot falls within the 'Love' sector for maximum effect.

### Verifying Layout Changes
An architect changes a room's boundary. They use `map_coordinate_to_area` on the corner coordinates to confirm the new boundaries haven't accidentally moved a high-value area, like 'Wealth & Prosperity'.

## Benefits

- Pinpoint energy problems instantly. Instead of guessing, you use the `map_coordinate_to_area` tool to know precisely which life area governs any given spot on your blueprint.
- Save hours of cross-referencing. The `analyze_room_layout` tool takes a whole collection of rooms and maps them all at once, eliminating manual sector checks.
- Start with the basics. Use `get_orientation_offset` to standardize your main entrance direction into a usable degree rotation offset for all subsequent calculations.
- Gain true spatial intelligence. This MCP doesn't just tell you what area something is; it tells you its energetic meaning (e.g., Career, Love).
- Validate design changes risk-free. Before altering a wall or moving a fixture, check the energy impact using this connector.

## How It Works

The bottom line is that you get an immediate, accurate map overlaying universal energy principles onto your current architectural blueprint.

1. Start by providing your main entrance's direction or description to establish a numerical rotation offset.
2. Next, input the dimensions and names of the rooms you need analyzed for energy flow.
3. The MCP calculates and maps these rooms, showing which specific life areas govern each section of the plan.

## Frequently Asked Questions

**What does the Feng Shui Bagua Mapper MCP need to start?**
The first thing it requires is an understanding of your main entrance's orientation. You use the `get_orientation_offset` tool to convert that direction into a standardized numerical value.

**Can I map a partial room layout with Feng Shui Bagua Mapper?**
Yes, you can. If you only have dimensions for certain areas, the MCP will use `map_coordinate_to_area` to tell you exactly what energy zone those specific coordinates fall into.

**Does this MCP work if my house isn't rectangular?**
The system works with any defined layout. As long as you can provide the room names and dimensions, tools like `analyze_room_layout` will accurately assign energy areas.

**How do I use Feng Shui Bagua Mapper to check a new furniture placement?**
You would run a coordinate analysis. Use `map_coordinate_to_area` and input the proposed coordinates, letting the MCP tell you if that spot is favorable or unfavorable for your needs.