Skip to content
MCP server

NetArz FX Rates

Iranian rial and toman exchange rates, conversion, history and gold prices for assistants

Install
Pricing
Freemium
Platforms
API
Runs
Remotely
Version
1.0.0
Listing updated
2 days ago

About NetArz FX Rates

NetArz FX Rates is a freemium MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

The server answers questions such as how many toman 500 dollars is right now, using the Tehran open-market rate instead of a figure from the model's memory. It covers about 30 currencies, and each answer is JSON with a link to that currency's page and the time of the data. Six tools are all read-only.

Without a key the rates are delayed 15 minutes, history covers the past year and the limit is 300 requests per minute per IP. A Pro key, sold per app, removes the delay, opens the whole daily archive (the dollar from 1360 in the Persian calendar) and adds Pro-only currencies such as the Uzbek som and Tajik somoni. Pro is $5 per app each month, charged in toman at the day's rate. A wrong key returns an error instead of falling back silently.

Gold values are computed from the world ounce price and the dollar rate, so they are not Tehran market prices and exclude craftsmanship fees and coin premium. NetArz says the rates are references, not trade offers, and that it does not buy or sell currency. The docs are in Persian.

Install

Run in a terminal

claude mcp add --transport http fx-rates https://netarz.ir/api/fx/mcp

Add to Settings → Connectors → Add custom connector

https://netarz.ir/api/fx/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "fx-rates": {
      "url": "https://netarz.ir/api/fx/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "fx-rates": {
      "type": "http",
      "url": "https://netarz.ir/api/fx/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "fx-rates": {
      "serverUrl": "https://netarz.ir/api/fx/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "fx-rates": {
      "type": "http",
      "url": "https://netarz.ir/api/fx/mcp"
    }
  }
}

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

list_currencies
List board currencies, quote units and each currency's page
get_rate
Buy, sell and average rate for one currency in toman
get_rates_table
Table of all or chosen currencies
convert
Convert an amount between two currencies
get_history
Daily closing rates with Persian and Gregorian dates
get_gold_prices
Gold and silver ounce prices and computed 18-carat gold and coin value

What it does

Live rate lookup
Buy, sell and average rate for a currency in toman, with change since yesterday.
Currency conversion
Convert between any two currencies, toman or rial, at average, buy or sell rate.
Rates table
Table of all or chosen currencies with ready-made Markdown.
Daily history
Closing rates with Persian and Gregorian dates; full archive on Pro.
Gold computation
Ounce prices and computed value of 18-carat gold and coins in toman.
Free tier
No key needed to start, with a 15-minute delay.

Good for

  • Convert a dollar amount to toman in a chat
  • Check yesterday's change for a currency
  • Pull a year of daily dollar closing rates
  • Build a rates table for a report
  • Estimate the computed value of gold in toman

Pricing

Freemium, from $5 a month

Free with 15-minute delay; Pro $5/month per app

Prices change. Check netarz.ir before you buy.

NetArz FX Rates FAQ

Do I need a key?

No. The free tier needs none; a Pro key gives real-time rates and the full archive.

How delayed are free rates?

Fifteen minutes, with the delay stated in the response metadata.

How much is Pro?

$5 per app per month, converted to toman at purchase.

Are gold figures market prices?

No. They are computed from the world ounce and the dollar rate.

Is NetArz FX Rates free?

NetArz FX Rates has a free plan, with paid plans for more usage or features. Paid plans start at $5 a month.

How do I add NetArz FX Rates to Claude Code?

Run this command in your terminal: claude mcp add --transport http fx-rates https://netarz.ir/api/fx/mcp

What are the best alternatives to NetArz FX Rates?

The closest alternatives to NetArz FX Rates are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to NetArz FX Rates

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government