# ExchangeRate-API MCP > ExchangeRate-API MCP gives your AI agent instant access to global currency data. Need to convert amounts between any two currencies, check real-time exchange rates, or audit historical financial trends? This tool provides reliable conversion and market intelligence for over 160 world currencies through natural conversation. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** currency-conversion, historical-rates, forex, financial-api, global-markets ## Description Your agent needs accurate, up-to-the-minute financial data. With this MCP, you get instant access to current and historical exchange rates across more than 160 global currencies. You can ask your AI client anything about currency pairs—from calculating how many Brazilian Reais you'll get for 100 USD right now, to figuring out what that rate was on a specific date last year. It handles everything automatically. Whether you're managing international e-commerce or running financial reports, this MCP acts like a dedicated global analyst built directly into your workflow. If you use Vinkius, you connect once and gain access to this powerful currency intelligence alongside thousands of other specialized tools. ## Tools ### get_enriched_currency_data Retrieves detailed information and metadata about a specified currency, including its full name and flag. ### get_historical_rates Fetches the exchange rate for a specific currency pair on any past date you provide. ### get_latest_rates Retrieves the most current, live exchange rates using a specified base currency. ### convert_currency_pair Performs an immediate conversion calculation between two chosen currencies for a specific amount. ### list_supported_currencies Provides a complete list of all currency codes and identifiers the system supports. ## Prompt Examples **Prompt:** ``` Convert 100 USD to Brazilian Real. ``` **Response:** ``` Retrieving the latest rate for USD/BRL... 100 USD is currently equivalent to approximately 500 BRL. Would you like me to check the historical rate for this pair? ``` **Prompt:** ``` Show the current exchange rates for EUR. ``` **Response:** ``` Fetching latest rates with EUR as the base currency... I've identified the exchange values for 160+ currencies, including USD (1.08), GBP (0.85), and JPY (162.50). Shall I list more? ``` **Prompt:** ``` What was the exchange rate for USD to EUR on January 1st, 2020? ``` **Response:** ``` Retrieving historical data for 2020-01-01... On that day, 1 USD was worth approximately 0.89 EUR. I can pull the full data table for that specific date if you need. ``` ## Capabilities ### Convert specific amounts It calculates the exact exchange rate or converts a given sum between any two selected currencies. ### Get live market rates It fetches the latest, real-time exchange rates using any chosen currency as the base. ### Audit past financial data You can retrieve the specific exchange rate for a given pair on any date in history. ### List all supported currencies It provides a complete list of every currency code and available metadata, like full names and flags. ## Use Cases ### Checking tax compliance for international sales An accountant needs to know the exact rate of USD to CAD on October 15th, 2023, because that's when a transaction closed. They ask their agent, and it uses `get_historical_rates` to pull the precise figure needed for quarterly tax filing. ### Optimizing global e-commerce pricing An e-commerce manager needs to adjust prices across five countries instantly. They ask the agent to fetch live rates using `get_latest_rates` and calculate new totals for all markets, preventing lost revenue from outdated exchange values. ### Validating a list of currencies A developer is building a payment gateway and needs to ensure they support every regional currency. They use `list_supported_currencies` to get the full master list, validating their code against the official data set. ### Quickly calculating conversion for travel budgets A user planning a trip asks, 'How much is $1000 USD in Japanese Yen right now?' The agent uses `convert_currency_pair` and immediately reports the current figure, allowing instant budget adjustments. ## Benefits - Automate rate lookups. Instead of searching multiple financial websites, your agent handles all live data requests using `get_latest_rates`, giving you one source of truth. - Perform deep dives into market trends. The MCP lets you audit currency pairs by fetching historical rates with `get_historical_rates` for compliance or trend analysis. - Simplify global pricing. You can instantly calculate precise conversions using the `convert_currency_pair` tool, ensuring your product costs are accurate in every market. - Understand the full scope of data available. Use `list_supported_currencies` to confirm if a niche currency is supported before writing complex financial code. - Enrich your knowledge base. Beyond just rates, you can get detailed country info and flags using `get_enriched_currency_data`, which helps validate input data. ## How It Works The bottom line is you ask a question in plain language, and the tool handles the complex financial calculations behind the scenes. 1. Subscribe to the ExchangeRate-API MCP and provide your unique API key. 2. Instruct your AI client to perform a financial task (e.g., 'What was USD to EUR on 2020-01-01?'). 3. The MCP executes the request, retrieves the accurate exchange rate data, and returns the answer directly through your chat or code environment. ## Frequently Asked Questions **How does ExchangeRate-API MCP handle rates for currencies I don't know?** You should start by running `list_supported_currencies`. This tool gives you the full list of supported codes, so you always use the right input. **Can ExchangeRate-API MCP calculate conversions for old dates?** Yes. Use the `get_historical_rates` function and provide a specific date; it retrieves rates even if they are months or years in the past. **Is the data from ExchangeRate-API MCP real-time enough for e-commerce?** The `get_latest_rates` tool provides current, live exchange rates, which is generally sufficient for optimizing global pricing strategies in real time. **What if I need more information about a currency besides just the rate?** You can use the `get_enriched_currency_data` tool. It pulls rich metadata, including full names and flags for any supported currency code. **Does ExchangeRate-API MCP support all 160+ currencies?** The API supports over 160 currencies, but always confirm the specific codes you need by calling `list_supported_currencies` to guarantee coverage.