# Ichimoku Cloud Calculator MCP for AI Agents AI Agent Connect

> Ichimoku Cloud Calculator MCP provides a deterministic engine for technical analysis. It calculates all Ichimoku Kinko Hyo components, including Tenkan-sen, Kijun-sen, and Senkou Spans, from raw price data. Your agent can instantly identify momentum signals, cloud thickness, and price positioning to assist in market analysis.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_y8SrL3p2cUZrkSPCT1YdCGuYmFfnfHRELapZV8D3/ai-agent-connect
- **Tags:** ichimoku, trading, indicators, finance, technical-analysis

## Description

Technical analysis often feels like a chore of manual math and constant chart checking. Instead of manually calculating lagging lines or squinting at cloud thickness, you can hand your price data to an agent and get immediate, mathematically precise results. This MCP acts as a dedicated calculation engine that handles the heavy lifting of the Ichimoku Kinko Hyo system. It processes price series to output every necessary component, from the Tenkan-sen to the Chikou Span. 

Once the math is done, your agent can interpret the results. It can tell you if the price is currently trapped inside a cloud, if the cloud is thickening or thinning, or if a specific momentum crossover has just occurred. By connecting this to your preferred AI client through the Vinkius catalog, you turn a text-based assistant into a sophisticated technical analyst that doesn't make arithmetic errors. You stop worrying about the formulas and start focusing on the market signals.

## Tools

### detect_tk_cross
Identifies if a bullish or bearish Tenkan-sen/Kijun-sen crossover has occurred. This helps spot immediate momentum shifts.

### analyze_kumo_status
Determines the relationship between the current price and the cloud. It also calculates how thick the cloud is at the current moment.

### calculate_ichimoku_components
Calculates the raw Ichimoku indicator lines for a given series of price data. It provides the exact values for all five essential components.

## Prompt Examples

**Prompt:** 
```
Here is the price data: High [10, 12, 11], Low [8, 9, 10], Close [9, 11, 10]. What are the Ichimoku components?
```

**Response:** 
```
Based on the price data provided, here are the calculated Ichimoku components:

| Component | Value |
| :--- | :--- |
| **Tenkan-sen** | 10.0 |
| **Kijun-sen** | 9.5 |
| **Senkou Span A** | 9.75 |
| **Senkou Span B** | 9.5 |
| **Chikou Span** | 10.0 |
```

**Prompt:** 
```
Is the current price of 105 above, below, or inside a cloud where Span A is 100 and Span B is 95?
```

**Response:** 
```
The price of **105** is currently **above the cloud** (since 105 > 100).
```

**Prompt:** 
```
Check if there is a TK cross for these values: Tenkan-sen [10, 12] and Kijun-sen [11, 11].
```

**Response:** 
```
A **bullish signal** has been detected for the most recent data point.
```

## Capabilities

### Generate full indicator sets
Produces all five Ichimoku Kinko Hyo lines from a provided series of high, low, and close prices.

### Identify momentum crossovers
Detects bullish or bearish Tenkan-sen and Kijun-sen crossings at the most recent data point.

### Evaluate cloud positioning
Determines if the current price is above, below, or inside the Kumo cloud.

### Measure cloud thickness
Calculates the distance between Senkou Span A and Senkou Span B to gauge support and resistance strength.

## Use Cases

### Rapid Trend Verification
A trader pastes a week of price data into Claude and asks if the current trend is bullish based on the cloud position.

### Momentum Signal Scanning
An analyst uses the agent to check if a specific stock just experienced a TK cross to confirm a breakout.

### Volatility Assessment
A researcher asks the agent to compare cloud thickness across different assets to find periods of low volatility.

### Automated Technical Audits
A developer uses the engine to verify that their manual chart readings match the mathematical reality of the indicator.

## Benefits

- Eliminate math errors by using a deterministic engine for all Ichimoku calculations.
- Get instant momentum alerts using detect_tk_cross to spot Tenkan-sen and Kijun-sen shifts.
- Understand market sentiment quickly by using analyze_kumo_status to check price vs cloud position.
- Speed up trend analysis by generating full indicator sets with a single command.
- Quantify support and resistance by calculating the exact thickness of the Kumo cloud.

## How It Works

The bottom line is you provide the price data and get back precise technical signals without doing any manual math.

1. Provide a list of price data including highs, lows, and closes to your agent.
2. The agent uses the calculation engine to process the raw numbers into Ichimoku components.
3. You receive a clear breakdown of the indicator lines and specific momentum signals.

## Frequently Asked Questions

**How can I use the Ichimoku Cloud Calculator MCP for my trading?**
You can use it to instantly convert raw price data into precise Ichimoku indicator values, allowing your AI agent to identify trends and momentum signals.

**Does the Ichimoku Cloud Calculator MCP provide accurate math?**
Yes. This MCP uses a deterministic engine, meaning it provides exact mathematical results for all Ichimoku components rather than letting an AI guess the numbers.

**Can I detect momentum shifts with the Ichimoku Cloud Calculator MCP?**
Yes, you can use it to identify bullish or bearish Tenkan-sen and Kijun-sen crossovers to spot changes in market momentum.

**Will the Ichimoku Cloud Calculator MCP tell me if a price is in a trend?**
Yes, you can use it to determine if the current price is above, below, or inside the Kumo cloud to help identify the prevailing trend.

**Can I check the strength of support and resistance using this MCP?**
Yes, by calculating the thickness of the cloud, you can gauge the strength of the support and resistance levels provided by the Kumo.

**What components does this server calculate?**
The server calculates Tenkan-sen, Kijun-sen, Senkou Span A, Senkou Span B, and Chikou Span, and provides tools to analyze Kumo status and TK crosses.

**How do I detect a trend reversal?**
You can use the `detect_tk_cross` tool to identify bullish or bearish crossovers between the Tenkan-sen and Kijun-sen lines.

**Can I customize the indicator periods?**
Yes, the `calculate_ichimoku_components` tool allows you to specify custom periods for Tenkan-sen, Kijun-sen, Senkou Span B, and displacement.