# NetArz FX Rates

> NetArz FX Rates is a freemium MCP server for finance and payments. Iranian rial and toman exchange rates, conversion, history and gold prices for assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $5 a month
- **Platforms:** API
- **Website:** https://netarz.ir/docs/fx/mcp
- **MCP Registry name:** ir.netarz/fx-rates
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://netarz.ir/api/fx/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "fx-rates": {
      "url": "https://netarz.ir/api/fx/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/netarz-fx-rates
