# Arzbin Mcp

> Arzbin MCP Server metadata, install snippets, and docs for live Iran market data.

- **Type:** MCP server
- **Install:** `agentstack add mcp-arzbin-com-arzbin-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [arzbin-com](https://agentstack.voostack.com/s/arzbin-com)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 1.0.0
- **License:** MIT
- **Upstream author:** [arzbin-com](https://github.com/arzbin-com)
- **Source:** https://github.com/arzbin-com/arzbin-mcp
- **Website:** https://www.arzbin.com/developers/mcp

## Install

```sh
agentstack add mcp-arzbin-com-arzbin-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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](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](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.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [arzbin-com](https://github.com/arzbin-com)
- **Source:** [arzbin-com/arzbin-mcp](https://github.com/arzbin-com/arzbin-mcp)
- **License:** MIT
- **Homepage:** https://www.arzbin.com/developers/mcp

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v1.0.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **1.0.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-arzbin-com-arzbin-mcp
- Seller: https://agentstack.voostack.com/s/arzbin-com
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.