# Williams %R Calculator MCP for AI Agents AI Agent Connect

> Williams %R Calculator MCP provides a deterministic engine for technical market analysis. It lets your AI agent calculate momentum levels, identify overbought and oversold conditions, and spot critical signals like price-momentum divergence and failure swings in real-time.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_HwntTMhQ5jM0eQH3IkhDOvHirX7Ub8k3vuvXeSZi/ai-agent-connect
- **Tags:** trading, momentum, oscillator, indicators, market-analysis

## Description

Trading requires precision, not guesswork. This MCP gives your AI agent the mathematical backbone needed to interpret market momentum using the Williams %R oscillator. Instead of asking your agent to approximate math, you give it a deterministic engine that handles the heavy lifting of technical analysis. You can have your agent scan price data to find specific momentum levels or identify when price action and momentum are moving in opposite directions. It also spots failure swings, which are vital for catching trend reversals before they happen. By connecting this to your preferred AI client through the Vinkius catalog, you turn a standard chat interface into a sophisticated technical analysis workstation. You stop asking 'what do you think the trend is' and start asking 'where is the momentum diverging' with mathematical certainty.

## Tools

### calculate_williams_r
Computes raw Williams %R values for a price series. It provides the exact oscillator numbers needed for momentum analysis.

### detect_divergence
Finds discrepancies between price action and momentum. This helps identify when a trend is losing steam.

### identify_failure_swings
Spots potential trend reversals. It looks for failed momentum attempts that signal a change in direction.

## Prompt Examples

**Prompt:** 
```
Calculate the Williams %R for these prices: High [10, 12, 11], Low [8, 9, 7], Close [9, 11, 8] with a period of 3.
```

**Response:** 
```
The calculated Williams %R values are:

| Index | Williams %R |
| :--- | :--- |
| 1 | -33.33 |
| 2 | -16.67 |
| 3 | -66.67 |
```

**Prompt:** 
```
Check if there is a divergence in this data: Price [100, 105, 102], WilliamsR [ -50, -40, -60].
```

**Response:** 
```
A **Bearish Divergence** was detected at index 2. The price reached a higher high, but the momentum strength failed to follow suit.
```

**Prompt:** 
```
Are there any failure swings in this recent price action?
```

**Response:** 
```
Based on the provided data, **no failure swings were identified**. The momentum remains consistent with the current price trend.
```

## Capabilities

### Calculate momentum levels
Get exact Williams %R values from any series of high, low, and closing prices.

### Spot price-momentum gaps
Find instances where price movement and momentum strength are no longer in sync.

### Detect trend reversals
Identify potential shifts in market direction through failed momentum attempts.

### Identify market extremes
Pinpoint overbought and oversold conditions within specific price ranges.

## Use Cases

### Catching a trend reversal
A trader notices a price peak and asks their agent to check for failure swings to confirm if the trend is actually breaking.

### Confirming momentum exhaustion
An analyst provides recent price data to see if a bullish move is showing bearish divergence.

### Scanning for overbought assets
A user feeds a week of price data to their agent to find which stocks are currently in oversold territory.

### Validating custom indicators
A developer uses the precise outputs to check if their own momentum logic matches standard Williams %R math.

## Benefits

- Eliminate manual math errors by using deterministic calculations for every oscillator value.
- Speed up trend analysis by having your agent instantly flag divergence and failure swings.
- Get consistent technical signals that don't drift like standard LLM reasoning might.
- Identify overbought and oversold zones without manually plotting charts.
- Automate the heavy lifting of momentum-based technical analysis.

## How It Works

The bottom line is you get deterministic technical indicators delivered through a natural language interface.

1. Connect your AI client to the Williams %R Calculator via Vinkius.
2. Feed your price data series directly into the chat interface.
3. Receive precise technical signals and momentum calculations instantly.

## Frequently Asked Questions

**How can I use Williams %R Calculator for my trading strategy?**
You can use it to identify overbought or oversold conditions and to spot momentum divergences that suggest a trend might be ending.

**Can this Williams %R Calculator work with my existing charts?**
Yes. You can copy your price data into your AI client and use this MCP to generate the exact technical indicators you need to validate what you see on your charts.

**Does the Williams %R Calculator detect trend reversals?**
Yes, it can identify potential trend reversals by detecting failure swings where momentum fails to sustain a price move.

**Is the math in Williams %R Calculator accurate?**
Yes. This is a deterministic engine, meaning it provides exact mathematical results rather than an AI's best guess.

**Can I use Williams %R Calculator to find divergences?**
Absolutely. It has a specific capability to find discrepancies between price action and momentum strength.

**What is the Williams %R oscillator?**
The Williams %R is a momentum indicator that measures overbought and oversold levels by comparing the current closing price to a specific range of high and low prices over a set period.

**How do I detect a trend reversal?**
You can use the `identify_failure_swings` tool to detect potential trend reversals where price attempts to break a previous swing but momentum fails to follow.

**Can I detect divergences between price and momentum?**
Yes, the `detect_divergence` tool identifies Bullish and Bearish divergences by comparing price action against the Williams %R series.