Iran Fara Bourse

Name: Iran Fara Bourse
Author: sepehr071

by sepehr071version 0.2.0i★ –iRuns on your computer

Registry nameio.github.sepehr071/ifb-mcp

Install

Overview

Description from the maker (original English)

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

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiEarly↓ 340/wk · ★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: IFB_MCP_PROXY

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "ifb": {
      "command": "uvx",
      "args": [
        "ifb-mcp"
      ],
      "env": {
        "IFB_MCP_PROXY": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add ifb --env IFB_MCP_PROXY=your-value -- uvx ifb-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "ifb": {
      "command": "uvx",
      "args": [
        "ifb-mcp"
      ],
      "env": {
        "IFB_MCP_PROXY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "ifb": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ifb-mcp"
      ],
      "env": {
        "IFB_MCP_PROXY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

IFB_MCP_PROXY env
Optional HTTP proxy URL for the ifb.ir requests; system proxy settings are ignored. Also accepts a comma-separated list: one is used until it gets blocked or fails to connect, then the next.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account sepehr071, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 18600 servers in this category
Published to the registry more recently than 95% of the other 18600 servers in this category
Basic checks equal to or better than 100% of the other 18600 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Iran Fara Bourse safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.2.0) reached the registry 2 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, alalanet — check before you pay

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

by formulahendryEarly↓ 66/wk★ 440Updated 14 months ago

Runs on your computer

Install

Remote Desktop Commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

by desktop-commanderGrowing★ 211Updated 3 days ago

Runs in the cloud✓ desktopcommander.app

Install

alalanet — check before you pay

Check packages, MCP servers and x402 endpoints before agents install or pay. Signed.

by alalanetEarlyUpdated today

Runs in the cloud✓ alalanet.com

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

ifb-mcp: Iran Fara Bourse (فرابورس ایران) bonds, sukuk and IPO MCP server for AI agents

ifb-mcp is an unofficial, read-only MCP server that gives AI agents the public data of Iran Fara Bourse (ifb.ir), Iran's over-the-counter exchange.

Its 16 tools rank bonds, sukuk and treasury bills (اخزا) by yield to maturity, explain a paper's coupons and issuer,

quote prices and order books, list IPOs and new offerings, search exchange notices and news, and summarise the market.

No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

For AI agents · Quick start · What it can do · Tools · FAQ · فارسی

For AI agents

What: unofficial MCP server (model context protocol) for ifb.ir: yield to maturity of every treasury bill, sukuk and bond, instrument details with coupon schedules, live quotes and order books, price and yield history, IPOs (finished and upcoming), underwritings, exchange announcements, news and market messages, market summary, the live market watch with top movers and most traded, index history, halted symbols, capital increases and board transfers, yield curves and who trades Islamic securities.
Install: uvx ifb-mcp or claude mcp add ifb -- uvx ifb-mcp. Transport: stdio. Needs uv (Python 3.10+).
Auth: none. Optional IFB_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
Access: read-only. It cannot trade, log in or change anything, so no confirmation is needed before calling any tool.
Tools: 16, all prefixed ifb_. Typical sequences: ifb_yields -> ifb_instrument / ifb_quote; ifb_search -> ifb_history; ifb_ipos(stage="pipeline"); ifb_announcements -> ifb_article.
Use when: the user asks which bond, sukuk or treasury bill yields most or matures when, what a paper pays and when, a Fara Bourse price or order book, what IPOs are coming or happened, why a symbol is halted, or how the market did.
Do not use when: the question is about the Tehran Stock Exchange (tse.ir), cryptocurrencies or gold; or the user wants to place an order.
Output: compact JSON. Prices in rial, yields in percent a year, dates Jalali (1405/08/09). Texts are the exchange's own (Persian). The site is reachable from Iranian networks only.
Machine-readable: server.json.

Why

On ifb.ir, "which treasury bill maturing before next spring pays the best yield?" means opening the yield page, scrolling 1,000 rows and sorting by hand. With ifb-mcp an agent answers it in one call:

You: Best yield among treasury bills maturing before 1405/12/01?

Agent: *calls* ifb_yields(kind="treasury", matures_before="1405/12/01", limit=3)

Data is the exchange's, as shown on its website; yields are computed by Fara Bourse from the last trade. This is information, not investment advice.

What it can do

Rank fixed income by yield: treasury bills, sukuk, participation papers and other bonds with last price, maturity and YTM, filtered by yield, maturity and symbol
Explain a paper: coupon rate, maturity, issuer, guarantor, underwriter, market maker, full coupon schedule and the next payment
Quote and chart: live price, change, volume, order book with the yield of each bid and offer, and daily history with YTM
Follow offerings: finished IPOs with price and volume (filter by market and pricing method), companies being introduced, underwritings
Read the exchange: search official notices, news and market messages (halts, openings) by keyword and date, and read an article
Watch the live market: every symbol's price, change and best bid/ask ranked by change or value, per board; halted symbols with reasons; index history since 2009; capital increases and board transfers
See the market: index, turnover, bond indices, each board's value and top movers, the fitted yield curves and who buys and sells Islamic securities
Read-only by design: no login, no orders

Quick start

You need uv. No API key or account. ifb.ir answers Iranian networks; from abroad set IFB_MCP_PROXY to an Iranian proxy.

claude mcp add ifb -- uvx ifb-mcp

Claude Desktop, Cursor and others:

"mcpServers": { "ifb": { "command": "uvx", "args": ["ifb-mcp"] } } }

Tools

Tool	Use it to
`ifb_search`	turn a symbol or name into an instrument id
`ifb_yields`	rank bonds, sukuk and treasury bills by YTM with maturity and price filters
`ifb_instrument`	read coupon rate, maturity, issuer, guarantor and the coupon schedule
`ifb_quote`	get the live price, volume, order book and yields
`ifb_history`	get daily prices and YTM
`ifb_ipos`	list finished IPOs or those upcoming and under way
`ifb_underwritings`	list securities offered by underwriting
`ifb_announcements`	search notices, news and market messages
`ifb_article`	read one news article
`ifb_market_summary`	index, turnover, bond indices, boards and top movers
`ifb_yield_curve`	fitted yield curves for government, non-government and treasury bills
`ifb_sukuk_flows`	daily value of Islamic securities bought and sold by investor type
`ifb_market_watch`	live market watch: top gainers, losers and most traded per board, halted symbols
`ifb_index_history`	daily history of the total, equal-weight, price and sukuk indices with 1d/5d/21d/250d changes
`ifb_corporate_actions`	capital increases with rights windows, board transfers, new listings, moves to Tehran Stock Exchange
`ifb_halted`	symbols halted now with date and reason, and issuers flagged for weak disclosure

FAQ

Is it official? No. It reads the public pages and web service of ifb.ir and is not affiliated with Iran Fara Bourse.

Why do symbols end in a digit? The exchange lists each paper on several boards (کارون0731, 0732). Take the id from ifb_yields or ifb_search.

Is the market watch included? Not the live ranking grid, which the site fills through a push connection. Quotes come from the site's JSON service.

فارسی

ifb-mcp یک سرور MCP غیررسمی و فقطخواندنی برای فرابورس ایران (ifb.ir) است. با آن میتوان اوراق بدهی، صکوک و اسناد خزانه (اخزا) را بر پایهٔ بازده تا سررسید (YTM) مرتب کرد، جزئیات و برنامهٔ پرداخت سود هر ورقه را دید، قیمت و صف خرید و فروش را گرفت، عرضههای اولیه و پذیرهنویسیها را دید، اطلاعیهها و اخبار را جستجو کرد و خلاصهٔ بازار را خواند. کلید API یا حساب لازم نیست. سایت فقط از شبکههای ایران پاسخ میدهد.

نصب: claude mcp add ifb -- uvx ifb-mcp

License

MIT

Iran Fara Bourse

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

alalanet — check before you pay

README from the maker

ifb-mcp: Iran Fara Bourse (فرابورس ایران) bonds, sukuk and IPO MCP server for AI agents

For AI agents

Why

What it can do

Quick start

Tools

FAQ

فارسی

License