# Swing Trading Strategy Engine AI Agent Connect

> A deterministic multi-timeframe engine for identifying high-probability swing trading pullbacks.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_YEvMWrbRL10eg9RVM68HeWI9HTCPhXucWNUY1NIB/ai-agent-connect
- **Tags:** swing-trading, technical-analysis, moving-averages, rsi, risk-management

## Description

This MCP server provides a deterministic multi-timeframe analysis engine designed for swing traders. It identifies high-probability pullbacks by ensuring the macro trend is bullish via a 10-week Moving Average, then triggers entries when daily prices retreat to the 20-day Moving Average while RSI is in a 'resting' state (40-50). The engine includes built-in risk management with automated stop-loss and take-profit calculations, and a specialized `filter_gap_risk` tool to avoid entering trades immediately before earnings announcements. Use `calculate_signals` to generate actionable trade entries and `get_swing_metrics` to evaluate the strength of a setup.

## Tools

### calculate_signals
Analyzes historical price data to generate a series of Buy, Sell, or Hold signals based on multi-timeframe logic

### filter_gap_risk
Evaluates if a specific date is safe to enter a trade based on upcoming corporate news

### get_swing_metrics
Provides a detailed breakdown of the strength and characteristics of a specific trading setup

## Prompt Examples

**Prompt:** 
```
Generate trading signals for these closing prices: [150, 152, 148, 147, 149, 155, 158] with a 10-week MA, 20-day MA, 50-day MA, and 14-period RSI.
```

**Response:** 
```
BUY at 149.00, Stop-Loss: 141.55, Take-Profit: 163.90, Swing Quality: 0.85
```

**Prompt:** 
```
Evaluate the quality of this setup with price 150, 20-day MA 148, 50-day MA 140, and RSI 45.
```

**Response:** 
```
qualityScore: 0.88, proximityScore: 0.92, momentumScore: 0.75
```

**Prompt:** 
```
Is it safe to enter a trade on 2024-05-15 if earnings are scheduled for 2024-05-18?
```

**Response:** 
```
isSafe: false, daysUntilEarnings: 3
```

## Frequently Asked Questions

**How does the engine determine a valid entry?**
A valid entry requires the price to be above the 10-week Moving Average, a pullback to the 20-day Moving Average, and an RSI between 40 and 50, provided no earnings are imminent.

**Can I use this with Cursor or Claude Desktop?**
Yes, you can connect this engine to Cursor, Claude Desktop, VS Code, Windsurf, and any other MCP-compatible client via Vinkius Edge.

**What is the purpose of the `filter_gap_risk` tool?**
The `filter_gap_risk` tool checks if an upcoming corporate earnings announcement occurs within 5 days of your target entry date to prevent unexpected price gaps.