NetArz FX Rates

ir.netarzPublished by netarz.irOfficial publisherv1.0.0Updated Oct 27, 2026

Iranian rial/toman exchange rates (~30 currencies), conversion, history and gold. Free tier, no key.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Read-only MCP server for Iran's Tehran free-market exchange rates, currency conversion, rate history and gold prices, with a free no-key tier.

What you can do
  • List the currencies on the NetArz board with ISO codes, names, quote units and page links
  • Get today's buy, sell and mid rate in Toman for one currency, with change versus yesterday and data time
  • Fetch the whole board or selected codes as structured rows plus a ready-to-show markdown table
  • Convert amounts between any two currencies, Toman or Rial, at mid, buy or sell rates
  • Retrieve daily closing-rate history with Gregorian and Jalali dates, and global gold and silver ounce prices with computed Toman gold figures
When to use it
Useful when an assistant needs Iranian rial/toman rates, currency conversion or gold figures for reports, pricing or analysis, and when Jalali-dated rate history is needed. The free tier is enough for occasional lookups; a Pro key is for live rates and the full archive.
Requirements
A remote streamable HTTP endpoint at netarz.ir; no installation, account or key is needed for the free tier. An optional NetArz FX API Pro key, sent as an Authorization Bearer header, unlocks live rates, the full daily archive and Pro-only currencies. Network access is required.
Before you install
Rates are indicative quotes around the market mid; NetArz does not trade these currencies. Without a key, rates are 15 minutes delayed and history is limited to the last 365 days. Toman gold values are computed from the global ounce and the dollar, not the Tehran market price, so they exclude premium and making charges. Some currencies are quoted per 10 or 100 units, so amounts must be handled per unit. All tools are read-only.

Installation

In SourceWeft

  1. Open NetArz FX Rates in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ir.netarz%2Ffx-rates/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

Tools

6

list_currencies

List currencies (فهرست ارزها)

Every currency on the NetArz Tehran free-market board: ISO code, Persian and English name, quote unit (some are quoted per 10 or 100 units) and its netarz.ir page. Pro-only currencies are listed with pro_only=true. فهرست ارزهای تابلوی نرخ نِت اَرز با واحد مظنه و نشانی صفحهٔ هر ارز.

Takes no parameters.

get_rate

Rate of one currency (نرخ یک ارز)

Today's Tehran free-market rate of one currency in Toman (IRT): buy, sell and mid per quote unit, change against yesterday, and the time of the data. نرخ امروز یک ارز در بازار آزاد تهران به تومان: خرید، فروش، میانگین و تغییر نسبت به دیروز.

Parameterscoderequired

get_rates_table

Rates table (جدول نرخ ارزها)

The whole board, or the codes you list, as structured rows plus a ready-to-show markdown table (buy / sell / mid in Toman, change vs yesterday). جدول نرخ همهٔ ارزها یا ارزهای انتخابی، با جدول markdown آماده.

Parameterscodes

convert

Convert an amount (تبدیل ارز)

Convert an amount between any two currencies, Toman (IRT) or Rial (IRR; 1 Toman = 10 Rial), through the board's dollar rate. side=mid (default), buy or sell. تبدیل مبلغ بین دو ارز، تومان یا ریال با نرخ تابلو.

Parameterstorequiredfromrequiredsideamountrequired

get_history

Daily rate history (تاریخچهٔ روزانهٔ نرخ)

Daily Tehran open-market closing rate of a currency in Toman, with Gregorian and Jalali (Persian calendar) dates. Give `days` (back from today) or `from`/`to` (YYYY-MM-DD, Gregorian or Jalali such as 1404-01-01). Without a key: the last 365 days; a Pro FX API key reaches the whole archive (the dollar back to 1360 / 1981). At most 400 points per call; longer windows are sampled. نرخ پایانی روزانهٔ بازار آزاد با تاریخ شمسی و میلادی.

Parameterstocoderequireddaysfrom

get_gold_prices

Gold and silver (طلا و نقره)

Global gold and silver ounce in USD, and Toman values of 18k gold per gram, mesghal and coins as NetArz publishes them. The Toman gold figures are COMPUTED from the ounce and the dollar — not the Tehran market price (no premium or making charge); say so when you quote them. انس طلا و نقره و ارزش محاسبه‌ای طلا به تومان (قیمت بازار تهران نیست).

Takes no parameters.

Version history

1
  1. v1.0.0LatestOct 25, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.