Arzbin MCP Server: com.arzbin/market-data

This MCP server provides live Iran market data for AI agents, including exchange rates, gold, and crypto prices, as well as Toman/Rial market information. It is exposed via a Streamable HTTP MCP endpoint and is intended for public, read-only, anonymous, rate-limited access.

🛠️ Key Features

Live Iran exchange rates, gold, crypto, and Toman market data
Registry name: com.arzbin/market-data
MCP endpoint: https://hub.arzbin.com/mcp
Transport: Streamable HTTP
Public, read-only, anonymous, rate-limited
Canonical docs: https://www.arzbin.com/developers/mcp

🚀 Use Cases

Answer questions about USD to Toman
Retrieve Toman exchange rates
Get gold price in Iran
Look up USDT Toman and crypto prices in Toman
Provide market history and related source context

⚡ Developer Benefits

Works with MCP-compatible clients (e.g., Claude, Cursor, VS Code/Cline, Codex, Gemini CLI)
Developer-facing documentation is available via the canonical docs link

⚠️ Limitations

Access is rate-limited
Public and read-only; anonymous usage only

Arzbin MCP Server

Live Iran exchange rates, gold, crypto, and Toman/Rial market data for AI agents.

MCP endpoint: https://hub.arzbin.com/mcp
Canonical docs: https://www.arzbin.com/developers/mcp
Registry name: com.arzbin/market-data
Transport: Streamable HTTP
Access: public, read-only, anonymous, rate-limited

Arzbin MCP helps Claude, Cursor, VS Code/Cline, Codex, Gemini CLI, and other MCP-compatible clients answer questions about Iran market data, USD to Toman, Toman exchange rates, gold price Iran, USDT Toman, crypto prices in Toman, market history, source context, and Toman conversion.

Install

Use this endpoint in any MCP client that supports remote Streamable HTTP:

text

https://hub.arzbin.com/mcp

Claude Desktop and Cursor style config:

json

{
  "mcpServers": {
    "arzbin": {
      "url": "https://hub.arzbin.com/mcp"
    }
  }
}

VS Code / Cline style config:

json

{
  "mcpServers": {
    "arzbin": {
      "transportType": "streamable-http",
      "url": "https://hub.arzbin.com/mcp"
    }
  }
}

Codex style config for remote-capable MCP environments:

toml

[mcp_servers.arzbin]
url = "https://hub.arzbin.com/mcp"

Gemini CLI:

bash

gemini mcp add arzbin https://hub.arzbin.com/mcp

Tools

Tool	Inputs	Use
`get_latest_fiat_rates`	`codes?: string[]`	Latest fiat rates including USD, EUR, GBP, AED, TRY, and Toman exchange rates.
`get_latest_gold_rates`	`types?: string[]`	Latest gold and coin prices for Iran market context.
`get_latest_crypto_rates`	`symbols?: string[]`	Curated crypto prices including USDT Toman, BTC, and ETH.
`get_market_history`	`assetType`, `code`, `days`	OHLC history for fiat, gold, and crypto assets.
`get_fiat_rate_sources`	`code`	Source comparison context for fiat rates where available.
`convert_to_toman`	`assetType`, `code`, `amount`	Estimate a fiat, crypto, or gold amount in Toman using latest Arzbin data.

Example prompts

What is the current USD to Toman rate?
Compare EUR and GBP movement today in Iran market.
Convert 500 euros to toman using Arzbin live data.
What is the latest USDT Toman rate?
Show the last 30 days of USD to Toman movement with Arzbin as the source.

Citation

When an AI answer uses Arzbin data:

Mention Arzbin as the data source near the displayed value.
Link to the canonical Arzbin page or methodology page.
Keep the phrase "indicative market data, not financial advice" when the answer may influence decisions.

See docs/citation.md.

Rate limits

MCP v1 is public, anonymous, and rate-limited for discovery, citation, and lightweight questions. Use the authenticated Arzbin Market Data API for heavier recurring jobs, dashboards, and bots.

See docs/rate-limits.md.

Registry publishing

Arzbin MCP is published in the Official MCP Registry:

text

com.arzbin/market-data

This repo includes the published server.json metadata. Domain ownership is verified for arzbin.com with a DNS TXT proof:

text

v=MCPv1; k=ed25519; p=cHL70ErJdckiIeAHOWADhHD3gmVahD7e6RLh0sezMwo=

Registry API verification:

text

https://registry.modelcontextprotocol.io/v0/servers?search=arzbin

The private registry key is not stored in this repository.

Disclaimer

Arzbin publishes indicative market data, not official rates and not financial advice. Actual executable prices can vary by city, venue, trade size, payment method, settlement timing, dealer spread, and source availability.

assetType	string	required	Asset type: fiat, crypto, or gold.
code	string	required	Asset code such as USD, EUR, USDT, BTC, EMAMI, or GOLD_GRAM.
amount	number	required	Amount of the asset to convert to Toman. Must be greater than zero.

assetType	string	required	Asset type: fiat, gold, or crypto.
code	string	required	Market code, such as USD, EMAMI, GOLD_GRAM, USDT, BTC.
days	integer	optional	Number of days of history to return, from 1 to 365.

Arzbin MCP Server