Read-only Iran Fara Bourse (ifb.ir): bond, sukuk and treasury yields, IPOs, notices, market stats.

GitHub stars
270

Install

/plugin install ifb@iran-mcp

Run it inside Claude Code after adding the marketplace with /plugin marketplace add sepehr071/iran-mcp.

Contents

Discovered from source

Skills 1

Iran Fara Bourse

Read-only Iran Fara Bourse (ifb.ir): bond, sukuk and treasury yields, IPOs, notices, market stats.

The tools below come from the ifb-mcp MCP server. If they are not available, install it with claude mcp add ifb -- uvx ifb-mcp, or add "ifb": {"command": "uvx", "args": ["ifb-mcp"]} to the client's MCP servers config. It needs uv. Restart the session after installing.

Tools

  • ifb_search: Find Iran Fara Bourse instruments (stocks, bonds, sukuk, treasury bills, funds, options) by symbol or name.
  • ifb_yields: List fixed-income papers on Fara Bourse with last price, maturity and yield to maturity (YTM), filtered and ranked.
  • ifb_instrument: Describe one Fara Bourse instrument: name, ISIN, market, and for bonds the coupon rate, maturity, issuer, guarantor and payment schedule.
  • ifb_quote: Get the live trading data of one instrument: last and closing price, change, volume, value, order book, and YTM for bonds.
  • ifb_history: Get daily price history of one instrument: first, high, low and closing price and volume per trading day, newest first.
  • ifb_ipos: List Fara Bourse initial public offerings (IPOs): finished ones with price and volume, or those upcoming and under way.
  • ifb_underwritings: List securities offered through underwriting (پذیره‌نویسی) on Fara Bourse, newest first.
  • ifb_announcements: Search Fara Bourse announcements, news and market messages by keyword and date, newest first.
  • ifb_article: Read the text of one Fara Bourse news article (weekly trading statistics, listings, rule changes).
  • ifb_market_summary: Summarise the Fara Bourse session: index, bond indices, total turnover, and each market's value traded with its top movers.
  • ifb_yield_curve: Get Fara Bourse's fitted yield curves (Svensson/Nelson model) for government papers, non-government papers and treasury bills.
  • ifb_sukuk_flows: Show daily trading value of Islamic financial securities (sukuk, treasury bills) by who bought and sold, newest day first.
  • ifb_market_watch: Show the live Fara Bourse market watch: every symbol's price, change, volume and best bid and ask, ranked and filtered.
  • ifb_index_history: Get the daily history of a Fara Bourse index since 2009, with change over a day, week, month and year.
  • ifb_corporate_actions: List corporate actions on Fara Bourse: capital increases under way, board transfers, and moves to or from the Tehran Stock Exchange.
  • ifb_halted: List the symbols halted on Fara Bourse with the date and reason, or the issuers flagged for weak disclosure.

Rules

  • Prices are Toman. Convert before comparing with a Rial figure from anywhere else.
  • Read-only: no login, basket, booking, order or payment. Give the user the link to finish on the site.
  • Keep request rates low. These are undocumented site APIs that can change or rate-limit.
  • On timeouts or HTTP 403 outside Iran, set IFB_MCP_PROXY to an HTTP proxy with an Iranian IP.
  • Prices are Rial, not Toman; yields are percent a year; dates Jalali. ifb.ir answers only Iranian connections; outside Iran the user needs IFB_MCP_PROXY.

Maintainer

Sepehr Radmard: open-source MCP servers for the Iranian web

Built and maintained by Sepehr Radmard (سپهر رادمرد): LinkedIn · GitHub. More servers for Iranian websites: iran-mcp.

MCP servers 1

Sponsors

Details

Marketplace
sepehr071/iran-mcp
Source
plugins/ifb
Category
Stocks

More from sepehr071/iran-mcp

All 96