# Investment Return Calculator AI Agent Connect

> Investment Return Calculator is a financial analysis MCP that lets your AI client perform complex math on investment data. It handles everything from basic percentage changes to annualized geometric mean returns. You can use it to compare different investment scenarios or get a qualitative summary of your gains and losses without manual calculation.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_0seKPNJV8qtWIEsQ69KLnL8ESF8reiQh1uMgjfJF/ai-agent-connect
- **Tags:** investment, returns, finance, percentage, analysis

## Description

You can stop manually running formulas in spreadsheets to check how your money is performing. This MCP gives your AI client the specific math tools it needs to analyze investment returns accurately. Whether you are looking at a single asset or comparing two different portfolios, your agent can now handle the heavy lifting. 

You can use it to find the basic percentage change of an asset or calculate annualized returns to see how an investment performed on a yearly basis over time. If you have two different scenarios, your agent can run a comparison to see which one actually yielded a better result in percentage terms. It even provides a descriptive summary of the outcome, so you don't have to interpret the raw numbers yourself. It is a direct way to turn raw financial data into actionable performance insights through your preferred AI interface.

## Tools

### calculate_simple_return
This tool calculates the basic percentage return for a single investment asset.

### calculate_annualized_return
This tool converts a total return into an equivalent yearly return by accounting for the time elapsed.

### compare_investment_performance
This tool evaluates two different investment scenarios to see which one performed better in percentage terms.

### get_return_summary
This tool provides a descriptive classification of the investment outcome.

## Prompt Examples

**Prompt:** 
```
What was the percentage return on an investment that grew from $1,000 to $1,250?
```

**Response:** 
```
The return on your investment is 25%.
```

**Prompt:** 
```
Calculate the annualized return for $5,000 that became $7,500 over 5 years.
```

**Response:** 
```
The annualized return is 8.45% per year.
```

**Prompt:** 
```
Which performed better: $100 to $150 or $200 to $280?
```

**Response:** 
```
The first investment performed better with a 50% return compared to 40% for the second.
```

## Capabilities

### Simple Return Calculation
Your agent uses this to find the basic percentage change for any asset.

### Annualized Yield Analysis
Your agent uses this to normalize returns over specific time periods.

### Scenario Comparison
Your agent uses this to weigh two different investment paths against each other.

### Outcome Classification
Your agent uses this to provide a qualitative description of investment results.

## Use Cases

### Portfolio Benchmarking
Compare how your current holdings performed against a different set of assets.

### Long-term Growth Tracking
Calculate how much an investment grew on a yearly basis over several years.

### Quick Asset Checks
Get the immediate percentage return on a single asset after a price change.

### Investment Decision Support
Use the comparison tool to decide between two different financial paths.

## Benefits

- Removes the need for manual percentage math in your AI chat.
- Normalizes returns across different timeframes using annualized calculations.
- Provides direct comparisons between competing investment scenarios.
- Translates raw numbers into descriptive outcome summaries.

## How It Works

Connecting this MCP to your AI client gives your agent immediate access to financial math tools.

1. Connect the MCP to your client like Claude or Cursor via Vinkius.
2. Provide your investment data to your AI agent.
3. Ask the agent to perform a specific calculation or comparison.
4. The agent calls the relevant tool to process the math.
5. You receive the calculated return or summary directly in the chat.

## Frequently Asked Questions

**How do I use this MCP with Claude?**
You connect to the Vinkius hosted MCP once, and then your Claude client can call the financial tools directly during your conversations.

**Can I compare two different investments?**
Yes, you can use the compare_investment_performance tool to see which scenario had a better percentage return.

**Does this handle annualized returns?**
Yes, the calculate_annualized_return tool converts total returns into yearly geometric mean returns based on the time elapsed.

**What kind of math does the MCP do?**
It handles simple percentage returns, annualized returns, performance comparisons, and qualitative outcome summaries.

**Do I need to host the MCP myself?**
No, Vinkius hosts and manages the MCP for you, so it is ready to use as soon as you connect your client.

**How do I calculate the yearly return for a long-term investment?**
You can use the `calculate_annualized_return` tool. Provide the initial value, the final value, and the number of years that have elapsed to get the geometric mean return per year.

**Can I compare two different stocks using this tool?**
Yes. Use `compare_investment_performance` by providing the initial and final values for both investments to see which one had the higher percentage return.

**What happens if my investment lost money?**
The tools will correctly identify a negative return. For example, `get_return_summary` will return a status of 'Loss'.