paolo-dat/tax-mcp-server

MCP Server

A Spring Boot application that exposes two tools for working with USD exchange rates and calculating taxes in Georgian Lari (GEL). It retrieves official exchange rates from the National Bank of Georgia (NBG) and helps compute tax liabilities based on user inputs.

Features

• Fetch USD Exchange Rate: Retrieves the official USD to GEL rate for a given date from the National Bank of Georgia.
• Calculate Tax Value: Calculates the tax in GEL based on an income amount in USD, the exchange rate, and a tax percentage.

Exposed Tools

1️⃣ Fetch USD Exchange Rate

Description:
Fetches the official USD exchange rate from the National Bank of Georgia for a specific date.

Method Signature:

public double fetchUsdRate(String date)

Parameters:

• date (String, required) – The target date in yyyy-MM-dd format.

Example Usage:

GET https://nbg.gov.ge/gw/api/ct/monetarypolicy/currencies/?currencies=USD&date=2024-01-01

Response: Returns the official USD to GEL exchange rate rounded to 4 decimal places.

2️⃣ Calculate Tax Value

Description:
Calculates the tax amount in GEL using:

• An income amount in USD
• The currency exchange rate for the specified date
• A tax rate percentage

Method Signature:

public double calculateTaxValue(double incomeAmount, double currencyExchangeRate, double taxRatePercentage)

Parameters:

• incomeAmount (double, required) – The income amount in USD to be converted and taxed.
• currencyExchangeRate (double, required) – The USD to GEL exchange rate.
• taxRatePercentage (double, required) – The tax rate as a percentage.

Formula:

taxValue = (incomeAmount * currencyExchangeRate * taxRatePercentage) / 100

Response: Returns the calculated tax amount in GEL, rounded to 4 decimal places.

Example Flow

1. Fetch the exchange rate:

   • Call fetchUsdRate("2024-01-01") → e.g., 2.6789 GEL/USD

2. Calculate tax:

   • Call calculateTaxValue(1000, 2.6789, 20) → 535.7800 GEL