Arzbin MCP Server
Live Iran exchange rates, gold, crypto, and Toman market data for AI agents.
Should I use this
Quality & Safety
A
Findings (2)
- LOWTool 'get_market_history' description lacks action verbin get_market_history
- LOWTool 'get_fiat_rate_sources' description lacks action verbin get_fiat_rate_sources
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~1,614Tokens (tool definitions)
~2.4 KBTypical response size
Moderate attention impact (1.26% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"market-data": {
"url": "https://hub.arzbin.com/mcp"
}
}
}Remote endpoints
https://hub.arzbin.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (6)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢convert_to_toman(assetType, code, amount)
Converts a fiat, crypto, or gold amount to an estimated Toman value using latest Arzbin indicative market data. Not financial advice.
Input Schema
{
"type": "object",
"properties": {
"assetType": {
"description": "Asset type: fiat, crypto, or gold.",
"type": "string"
},
"code": {
"description": "Asset code such as USD, EUR, USDT, BTC, EMAMI, or GOLD_GRAM.",
"type": "string"
},
"amount": {
"description": "Amount of the asset to convert to Toman. Must be greater than zero.",
"type": "number"
}
},
"required": [
"assetType",
"code",
"amount"
]
}Output Schema
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"disclaimer": {
"type": "string"
},
"generatedAtUtc": {
"type": "string",
"format": "date-time"
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"assetType": {
"type": "string"
},
"code": {
"type": "string"
},
"amount": {
"type": "number"
},
"rateToman": {
"type": "number"
},
"estimatedToman": {
"type": "number"
},
"generatedAtUtc": {
"type": "string",
"format": "date-time"
},
"canonicalUrl": {
"type": "string"
},
"disclaimer": {
"type": "string"
}
},
"required": [
"assetType",
"code",
"amount",
"rateToman",
"estimatedToman",
"generatedAtUtc",
"canonicalUrl",
"disclaimer"
]
}
},
"required": [
"source",
"disclaimer",
"generatedAtUtc",
"data"
]
}🟢get_latest_gold_rates(types)
Returns latest Arzbin gold and coin rates in Toman. Data is indicative market data, not financial advice.
Input Schema
{
"type": "object",
"properties": {
"types": {
"description": "Optional gold or coin codes such as EMAMI, AZADI, GOLD_GRAM. Omit for all available gold rates.",
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"default": null
}
}
}Output Schema
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"disclaimer": {
"type": "string"
},
"generatedAtUtc": {
"type": "string",
"format": "date-time"
},
"data": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"buy": {
"type": "number"
},
"sell": {
"type": "number"
},
"category": {
"type": "string"
},
"change": {
"type": "string"
},
"canonicalUrl": {
"type": "string"
}
},
"required": [
"code",
"name",
"buy",
"sell",
"category",
"change",
"canonicalUrl"
]
}
}
},
"required": [
"source",
"disclaimer",
"generatedAtUtc",
"data"
]
}🟢get_market_history(assetType, code, days)
Returns OHLC history for a fiat, gold, or crypto market. Days are clamped to 1-365.
Input Schema
{
"type": "object",
"properties": {
"assetType": {
"description": "Asset type: fiat, gold, or crypto.",
"type": "string"
},
"code": {
"description": "Market code, such as USD, EMAMI, GOLD_GRAM, USDT, BTC.",
"type": "string"
},
"days": {
"description": "Number of days of history to return, from 1 to 365.",
"type": "integer",
"default": 30
}
},
"required": [
"assetType",
"code"
]
}Output Schema
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"disclaimer": {
"type": "string"
},
"generatedAtUtc": {
"type": "string",
"format": "date-time"
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"code": {
"type": "string"
},
"period": {
"type": "string"
},
"points": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"open": {
"type": "number"
},
"high": {
"type": "number"
},
"low": {
"type": "number"
},
"close": {
"type": "number"
}
}
}
}
}
}
},
"required": [
"source",
"disclaimer",
"generatedAtUtc",
"data"
]
}🟢get_latest_crypto_rates(symbols)
Returns latest curated Arzbin crypto prices in Toman and USD. Data is indicative market data, not financial advice.
Input Schema
{
"type": "object",
"properties": {
"symbols": {
"description": "Optional crypto symbols such as USDT, BTC, ETH. Omit for all available crypto rates.",
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"default": null
}
}
}Output Schema
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"disclaimer": {
"type": "string"
},
"generatedAtUtc": {
"type": "string",
"format": "date-time"
},
"data": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"tomanPrice": {
"type": "number"
},
"usdPrice": {
"type": "number"
},
"change24h": {
"type": [
"number",
"null"
]
},
"change7d": {
"type": [
"number",
"null"
]
},
"isDerived": {
"type": "boolean"
},
"isStale": {
"type": "boolean"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"canonicalUrl": {
"type": "string"
}
},
"required": [
"code",
"name",
"tomanPrice",
"usdPrice",
"change24h",
"change7d",
"isDerived",
"isStale",
"updatedAt",
"canonicalUrl"
]
}
}
},
"required": [
"source",
"disclaimer",
"generatedAtUtc",
"data"
]
}🟢get_latest_fiat_rates(codes)
Returns latest Arzbin fiat currency rates in Toman. Data is indicative market data, not financial advice.
Input Schema
{
"type": "object",
"properties": {
"codes": {
"description": "Optional fiat currency codes such as USD, EUR, AED, GBP. Omit for all available fiat rates.",
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"default": null
}
}
}Output Schema
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"disclaimer": {
"type": "string"
},
"generatedAtUtc": {
"type": "string",
"format": "date-time"
},
"data": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"buy": {
"type": "number"
},
"sell": {
"type": "number"
},
"change": {
"type": "string"
},
"canonicalUrl": {
"type": "string"
}
},
"required": [
"code",
"name",
"buy",
"sell",
"change",
"canonicalUrl"
]
}
}
},
"required": [
"source",
"disclaimer",
"generatedAtUtc",
"data"
]
}🟢get_fiat_rate_sources(code)
Returns Arzbin source comparison data for a fiat currency code where available.
Input Schema
{
"type": "object",
"properties": {
"code": {
"description": "Fiat currency code such as USD, EUR, AED, GBP.",
"type": "string"
}
},
"required": [
"code"
]
}Output Schema
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"disclaimer": {
"type": "string"
},
"generatedAtUtc": {
"type": "string",
"format": "date-time"
},
"data": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"source": {
"type": "string"
},
"buy": {
"type": "number"
},
"sell": {
"type": "number"
},
"updatedAt": {
"type": "string",
"format": "date-time"
}
}
}
}
},
"required": [
"source",
"disclaimer",
"generatedAtUtc",
"data"
]
}Community
Evidence
Recent observations
verifiedversion not recorded6 tools
verifiedversion not recorded6 tools
verifiedversion not recorded6 tools