IraniWallet Rates

Live buy and sell rates from IraniWallet, an Iranian exchange desk, as an MCP server. Your assistant reads today's USD, EUR, TRY, AED, CNY, USDT and other listed currencies in Iranian Toman (IRT) instead of guessing a number from training data.

No API key. No account. Read-only.

Endpoint: https://iraniwallet.com/api/v1/mcp/rates
Docs: https://iraniwallet.com/mcp/rates
Transport: Streamable HTTP
Auth: none

Install

Claude Code

claude mcp add --transport http --scope user iraniwallet-rates https://iraniwallet.com/api/v1/mcp/rates

Cursor

Put this in .cursor/mcp.json (this project) or ~/.cursor/mcp.json (all projects):

{
  "mcpServers": {
    "iraniwallet-rates": {
      "url": "https://iraniwallet.com/api/v1/mcp/rates"
    }
  }
}

Other clients

Same mcpServers shape. Clients that only speak local stdio can bridge it:

{
  "mcpServers": {
    "iraniwallet-rates": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://iraniwallet.com/api/v1/mcp/rates"]
    }
  }
}

Tools

Tool	Arguments	What it does
`get_rates`	none	The whole board: every currency the desk trades, with buy and sell in Toman for one unit, plus `updatedAt`.
`get_rate`	`code` (string, e.g. `USD`)	One currency. If the desk does not trade it, the error lists what it does trade — it never invents a price.

buy is what the desk pays you for the currency. sell is what it charges you for it.

What you can ask

What is the dollar buy and sell rate today?
How many toman is 500 Turkish lira?
Compare USDT and USD and tell me the spread.
With 10 million toman, how many dirham can I buy?
Put today's rates in a table.

Ask in ordinary language. You do not need to name the tools.

Limits

10 tool calls per minute per IP. Handshake and tools/list are free. Over the limit the server answers 429 with Retry-After.
The board is rebuilt at most every 10 minutes. Asking again does not produce a newer number. Quote updatedAt with every rate.
Published rates, not a trade commitment. The fill price is set in the customer panel when an order is placed.

iraniwallet

What it can do

What data it sees

Do you need an account