Zenrus

Provides up-to-date currency rates and Brent crude oil prices, plus calculations to estimate barrels purchasable from fixed amounts.

typescript

0

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "darkgenius-zenrus-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zenrus-mcp"
      ]
    }
  }
}

You can run Zenrus MCP Server to fetch real-time currency rates and Brent crude oil prices, and perform calculations to determine how many barrels you can buy with a given amount. This MCP server exposes practical tools for finance-related decisions and lets you easily integrate data into your own apps or workflows.

How to use

You interact with the Zenrus MCP Server by invoking its tools through your MCP client. Use the basic data tools to obtain current exchange rates and commodity prices, and then use the calculation tools to determine how many barrels of Brent crude you could buy for a given amount in USD, EUR, or RUB. All tools return structured JSON data that you can format and consume in your application or further processing.

How to install

Prerequisites you need before installing: a recent Node.js and npm installation on your system.

Option A: Use npx to run the MCP server on demand without a local install.

npx -y zenrus-mcp

Option B: Install for development or offline usage. Clone the project, install dependencies, and build before running.

git clone https://github.com/DarkGenius/zenrus-mcp.git
cd zenrus-mcp
npm install
npm run build

If you prefer to run the server directly from npm scripts during development, you can start it with the standard start command after a local build.

Available tools

get_usd_rate

Fetches the current USD/RUB exchange rate and returns structured data with rate, currency, and description.

get_eur_rate

Fetches the current EUR/RUB exchange rate and returns structured data with rate, currency, and description.

get_brent_usd_rate

Fetches the Brent crude oil price in USD and returns structured data with price, commodity, currency, and unit.

get_brent_rub_rate

Fetches the Brent crude oil price in RUB and returns structured data with price, commodity, currency, and unit.

calculate_barrels_for_rub

Calculates how many Brent crude oil barrels you can buy for a given RUB amount, returning amount, currency, barrels, pricePerBarrel, and commodity.

calculate_barrels_for_usd

Calculates how many Brent crude oil barrels you can buy for a given USD amount, returning amount, currency, barrels, pricePerBarrel, and commodity.

calculate_barrels_for_eur

Calculates how many Brent crude oil barrels you can buy for a given EUR amount, returning amount, currency, barrels, pricePerBarrel, and commodity.