English Français العربية

Arzbin MCP Server

Official registry Finance and payments

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http arzbin-mcp-server 'https://hub.arzbin.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "arzbin-mcp-server": {
            "type": "http",
            "url": "https://hub.arzbin.com/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Arzbin MCP Server
  2. Install
  3. Tools
  4. Example prompts
  5. Citation
  6. Rate limits
  7. Registry publishing
  8. Disclaimer

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:

https://hub.arzbin.com/mcp

Claude Desktop and Cursor style config:

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

VS Code / Cline style config:

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

Codex style config for remote-capable MCP environments:

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

Gemini CLI:

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

Tools

ToolInputsUse
get_latest_fiat_ratescodes?: string[]Latest fiat rates including USD, EUR, GBP, AED, TRY, and Toman exchange rates.
get_latest_gold_ratestypes?: string[]Latest gold and coin prices for Iran market context.
get_latest_crypto_ratessymbols?: string[]Curated crypto prices including USDT Toman, BTC, and ETH.
get_market_historyassetType, code, daysOHLC history for fiat, gold, and crypto assets.
get_fiat_rate_sourcescodeSource comparison context for fiat rates where available.
convert_to_tomanassetType, code, amountEstimate 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:

com.arzbin/market-data

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

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

Registry API verification:

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.

Frequently asked questions

What is Arzbin MCP Server?

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

How do I install Arzbin MCP Server?

It runs as a remote server. In Claude Code: claude mcp add --transport http arzbin-mcp-server 'https://hub.arzbin.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Arzbin MCP Server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Arzbin MCP Server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Arzbin MCP Server?

It is published by arzbin-com. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.