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.

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

Quick start

uvx fipiran-mcp

Claude Desktop / Cursor config:

{ "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.