# Yield Curve Analyzer MCP

> Yield Curve Analyzer interprets complex interest rate movements to assess market health and guide investment strategy. This MCP lets you analyze if the curve is Normal, Inverted, or Flat, calculate critical spreads like 2s10s, detect signs of recession risk, and generate specific allocation guidance based on current rates.

## Overview
- **Category:** finance
- **Price:** Free
- **Tags:** yield-curve, interest-rates, recession-risk, bond-strategy, macroeconomics

## Description

Interpreting the shape of the yield curve used to predict economic shifts. This MCP lets you determine if market rates are behaving normally, inverted, or flat. You can use the available tools to calculate key metrics, such as the 2s10s spread, giving immediate insight into bond market stress. If those spreads suggest trouble, a tool like `examine_recession_risk` flags potential downturn signals. Once you have that risk assessment, another function helps refine your approach by offering actionable investment strategies and target duration ranges. It's critical context for any serious portfolio manager to keep on hand in the Vinkius catalog.

## Tools

### get_allocation_guidance
Provides specific, actionable investment strategies and target duration ranges based on the market environment.

### calculate_curve_metrics
Performs detailed calculations to determine key metrics for the yield curve shape (Normal, Inverted, Flat).

### examine_recession_risk
Checks the current yield curve pattern specifically for indicators of potential recessionary signals.

## Prompt Examples

**Prompt:** 
```
What is the current state of the yield curve if 3m is 4%, 2y is 4.5%, and 10y is 4.2%?
```

**Response:** 
```
The yield curve is currently classified as Inverted, with a significant spread inversion detected.
```

**Prompt:** 
```
Calculate the spreads for these rates: 3m=3.5%, 6m=3.6%, 1y=3.8%, 2y=4.0%, 5y=4.2%, 10y=4.5%, 30y=4.7%.
```

**Response:** 
```
The classification is Normal, with a 2s10s spread of 0.5000% and a 3m10a spread of 1.0000%.
```

**Prompt:** 
```
What strategy should I use if the curve is inverted?
```

**Response:** 
```
For an Inverted curve, you should follow a Short Duration Strategy with a target duration range focused on lower maturity windows.
```

## Capabilities

### Classify curve shape
Determine if the market rates are trending normally, flatly, or inversely.

### Calculate yield spreads
Compute specific differences between various maturity bond yields (e.g., 3-month vs. 10-year).

### Assess recession risk
Analyze the curve's inversion patterns to identify potential signs of an economic downturn.

### Generate portfolio guidance
Receive customized investment strategies and recommended duration ranges based on current market data.

## Use Cases

### A portfolio manager needs to adjust for an unexpected downturn.
The PM runs `examine_recession_risk` and gets a high-alert flag. They immediately follow up by running `get_allocation_guidance`, which suggests shifting capital toward lower maturity windows, allowing them to act instantly without manual research.

### A fixed income analyst is building a report on market health.
The analyst feeds several data points into the MCP. First, they use `calculate_curve_metrics` to classify the current curve state. They then show their boss the precise spread values, making the analysis undeniable.

### A macroeconomist is presenting findings on bond market shifts.
The economist uses the MCP's capabilities to calculate metrics and generate a summary report for stakeholders. They can present not just *what* the curve looks like, but also what it means for asset allocation.

## Benefits

- Stop guessing about market risk. Running `examine_recession_risk` flags specific yield inversions that signal potential economic trouble before general news reports do.
- Get precise metrics, not opinions. Use `calculate_curve_metrics` to get hard numbers on spreads like 2s10s and 3m10a, grounding your analysis in quantitative data.
- Immediate strategy adjustment. After assessing the market, use `get_allocation_guidance` to receive a tailored set of investment tactics and duration targets.
- Saves hours of manual model building. Instead of cross-referencing multiple academic papers for curve interpretation, this MCP gives you structured outputs instantly.
- Directly links risk to action. You don't just know the market is unstable; you get a direct strategy recommendation on what assets to focus on.

## How It Works

The bottom line is you get immediate, quantitative insights into complex macroeconomic shifts that dictate bond strategy.

1. Input the specific interest rates (e.g., 3m, 2y, 10a) you want analyzed for a given date.
2. The MCP runs calculations to determine curve metrics and checks for spread inversions against known risk models.
3. You get back a classification (Normal/Inverted), specific spread values, and actionable guidance on duration targets.

## Frequently Asked Questions

**How does the Yield Curve Analyzer MCP help with recession risk?**
It uses the `examine_recession_risk` tool to look specifically at yield inversions. These pattern shifts are known indicators that signal potential economic slowdowns, giving you a quantitative risk flag.

**Do I need to run calculate_curve_metrics before get_allocation_guidance?**
While not mandatory, running `calculate_curve_metrics` first gives the allocation guidance tool deeper context. It ensures the strategy is based on calculated metrics rather than just raw data inputs.

**What does 'Normal' mean for my portfolio?**
A Normal curve indicates rates are generally increasing with maturity, suggesting a standard economic expansion cycle. This usually guides you toward longer duration targets, which `get_allocation_guidance` will confirm.

**Can I use the Yield Curve Analyzer MCP for bond futures?**
This MCP focuses on interpreting fixed yield curve data and providing strategic guidance. While the principles apply to futures, you must feed it standard spot rate inputs for accurate results.

**What data inputs does `calculate_curve_metrics` require for accurate spread calculation?**
It requires specific maturity dates and the corresponding yield percentages for each point. You must provide a clean, structured set of rates so the engine can accurately determine spreads like 2s10s.

**How does `get_allocation_guidance` adjust its recommendations if I use it when the curve is 'Flat'?**
The guidance shifts toward defensive positioning. It suggests maintaining shorter duration assets and focusing on liquidity preservation rather than aggressive yield capture.

**Can `calculate_curve_metrics` be used to compare yield curves across different years or periods?**
Yes, the tool handles batch analysis for comparison. You can input multiple date ranges in a single query to track shifts and changes in curve shapes over time.

**If `examine_recession_risk` provides an inconclusive signal, what is the next step?**
First, re-verify your input data for any outliers or missing points. If the risk remains ambiguous, consider supplementing this MCP's output with external economic indicators.

**How can I identify a potential recession using this tool?**
You can use the `examine_recession_risk` tool. It analyzes the spread between 2Y, 10Y, and 3M yields to identify if an inversion depth is high enough to trigger a recession signal.

**What does the `calculate_curve_metrics` tool provide?**
It provides the current classification of the yield curve (e.g., Normal or Inverted) and calculates key market spreads such as 2s10s and 3m10a.

**Can this tool help with bond portfolio management?**
Yes, by using `get_allocation_guidance`, you can receive specific recommendations on whether to shorten or extend your duration based on the identified curve shape.