Fipiran Funds

io.github.sepehr071Published by GitHub account sepehr071v0.2.0Updated Nov 7, 2026

Read-only Fipiran (fipiran.ir) data on Iranian mutual funds and ETFs: NAV, returns, size, managers.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Unofficial read-only MCP server for Iranian mutual fund and ETF data from Fipiran, plus Tehran market indices and stock quotes.

What you can do
  • Search and rank about 500 Iranian mutual funds and ETFs by type, manager, size and return, and list fund types with average returns
  • Show one fund in full and pull daily NAV, rolling returns, size, flows, investor mix or dividends history
  • Compare 2 to 8 funds side by side and rank fund management companies by assets under management
  • Browse Tehran and Farabourse market overview, 65 indices with history, last-day stock quotes and industry rankings
When to use it
Useful when someone asks which Iranian funds returned the most, the biggest gold or fixed-income funds, a fund's NAV or price history, how a fund compares with its type average, or who manages it.
Requirements
Runs locally over stdio via uvx, so uv with Python 3.10+ is needed. No account or API key. Network access to fipiran.ir is required, and the site only answers Iranian internet lines; outside Iran an HTTP proxy must be supplied through FIPIRAN_MCP_PROXY, since system proxy settings are ignored.
Before you install
Unofficial and not affiliated with Fipiran; it reads the same public JSON the site's fund pages load. Read-only, with no login-only features such as ranking reports, watchlists or exports. Data is not investment advice, and past returns do not predict future returns. Outside Iran, requests must be routed through a proxy set in FIPIRAN_MCP_PROXY.

Installation

In SourceWeft

  1. Open Fipiran Funds in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

fipiran-mcp: Fipiran (فیپیران) Iranian mutual fund and ETF data MCP server for AI agents

fipiran-mcp is an unofficial, read-only MCP server that gives AI agents the public fund data of Fipiran (مرکز پردازش اطلاعات مالی ایران, fipiran.ir).
Its 11 tools search and rank Iranian mutual funds and ETFs (صندوق‌های سرمایه‌گذاری) by type, manager, size and return,
show one fund in full, return daily NAV, return, size, flow and investor-mix history, compare funds, rank fund managers, and cover the bourse: market overview, indices, stock quotes and industries. No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

[PyPI] [License: MIT]

For AI agents

  • What: unofficial MCP server for fipiran.ir fund pages: search and ranking of about 500 Iranian mutual funds and ETFs, fund details, daily NAV / rolling-return / size history, side-by-side comparison, fund types with average returns, fund management companies.
  • Install: uvx fipiran-mcp or claude mcp add fipiran -- uvx fipiran-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none. Optional FIPIRAN_MCP_PROXY (HTTP proxy URL); system proxy settings are ignored.
  • Network: fipiran.ir answers Iranian internet lines only. Outside Iran, set FIPIRAN_MCP_PROXY to an Iranian proxy.
  • Access: read-only, no confirmation needed. Login-only Fipiran features (ranking reports, watchlists, exports) are not included.
  • Tools: 11, all prefixed fp_: fp_search_funds, fp_fund_types, fp_fund, fp_history, fp_compare, fp_managers, fp_indices, fp_index_history, fp_stocks, fp_stock, fp_industries. Typical sequence: fp_search_funds -> fp_fund / fp_history / fp_compare.
  • Use when: the user asks which Iranian funds returned most, the biggest gold or fixed-income funds, the NAV or price history of a fund, how a fund compares with its type average, or who manages a fund.
  • Output: compact JSON. Returns are percent per period (not annualised); sizes billion Toman; NAV rial per unit. Names are Persian.

Tools

ToolWhat it does
fp_search_fundsFind and rank funds by name, ticker, type, manager, size, age and return (daily to since-start).
fp_fund_typesFund types with fund count, total size, average returns and average asset allocation.
fp_fundOne fund in full: NAV, returns, size, allocation, investors, manager, auditor, custodian, website; optional past date.
fp_historyDaily NAV, rolling returns, net assets and unit flows, institutional/retail mix or dividends of one fund (up to 60 evenly spaced points).
fp_compare2 to 8 funds side by side.
fp_managersFund management companies by assets under management.
fp_indicesTehran and Farabourse market overview plus the 65 market and industry indices ranked by return.
fp_index_historyDaily value (with low and high) or rolling returns of one index.
fp_stocksSearch and rank listed shares of the last trading day: gainers, losers, most traded, by industry or market.
fp_stockOne share in full: quote, range, 5-level order book, retail vs institutional, period returns, optional OHLC history.
fp_industriesIndustries ranked by traded value, volume and trades on the last day.

Quick start

bash
uvx fipiran-mcp

Claude Desktop / Cursor config:

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

FAQ

Is it official? No. It reads the same public JSON the fipiran.ir fund pages load; it is not affiliated with Fipiran.
Is this investment advice? No. It is data. Past returns do not predict future returns; very young funds show distorted annual returns.
Why does it fail outside Iran? The site does not answer foreign IPs. Use FIPIRAN_MCP_PROXY.

Author: Sepehr Radmard (سپهر رادمرد), github.com/sepehr071, linkedin.com/in/sepehr-radmard. MIT license.

Source: README.md at commit 726b495

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.2.0LatestNov 7, 2026
  2. v0.1.0Nov 1, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts