# Farming Efficiency Calculator MCP

> The Farming Efficiency Calculator helps gamers calculate precise metrics like Gold Per Hour (GPH) and item drop rates for any in-game activity. It analyzes different resource paths to show you which farming route makes the most money per hour or takes the least amount of time to gather specific materials.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** farming, gph, optimization, loot, efficiency

## Description

When you're grinding loot, you don't just want a good run; you want the *best* run. This MCP lets you stop guessing and start calculating your true profitability. You feed it details about item drop rates, market values, and how long different activities take. It spits out hard numbers—like exactly how much gold you can expect per hour or how many rare swords you'll get from a 30-minute session. Instead of wasting time on routes that look cool but are actually dead ends, your agent handles the math for you. You connect through Vinkius and immediately gain access to this specialized toolset, letting you plan your character builds around solid numbers, not gut feelings.

## Tools

### analyze_route_metrics
Determines the basic economic performance and metrics for a single, specific farming route.

### evaluate_opportunity_cost
Calculates how much potential profit you lose by choosing a less efficient or sub-optimal path.

### predict_farm_duration
Estimates the total time required to farm and collect a fixed amount of an item.

### compare_farming_routes
Ranks several different farming paths against each other, highlighting which one is objectively superior.

## Prompt Examples

**Prompt:** 
```
Calculate the efficiency of a 10-minute route where a Gold Coin (5% drop, 1 unit, 100 gold) and a Rare Sword (1% drop, 1 unit, 5000 gold) can drop.
```

**Response:** 
```
The expected Gold Per Hour for this route is 360.00 GPH. You can expect 10 Gold Coins and 0.6 Rare Swords per hour.
```

**Prompt:** 
```
Which route is better: Route A (20 mins, 500 GPH) or Route B (15 mins, 450 GPH)?
```

**Response:** 
```
Route A is the more efficient path with a higher Gold Per Hour.
```

**Prompt:** 
```
How long will it take to farm 100 Dragon Scales if the drop rate is 2% per 30-minute run?
```

**Response:** 
```
It will take approximately 83.33 hours to collect 100 Dragon Scales on this route.
```

## Capabilities

### Determine route profitability
Calculates the basic economic performance of a single farming path using current drop rates and market values.

### Compare multiple paths
Ranks several different farming routes against each other to identify the most profitable option.

### Estimate time investment
Predicts how long it will take you to collect a specific amount of an item, given its drop rate.

### Identify lost profit
Calculates the potential money loss when you choose a path that isn't the most efficient.

## Use Cases

### The guild needs bulk components fast.
A player needs 500 'Dragon Scales' for a critical upgrade. They ask their agent to use `predict_farm_duration` with the known drop rate, getting an exact time estimate of 83 hours. This lets them schedule the collection without wasting days.

### Deciding between two zones.
Two paths exist: Zone A (20 mins/500 GPH) vs. Zone B (15 mins/450 GPH). The player asks the agent to use `compare_farming_routes`, which immediately flags Zone A as the superior, more efficient choice.

### Checking out a risky shortcut.
A veteran player considers using an obscure shortcut. They ask the MCP to run `evaluate_opportunity_cost` against their main farming zone, and the results show they'd lose 30% of potential profit—they stick to the reliable path.

### Initial assessment of a new area.
A player enters a brand-new area. They use `analyze_route_metrics` on a small sample run, getting a baseline GPH figure that tells them if the zone is even worth their time.

## Benefits

- Stop guessing. Instead of just knowing a route looks good, `analyze_route_metrics` gives you concrete data on its true profitability, like Gold Per Hour (GPH).
- Eliminate wasted trips. If you're unsure which path to take, let `compare_farming_routes` rank your options and tell you which one is the clear winner.
- Never underestimate a task again. Use `predict_farm_duration` to see exactly how long it will take to stack up 100 rare materials without running into time sinks.
- Know when to pivot. The tool can run through your options and use `evaluate_opportunity_cost` to show you the actual money you're losing by sticking with a poor choice.
- Better resource allocation means less grind. By using these metrics, you focus only on paths that guarantee a return for your time investment.

## How It Works

The bottom line is: it gives you hard numbers so you know exactly where to spend your time and effort in the game.

1. Input the parameters for your farming run, including drop rates, unit values, and total time.
2. The MCP processes this data to model profitability against defined goals (e.g., maximizing GPH or minimizing duration).
3. You receive clear metrics, showing either the absolute profit earned from a single path or how that path compares to alternatives.

## Frequently Asked Questions

**How do I use the analyze_route_metrics tool?**
You provide the agent with all the details of a single run: its length, and the drop rates/values for items. It then returns the fundamental economic performance metrics for that specific path.

**What's the difference between compare_farming_routes and analyze_route_metrics?**
Think of it this way: `analyze_route_metrics` looks at one route in isolation. You use `compare_farming_routes` when you want the system to rank two or more routes against each other to find the best option.

**Can I predict my duration using predict_farm_duration?**
Yes, this tool takes a target item count and the drop rate. It calculates an estimate of total time required, letting you know if your goal is achievable in a reasonable timeframe.

**Is evaluate_opportunity_cost useful for planning?**
Absolutely. If you're considering a risky or low-yield area, `evaluate_opportunity_cost` shows you the actual profit potential that you give up by going there instead of your main farming zone.

**When using `analyze_route_metrics`, what specific data points do I need to input for an accurate GPH calculation?**
You must provide three core variables: the total time spent on the route, all item drop rates, and their corresponding market values. The function calculates Gold Per Hour based on a weighted average of these inputs.

**If I compare farming routes using `compare_farming_routes`, does it account for differing travel times between areas?**
Yes, the tool factors in total time commitment for every route analyzed. It doesn't just look at gross profit; it gives a true efficiency ranking considering both earnings and necessary travel.

**What are the practical limitations when running `predict_farm_duration` for extremely large item goals?**
While you can input massive target amounts, results rely on consistent drop rate data. The tool provides estimates using decimal points to keep time predictions as precise as possible.

**How does `evaluate_opportunity_cost` determine what a 'sub-optimal' farming path is?**
It works by comparing the potential profit of your chosen route against the maximum theoretical profit achievable with that same time investment. This shows you exactly what you could have earned instead.