# Swing Index Calculator MCP for AI Agents AI Agent Connect

> Swing Index Calculator MCP for technical market analysis. It calculates Welles Wilder's Swing Index (SI) and Cumulative Swing Index (CSI) from price data, helping you identify momentum shifts, trend strength, and price divergence using deterministic mathematical models.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Ci5EYAbgR1JPUrds8xdnuUJL0NjRZyfiBz8WQCuz/ai-agent-connect
- **Tags:** momentum, welles-wilder, swing-index, csi, volatility

## Description

Trading momentum is notoriously hard to pin down when you're staring at raw price charts all day. This MCP changes that by bringing Welles Wilder's specific momentum math directly into your AI client. Instead of you manually calculating complex formulas or trying to prompt an agent to guess trend strength, this tool provides the exact, deterministic values for the Swing Index and Cumulative Swing Index. You can feed raw OHLC data into your agent and immediately get a clear picture of whether a trend is accelerating or exhausting. It handles the heavy lifting of calculating volatility context and detecting zero-line crosses, so your agent can focus on interpreting what those shifts actually mean for a position. By connecting this to your workflow through the Vinkius catalog, you turn a standard LLM into a specialized technical analyst that understands price intensity and momentum divergence without the guesswork.

## Tools

### analyze_csi_signals
Detects trend shifts and zero-line crosses in the Cumulative Swing Index. It helps identify when momentum is flipping from bullish to bearish.

### calculate_swing_metrics
Computes the Swing Index and Cumulative Swing Index from provided price data. This provides the core momentum values needed for analysis.

### get_volatility_context
Evaluates price intensity relative to a defined limit move. It helps determine if a move is a significant breakout or just noise.

## Prompt Examples

**Prompt:** 
```
Can you calculate the swing metrics for these prices: [{'open': 100, 'high': 105, 'low': 98, 'close': 103}, {'open': 103, 'high': 108, 'low': 102, 'close': 107}] with a limit move of 5?
```

**Response:** 
```
Based on the provided data and a limit move of 5:

| Metric | Value |
| :--- | :--- |
| **Swing Index (SI)** | 12.5 |
| **Cumulative Swing Index (CSI)** | 12.5 |

The momentum shows a clear upward movement for the second period.
```

**Prompt:** 
```
Are there any trend signals in this CSI series: [0.5, 1.2, 2.5, 0.1, -0.5]?
```

**Response:** 
```
Yes, a trend shift was detected.

* **Signal Type:** Bearish Zero-Line Cross
* **Details:** The CSI moved from a positive **0.1** to a negative **-0.5**, indicating that momentum has shifted from bullish to bearish.
```

**Prompt:** 
```
Check if this price move is significant: [{'high': 110, 'low': 100, 'close': 105}] with a limit move of 10.
```

**Response:** 
```
The volatility analysis for this move is as follows:

* **Average Volatility Ratio:** 1.0
* **Maximum Swing Intensity:** 15.0

The movement is consistent with the defined limit, suggesting a standard volatility profile for this period.
```

## Capabilities

### Calculate momentum metrics
Derive precise Swing Index and Cumulative Swing Index values from raw price data.

### Detect trend shifts
Identify zero-line crosses and momentum reversals in the CSI series.

### Assess price intensity
Compare current price movement against volatility limits to gauge trend strength.

### Identify price divergence
Spot mismatches between price action and momentum indicators.

## Use Cases

### Detecting momentum exhaustion
A trader notices a price rally but asks their agent to check analyze_csi_signals to see if the momentum is actually fading.

### Validating breakouts
An analyst uses get_volatility_context to confirm if a sudden price spike is a real trend or just standard volatility.

### Automating trend tracking
A quant feeds daily OHLC data into the agent to run calculate_swing_metrics and track the CSI trend over time.

### Spotting divergence
An agent compares recent price highs against the CSI values to find hidden weakness in a trending market.

## Benefits

- Eliminate manual math by using calculate_swing_metrics to get instant SI and CSI values.
- Spot trend reversals faster with analyze_csi_signals detecting zero-line crosses.
- Filter out market noise using get_volatility_context to see if moves are truly significant.
- Get deterministic results instead of relying on an LLM's shaky mental math for technical indicators.
- Identify momentum divergence by comparing price action against calculated swing values.

## How It Works

The bottom line is you turn raw price data into actionable momentum signals.

1. Provide your raw OHLC (Open, High, Low, Close) price data to your AI client.
2. The agent uses the mathematical formulas to process the price points and volatility limits.
3. You receive specific Swing Index values and trend signals to inform your analysis.

## Frequently Asked Questions

**How can I use the Swing Index Calculator MCP for my trading?**
You can use it to turn raw price data into precise momentum indicators. It allows your AI agent to calculate the Swing Index and detect trend shifts automatically.

**Does the Swing Index Calculator MCP provide accurate math?**
Yes. Unlike standard LLMs that might struggle with arithmetic, this MCP uses deterministic formulas to ensure your momentum calculations are mathematically exact.

**Can I detect trend reversals with the Swing Index Calculator MCP?**
Yes. You can use the tool to identify zero-line crosses in the Cumulative Swing Index, which is a primary signal for momentum reversals.

**Can I connect the Swing Index Calculator MCP to Claude or Cursor?**
Yes. You can connect this MCP to any compatible client like Claude, Cursor, or Windsurf to perform technical analysis directly in your chat interface.

**What is the difference between SI and CSI in this MCP?**
The Swing Index (SI) measures immediate momentum, while the Cumulative Swing Index (CSI) tracks the trend over time. This MCP calculates both from your price data.