# Export Parity Calculator MCP MCP

> Export Parity Calculator determines if your commodity—like grain—sells for more overseas or locally. This MCP calculates the net farm-gate price by factoring in freight costs, port fees, and export taxes against international prices. It then compares that final number to what you make selling at home, telling you exactly where to sell.

## Overview
- **Category:** finance
- **Price:** Free
- **Tags:** grain, export, parity, commodity, pricing

## Description

Figuring out commodity profitability isn't just about looking at the bulk FOB price. You need a full picture of the money leaving your farm. This MCP handles all the required steps: first, it gets the current transport rate per kilometer for different vehicles. Next, it takes that data and calculates the true net price you receive at the farm gate after subtracting taxes and port fees from the international sale price. Finally, it weighs this calculated parity against local market rates to give a clear recommendation. You'll find all of these tools managed easily within your Vinkius catalog, giving you actionable intelligence without manually juggling spreadsheets.

## Tools

### analyze_market_opportunity
Compares a calculated export price against current local market prices to recommend whether exporting or selling domestically is more profitable.

### calculate_farm_gate_parity
Computes the final net price received at the farm gate by subtracting all logistics and taxes from the international sale price.

### get_transportation_rate
Retrieves the specific cost per kilometer for a given mode of transportation, like truck or rail.

## Prompt Examples

**Prompt:** 
```
What is the transport rate for a truck?
```

**Response:** 
```
The `get_transportation_rate` tool returns the cost per km and currency for the selected mode.
```

**Prompt:** 
```
Calculate parity: FOB $500, Rate 5.2, Distance 500km, Mode truck, Port Fees 100, Taxes 50.
```

**Response:** 
```
Using `calculate_farm_gate_parity`, the tool will compute the net farm-gate price after all deductions.
```

**Prompt:** 
```
Should I export if my parity is 2500 and domestic price is 2400?
```

**Response:** 
```
The `analyze_market_opportunity` tool will recommend 'EXPORT' because the parity price is higher.
```

## Capabilities

### Calculate Net Farm-Gate Price
Determines the final dollar amount received at the farm gate after deducting all required logistics costs from an international sale price.

### Determine Transport Costs
Retrieves precise, up-to-date cost per kilometer for various modes of freight transport (e.g., truck or rail).

### Compare Market Viability
Compares the calculated export price against domestic market prices to advise whether exporting or selling locally is financially better.

## Use Cases

### Comparing a new export route
A farm manager needs to check if switching from rail transport to truck changes profitability. They first use get_transportation_rate for both modes, then run the data through calculate_farm_gate_parity to see which mode yields a higher net price.

### Making an urgent sales decision
A commodity buyer has an unexpected surplus of corn. They input the export parity and the current domestic market rate into analyze_market_opportunity. The agent immediately tells them if they should hold out or sell it right away.

### Calculating total fees for a specific port
A supply chain analyst needs to test how new, higher port fees affect the final payout. They adjust the input variables in calculate_farm_gate_parity and see exactly what the net farm-gate price drops by.

### Evaluating multiple commodities
A large buyer needs to compare wheat versus corn sales potential. They run both crops through the full process, starting with get_transportation_rate for each, then calculate parity, and finally use analyze_market_opportunity to determine which crop is best sold right now.

## Benefits

- Stop guessing where to sell. By running the calculated parity through analyze_market_opportunity, you get a clear recommendation—export or stay local.
- Get accurate logistics costs instantly. The get_transportation_rate tool pulls the current cost per kilometer for any transport mode you specify.
- Eliminate manual deductions. calculate_farm_gate_parity handles every tax and fee deduction from your FOB price, giving you a true net figure.
- Save time on route planning. Instead of tracking down multiple rate sheets, this MCP consolidates the cost analysis into one workflow.
- Compare apples to apples. You don't just get two numbers; you get an actionable comparison that tells you which market wins.

## How It Works

The bottom line is that this MCP takes complex commodity pricing data—rates, fees, and market averages—and gives you one single decision: where to sell your grain for maximum profit.

1. First, use the transport rate tool to find the cost per kilometer for your chosen shipping method.
2. Next, feed that rate along with the international FOB price and all associated fees into the parity calculation tool. This gives you the net farm-gate price.
3. Finally, compare this resulting parity number against local market prices using the analysis tool. You get a clear 'Export' or 'Local Sale' recommendation.

## Frequently Asked Questions

**How do I find the transport rate for a truck using get_transportation_rate?**
You specify the transportation mode and your distance. The tool returns the cost per kilometer and currency, giving you the precise input needed for all subsequent calculations.

**Does calculate_farm_gate_parity account for taxes?**
Yes, it is specifically designed to compute the net farm-gate price. It subtracts freight costs, port fees, and export taxes from your initial FOB international price.

**What does analyze_market_opportunity tell me?**
This tool gives you a direct recommendation—EXPORT or SELL LOCALLY—by comparing the parity-calculated price against real domestic market prices.

**Can I use this MCP if my commodity is not grain?**
The structure works for any commodity. As long as you can provide reliable international FOB pricing, local rates, and associated logistics costs, the tool will calculate parity.

**What specific data inputs does `calculate_farm_gate_parity` require?**
The tool needs four key metrics: the international FOB price, total freight costs, port fees, and export taxes. You must supply these values in a single request for an accurate net farm-gate calculation.

**If I call `get_transportation_rate` with an unsupported mode of transport, what happens?**
The function returns a specific error code detailing the invalid mode or type. This helps you immediately correct your input and select from available options like truck or rail.

**Are there performance limitations when running `analyze_market_opportunity` on many scenarios?**
Vinkius handles general usage limits, but for batch analysis, it's best practice to group similar market comparisons. This keeps your agent running efficiently and avoids unnecessary throttling.

**Does `get_transportation_rate` accept distances measured in units other than kilometers?**
No, the tool is configured specifically for distance measurements in kilometers (KM). Always ensure the distance you provide matches the KM unit when calling this function.