# Williams Fractals Indicator MCP for AI Agents AI Agent Connect

> Williams Fractals Indicator MCP identifies specific price action patterns, structural support and resistance levels, and breakout signals. It uses a 5-bar pattern to pinpoint market peaks and valleys, giving your AI agent the mathematical precision needed to interpret market structure and momentum.

## Overview
- **Category:** technical-analysis
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_DU0fYWsuBHznJENAa4W5rDzxaUPe1Le75cc1mT2D/ai-agent-connect
- **Tags:** fractals, williams-fractals, price-action, breakout, market-structure

## Description

Trading involves a lot of guesswork when you're staring at raw price data. This MCP changes that by providing a deterministic way to identify Williams Fractal patterns. Instead of your AI agent trying to visually guess where a trend might turn, it can now pinpoint exact up-fractals and down-fractals based on a strict 5-bar pattern. This means your agent can identify clear peaks and valleys in the price action to establish reliable support and resistance levels. You can also have your agent monitor for breakouts, letting it know the moment price breaches a recent structural level. By connecting this to your preferred AI client through the Vinkius catalog, you're giving your agent a set of eyes that see market structure with mathematical certainty rather than just intuition. It turns messy price charts into actionable structural data.

## Tools

### check_breakout_signal
Determines if the current price has breached the most recent structural fractal levels. This helps your agent spot momentum shifts immediately.

### get_fractal_metrics
Calculates resistance, support, and fractal density from recent price movements. It provides the math behind the market structure.

### get_fractal_patterns
Locates all confirmed up-fractals and down-fractals in a price series. It finds the exact peaks and valleys in the data.

## Prompt Examples

**Prompt:** 
```
Can you find the recent highs and lows in this price data?
```

**Response:** 
```
I've analyzed the price series. Here are the confirmed fractal points:

| Type | Price | Index |
| :--- | :--- | :--- |
| **Up-Fractal** | 152.40 | 14 |
| **Down-Fractal** | 145.10 | 18 |

The market is currently oscillating between these two structural levels.
```

**Prompt:** 
```
Is the current price of 155 a breakout?
```

**Response:** 
```
Yes, this is an **Up-Breakout**. 

The current price of **155.00** has successfully breached the most recent up-fractal level of **152.40**. This indicates a break of the recent local resistance.
```

**Prompt:** 
```
What are the current support and resistance levels?
```

**Response:** 
```
Based on the most recent fractal activity, here are the key structural levels:

*   **Resistance:** 152.40 (Recent Up-Fractal)
*   **Support:** 145.10 (Recent Down-Fractal)
*   **Fractal Density:** High (indicating significant recent volatility).
```

## Capabilities

### Identify price peaks and valleys
Find confirmed up-fractals and down-fractals within any provided price series.

### Calculate structural levels
Determine specific resistance and support levels based on recent fractal activity.

### Detect market breakouts
Check if current price action has broken through established structural levels.

### Measure market density
Analyze how frequently fractals are occurring to gauge market volatility and activity.

## Use Cases

### Automated Breakout Monitoring
A trader wants to know when a stock breaks a recent high. They ask their agent to use check_breakout_signal to monitor the price against the last up-fractal.

### Support and Resistance Mapping
An analyst needs to find where price might bounce. They have their agent run get_fractal_metrics to identify the most recent structural levels.

### Trend Exhaustion Detection
A quant wants to see if volatility is increasing. They use get_fractal_patterns to check the density of recent price turns.

### Backtesting Structural Logic
A developer tests a strategy by asking their agent to identify all historical fractals in a dataset using get_fractal_patterns.

## Benefits

- Eliminate manual charting by letting your agent find peaks and valleys using get_fractal_patterns.
- Get instant alerts on price breaches using check_breakout_signal to catch momentum early.
- Define clear trading zones by using get_fractal_metrics to find support and resistance.
- Remove human bias from pattern recognition with deterministic 5-bar fractal logic.
- Speed up technical analysis by feeding raw price data directly to your agent for processing.

## How It Works

The bottom line is you get mathematical market structure instead of visual guesses.

1. Connect your AI client to the MCP via Vinkius.
2. Feed price data or specific price series to your agent.
3. Receive precise structural levels and breakout signals.

## Frequently Asked Questions

**How does the Williams Fractals Indicator MCP identify market turns?**
It uses a deterministic 5-bar pattern to identify confirmed peaks and valleys in price action, providing objective data for your agent.

**Can I use this MCP to detect breakouts in real-time?**
Yes. You can have your agent check if the current price has breached the most recent structural levels identified by the fractal patterns.

**Does this MCP work with any price data?**
Yes, as long as you provide a price series to your agent, it can process that data to find fractals and structural levels.

**How does this help with technical analysis?**
It automates the identification of support, resistance, and breakout signals, removing the need for manual chart drawing.

**Can I use this with Claude or Cursor?**
Yes, you can connect this MCP to any compatible client like Claude, Cursor, or Windsurf via the Vinkius platform.

**What is a Williams Fractal?**
A Williams Fractal is a five-bar price pattern where the middle bar's high (for up-fractals) or low (for down-fractals) is the highest or lowest among the surrounding four bars.

**How is the breakout signal calculated?**
The `check_breakout_signal` tool determines a breakout when the current price closes strictly above the most recent confirmed Up-Fractal or strictly below the most recent confirmed Down-Fractal.

**Is there a delay in fractal detection?**
Yes, because a fractal requires two subsequent bars to confirm the pattern, there is a 2-bar confirmation lag before a fractal is considered valid.