# Put/Call Ratio Calculator MCP for AI Agents AI Agent Connect

> Put/Call Ratio Calculator MCP for analyzing options market sentiment. It calculates volume and open interest ratios, identifies statistical extremes like z-scores and percentiles, and tracks sentiment trends through moving averages to help you spot market shifts.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_4JKEdPsDXSsuP3o2XaD266sfIuIwNiuGMB3duE9r/ai-agent-connect
- **Tags:** pcr, options, sentiment, volatility, trading-signals

## Description

Analyzing options sentiment usually means jumping between multiple trading terminals, manually pulling volume data, and then trying to figure out if a current ratio is actually an outlier or just noise. This MCP changes that by giving your AI client the math it needs to interpret Put/Call Ratios instantly. Instead of you doing the heavy lifting, your agent can calculate volume and open interest ratios, check if the current sentiment is hitting a statistical extreme using z-scores, and smooth out the volatility with moving averages. It turns raw options data into actionable sentiment signals. Since Vinkius hosts this in a managed environment, you don't have to worry about setting up complex math libraries or local environments; you just connect your preferred client and start asking questions about market extremes and sentiment trends.

## Tools

### analyze_sentiment_and_extremes
Calculates sentiment classifications, percentiles, and z-scores. It helps you spot when sentiment is at a statistical extreme.

### calculate_moving_averages
Smooths PCR data using moving averages. This makes it easier to see long-term sentiment trends without the daily noise.

### calculate_pcr_metrics
Computes primary volume and open interest PCR values. It provides the foundational ratios needed for sentiment analysis.

## Prompt Examples

**Prompt:** 
```
What is the PCR for 5000 puts and 4000 calls, and what is the open interest ratio for 10000 puts and 8000 calls?
```

**Response:** 
```
Based on the numbers provided:

| Metric | Value |
| :--- | :--- |
| **Volume PCR** | 1.25 |
| **Open Interest PCR** | 1.25 |

Both the volume and open interest ratios are currently at 1.25.
```

**Prompt:** 
```
Is a PCR of 1.2 extreme given this recent history: [0.8, 0.9, 1.1, 1.0, 1.2]?
```

**Response:** 
```
The current PCR of **1.2** is considered **Bearish**. 

Here is the statistical breakdown:
* **Percentile Rank:** 1.0
* **Z-Score:** 0.74

While the sentiment is bearish, the z-score suggests it is not yet a massive statistical outlier compared to the recent history.
```

**Prompt:** 
```
Can you show me the 21-day trend for these PCR values: [0.7, 0.8, 0.75, 0.82, 0.78, 0.8, 0.79, 0.81, 0.8, 0.77, 0.76, 0.75, 0.74, 0.73, 0.72, 0.71, 0.7, 0.69, 0.68, 0.67, 0.66]?
```

**Response:** 
```
The smoothed trend for the provided series is as follows:

* **21-Day Moving Average:** 0.74

The trend shows a gradual decline in the PCR, suggesting a shift toward more bullish sentiment over this period.
```

## Capabilities

### Calculate core PCR ratios
Get immediate volume and open interest Put/Call ratios for any given set of options data.

### Identify sentiment extremes
Determine if current market sentiment is a statistical outlier using percentile ranks and z-scores.

### Smooth sentiment trends
Apply moving averages to PCR data to filter out noise and see the underlying sentiment direction.

### Classify market sentiment
Automatically categorize sentiment as Bullish, Bearish, or Neutral based on calculated ratios.

## Use Cases

### Spotting contrarian signals
A trader notices a massive spike in put volume and asks their agent to check if the z-score indicates a historical extreme.

### Trend confirmation
An analyst uses moving averages to confirm if a recent shift in Put/Call ratios is a lasting trend or just a one-day fluke.

### Rapid sentiment auditing
A researcher needs to quickly classify whether current open interest suggests bullish or bearish sentiment for a specific ticker.

### Automated outlier detection
An agent monitors a series of PCR values and alerts the user when a percentile rank hits a specific threshold.

## Benefits

- Stop manual math by letting your agent use calculate_pcr_metrics for instant ratio results.
- Spot market reversals faster by using analyze_sentiment_and_extremes to find statistical outliers.
- Filter out daily market noise by using calculate_moving_averages to see the real trend.
- Get instant sentiment labels like Bullish or Bearish without interpreting raw numbers yourself.
- Validate sentiment strength using z-scores and percentile ranks provided by the analysis tools.

## How It Works

The bottom line is you provide the raw options numbers and get back instant, statistically-backed sentiment analysis.

1. Connect your AI client to the Put/Call Ratio Calculator via Vinkius
2. Provide your agent with raw put and call volume or open interest numbers
3. Receive formatted sentiment classifications, z-scores, or smoothed trend data

## Frequently Asked Questions

**How can I use the Put/Call Ratio Calculator to find market extremes?**
You can provide your agent with recent PCR data, and it will use statistical tools to calculate z-scores and percentile ranks, identifying exactly when sentiment hits an outlier level.

**Can this Put/Call Ratio Calculator help me identify bullish or bearish trends?**
Yes. The MCP calculates the ratios and classifies the sentiment, and you can also use moving averages to smooth out the data and see the direction of the trend.

**Does the Put/Call Ratio Calculator work with my existing AI client?**
Yes, as long as you are using an MCP-compatible client like Claude, Cursor, or Windsurf, you can connect to this MCP through Vinkius and start using it immediately.

**What is the difference between volume and open interest PCR in this tool?**
The tool allows you to calculate both. Volume PCR looks at daily trading activity, while Open Interest PCR looks at the total number of outstanding contracts, providing a different view of sentiment.

**How do I get statistical z-scores for my options data?**
Simply give your agent the current PCR and a historical series of data. The agent will use the built-in analysis tools to return the z-score and percentile rank.