Public read-only MCP v1

Arzbin MCP Server

Live Iran exchange rates, gold price Iran, crypto prices, USD to Toman, USDT Toman, Toman exchange rates, source context, history, and conversion tools for AI agents.

Connect MCP GitHub docs

Protocol card

Registry name: com.arzbin/market-data
Endpoint: https://hub.arzbin.com/mcp
Transport: streamable-http
Mode: public, read-only, rate-limited

Endpoint

https://hub.arzbin.com/mcp

Registry

Published and active

Tools

6 read-only tools

Auth

No login required for MCP

Official MCP Registry

Arzbin is published in the Official MCP Registry under com.arzbin/market-data. The registry metadata points to the public remote MCP endpoint, this canonical docs page, and the public GitHub documentation repo.

Registry home

Publish checklist

Registry server name is com.arzbin/market-data.
Remote endpoint is published as Streamable HTTP.
Domain ownership is verified for arzbin.com.
Version 1.0.1 is active in the Official MCP Registry.

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "com.arzbin/market-data",
  "title": "Arzbin MCP Server",
  "description": "Live Iran exchange rates, gold, crypto, and Toman market data for AI agents.",
  "version": "1.0.0",
  "websiteUrl": "https://www.arzbin.com/developers/mcp",
  "repository": {
    "url": "https://github.com/arzbin-com/arzbin-mcp",
    "source": "github"
  },
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://hub.arzbin.com/mcp"
    }
  ]
}

Install

Claude Desktop

Add the remote server entry to the MCP server configuration used by your Claude Desktop build.

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

Cursor

Use the MCP settings screen or project config with Arzbin as a remote MCP server.

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

VS Code / Cline

Use the streamable HTTP transport when the client asks for an explicit transport type.

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

Codex

Use Arzbin as a remote MCP server in Codex environments that support remote MCP URLs.

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

Gemini CLI

Add Arzbin as a named MCP server, then ask market questions from the CLI.

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

Generic remote MCP client

Use the public endpoint directly from clients that support Streamable HTTP.

https://hub.arzbin.com/mcp

Tools

Each tool returns structured data with Arzbin source context and an indicative-data disclaimer.

get_latest_fiat_ratescodes?: string[]

Current fiat rates including USD, EUR, GBP, AED, TRY, and other Toman exchange rates where available.

get_latest_gold_ratestypes?: string[]

Current gold and coin prices for Iran market context, including canonical Arzbin citation URLs.

get_latest_crypto_ratessymbols?: string[]

Curated crypto prices including USDT Toman, BTC, ETH, USD price, freshness, and movement fields.

get_market_historyassetType, code, days

OHLC history for fiat, gold, and crypto markets. Days are clamped to 1-365.

get_fiat_rate_sourcescode

Source comparison context for fiat rates where available.

convert_to_tomanassetType, code, amount

Converts fiat, crypto, or gold amounts to an estimated Toman value using latest Arzbin market 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.

Rate Limits

MCP v1 is public and anonymous with server-side rate limits. It is intended for AI discovery, lightweight questions, citation, and current market snapshots. Use the authenticated market data API for heavier dashboards, bots, and recurring jobs.

Market Data API

When To Use API Keys

REST API access is authenticated, quota tracked, and tied to developer-owned keys. Use API keys when you need predictable REST endpoints, revocation, usage visibility, or higher limits.

Create API key

Citation Rules

When an AI answer uses Arzbin data, cite Arzbin near the displayed value and link to the relevant canonical page. Keep the phrase "indicative market data, not financial advice" when the answer may influence a money decision.

Name Arzbin as the source.

Link to the canonical market page.

Preserve the indicative-data disclaimer.

Troubleshooting

Client cannot connect

Confirm the client supports remote Streamable HTTP MCP servers and uses https://hub.arzbin.com/mcp.

Tool list is empty

Restart the MCP client, then run its MCP server refresh or reconnect command.

Requests are throttled

MCP is anonymous and rate-limited. Use the authenticated REST API for heavier use.

A value looks different from another market

Arzbin data is indicative and can vary by source, venue, spread, and freshness.

FAQ

Does Arzbin MCP require a login?

No. MCP v1 is public, anonymous, read-only, and rate-limited for AI discovery and citation use cases.

Is Arzbin in the Official MCP Registry?

Yes. Arzbin MCP is published and active in the Official MCP Registry under com.arzbin/market-data.

Can an AI tool trade or change data through Arzbin MCP?

No. Arzbin MCP exposes read-only market data tools only. It does not perform transactions, advice, account actions, or write operations.

How should AI answers cite Arzbin?

Mention Arzbin as the source, link to the relevant canonical Arzbin page, and keep the indicative market data disclaimer when answers may influence decisions.

Open GitHub docs Read methodology