# ExchangeRate- MCP > ExchangeRate- provides real-time and historical currency exchange rates for over 160 currencies. Use this MCP to convert specific amounts between any two global currencies or retrieve market data from a past date, all through natural language conversation with your AI client. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** currency-exchange, forex, exchange-rates, financial-data, currency-conversion ## Description Need to run financial models that cross borders? This connector lets you handle every aspect of currency conversion without leaving the chat window. You can ask for the current exchange rate against any base currency, or calculate exactly how much 500 Euros is worth in Japanese Yen right now. It's also perfect for auditing; just tell your agent which date you need rates from and it pulls the historical data. Beyond simple math, you can get localization details, like country names and flag URLs, giving your analysis rich context. When you connect this MCP via Vinkius, your AI client treats these financial calculations just like pulling data from a database—you simply ask for what you need, and it delivers accurate, actionable numbers. ## Tools ### get_supported_codes Lists every single currency code and name that this MCP recognizes. ### get_enriched_data Retrieves detailed exchange rate information, including country names and flag URLs. ### get_historical_data Fetches the precise exchange rates for a specific date in the past. ### get_latest_rates Gets the most up-to-date exchange rates from a specified base currency. ### get_pair_conversion Calculates and returns the exact rate between two specific currencies for an amount. ### get_quota Checks how many API requests are left for the current billing period. ## Prompt Examples **Prompt:** ``` What are the current exchange rates for USD? ``` **Response:** ``` I've fetched the latest rates for USD. Currently, 1 USD is equivalent to 0.92 EUR, 0.79 GBP, and 148.50 JPY. Would you like to see more currencies? ``` **Prompt:** ``` Convert 500 EUR to GBP. ``` **Response:** ``` Using the `get_pair_conversion` tool, 500 EUR converts to approximately 428.50 GBP based on the current mid-market rate. ``` **Prompt:** ``` What was the exchange rate for USD to EUR on January 1st, 2020? ``` **Response:** ``` I've retrieved the historical data for 2020-01-01. On that date, the exchange rate from USD to EUR was 0.891. Would you like to check another date? ``` ## Capabilities ### Calculate currency conversions Instantly converts specific amounts between any two supported currencies. ### Get current market rates Retrieves the latest exchange rate for a chosen base currency against all others. ### Retrieve historical rates Fetches precise exchange rates for any date in the past, useful for trend analysis or auditing. ### Check API usage limits Confirms your remaining quota to prevent service interruptions during large data pulls. ### Identify supported currencies Provides a complete list of all currency codes and names the system recognizes. ## Use Cases ### Pricing goods for an international market An e-commerce manager needs to list a product in both GBP and CAD. They use the agent to run `get_pair_conversion` multiple times, getting accurate rates instantly so they can update pricing across 10 different storefronts without manual spreadsheet work. ### Comparing market stability over time A financial analyst wants to know how the USD/JPY rate changed on a specific date two years ago. They ask their agent, which uses `get_historical_data` to pull the exact figure, letting them build accurate trend reports. ### Validating data sources for a project A developer building an app needs to know all valid currency codes. They use `get_supported_codes`, which provides the full list of 160+ options, preventing them from making assumptions about missing or invalid country identifiers. ### Building a data-rich report A global business owner needs to know not just the rate, but also the official flag and country name for their final presentation. They use `get_enriched_data` to pull that localization context alongside the conversion figures. ## Benefits - Instead of leaving the chat to check rates, use `get_latest_rates` to get current market data immediately. This keeps your workflow contained and fast. - For auditing or reporting, you can't rely on memory. Use `get_historical_data` to pull precise exchange rates from any past date into your report. - Need to know what codes are available? Simply call `get_supported_codes`. This confirms all 160+ currencies the system handles before you start converting anything. - When you need a simple conversion, use `get_pair_conversion` for fast, direct math between two specific currencies. It’s the quickest way to get an amount converted. - Don't hit a wall midway through analysis. Use `get_quota` anytime to check your remaining API requests and stay within limits. ## How It Works The bottom line is: you talk to your AI agent using natural language, and it handles all the complex API calls behind the scenes. 1. First, subscribe to this MCP on Vinkius and enter your API key. 2. Next, ask your AI agent for what you need—for example, 'What was the rate between USD and EUR last year?' 3. The MCP runs the query, accesses the financial data, and returns a direct answer in your chat client. ## Frequently Asked Questions **How do I use get_pair_conversion to convert money?** Simply ask your agent to 'Convert 100 CAD to AUD.' The agent uses `get_pair_conversion` to calculate the exact exchange rate and amount for you. **Can I use get_historical_data with any date?** Yes, `get_historical_data` lets you check rates for specific dates in the past. You just need to provide a valid YYYY-MM-DD format when asking your agent. **What is get_enriched_data good for?** `get_enriched_data` pulls more than just numbers; it adds context, like the country name and flag URL, making your final report look professional and complete. **How do I check if this MCP is running out of requests?** You run `get_quota`. This tool tells you exactly how many API calls you have left for the current period. It’s good practice to check this before a big data pull. **What is the first thing I should run if I don't know which currency codes are valid for my project using get_supported_codes?** You must use `get_supported_codes` first. This tool returns a complete list of all 160+ supported codes, letting you confirm your inputs before writing any conversion logic. **If I run get_latest_rates and the API call fails, what does that usually indicate about my connection?** Failure to connect often means your API key is missing or expired. You need to verify that the key you entered into Vinkius matches an active account with current permissions. **Do I have to upgrade my plan just to use get_enriched_data?** Yes. The localization data, like country flags and full names, requires a Business or Volume API plan. You must update your subscription tier to successfully execute this specific tool. **For simple conversions, should I use get_pair_conversion or just check the latest rates?** If you only need one rate between two specific currencies, `get_pair_conversion` is faster and more direct. If you want to see a base currency compared against *all* 160+ supported currencies, use `get_latest_rates`. **Can I convert a specific amount between two currencies?** Yes! Use the `get_pair_conversion` tool by providing the base currency, target currency, and the amount you wish to convert. **How do I see all available currency codes?** Simply use the `get_supported_codes` tool. It will return a complete list of all 160+ currency codes and their full names supported by the API. **Is it possible to check my remaining API usage?** Yes, the `get_quota` tool allows you to check your remaining request quota for the current billing period at any time.