MCP Server

Mizan

io.github.GoodTurnStudio/mizan
Finance & Investing Public & reachable MCP 2026-07-28

What this MCP does

Screens US-listed companies and portfolios against four Shariah investment standards and calculates halal alternatives, dividend purification and zakat.

calculate_zakat
Zakat owed on cash, gold, silver, shares and business stock
Zakat owed on cash, gold, silver, shares and business stock, using live gold and silver prices.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'cash': {'type': 'number', 'minimum': 0, 'description': 'Cash and bank balances.'}, 'nisab': {'enum': ['silver', 'gold'], 'type': 'string', 'description': 'Which nisab to use. Defaults to silver.'}, 'currency': {'enum': ['USD', 'GBP', 'EUR', 'CAD', 'AUD'], 'type': 'string', 'description': 'Defaults to USD.'}, 'gold_grams': {'type': 'number', 'minimum': 0, 'description': 'Gold held, in grams.'}, 'gold_value': {'type': 'number', 'minimum': 0, 'description': 'Or the value of gold held.'}, 'owed_to_you': {'type': 'number', 'minimum': 0, 'description': 'Money owed to you that you expect to be repaid.'}, 'silver_grams': {'type': 'number', 'minimum': 0, 'description': 'Silver held, in grams.'}, 'silver_value': {'type': 'number', 'minimum': 0, 'description': 'Or the value of silver held.'}, 'debts_due_now': {'type': 'number', 'minimum': 0, 'description': 'Debts due now, deducted.'}, 'business_stock': {'type': 'number', 'minimum': 0, 'description': 'Value of business stock for sale.'}, 'shares_trading': {'type': 'number', 'minimum': 0, 'description': 'Market value of shares held for trading (counted in full)'}, 'shares_longterm': {'type': 'number', 'minimum': 0, 'description': 'Market value of shares held long term.'}, 'share_zakatable_pct': {'type': 'number', 'minimum': 0, 'description': 'Share of long-term holdings treated as zakatable, default 25.'}}, 'additionalProperties': False}
find_halal_alternatives
Halal alternatives to a holding
Halal alternatives to a holding. Companies Mizan covers in the same industry (or the nearest related one) whose business is permitted and whose debt passes all four standards at the last quarter-end, largest first, plus Shariah index funds for US and UK investors. Screen a pick live with screen_company before buying.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'The holding to replace: a US listing symbol or company name.'}}, 'additionalProperties': False}
list_standards
The four standards, their denominators and thresholds
The four standards, their denominators and thresholds. Screens a US-listed company against four published Shariah equity standards (AAOIFI, Dow Jones Islamic Market, S&P Shariah, MSCI Islamic), first on its business (prohibited industries each standard excludes) and then on its debt, using live...
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
purify_dividend
How much of a dividend to give to charity
How much of a dividend to give to charity. Returns the company's purification ratio (interest income over total revenue, from its latest 10-K that reports interest income; 'latest_annual_filing' and 'note' say when that is older than the latest 10-K) and, if a dividend amount is given, the amount to give to charity. For a company whose main business every standard excludes, 'business_screen' explains that purification does not make it permissible.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'US listing symbol.'}, 'dividend': {'type': 'number', 'description': 'The dividend received, in any currency.'}}, 'additionalProperties': False}
screen_company
Screen one company against all four standards
Screen one company against all four standards. Returns a 'say' sentence, the live price, the consolidated share count, the filing figures used, the business screen per standard ('business': main_business, by_standard pass/fail/review, excluded_under), and each standard's ratio, threshold and verdict. In each screens entry, 'compliant' is the overall verdict (false when that standard excludes the company's business, null when the business needs a closer look) and 'debt_compliant' is the debt test alone. Verdicts within one percent of a threshold are flagged borderline. A company name (for example nvidia) also works.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'US listing symbol (a common company name also works).'}}, 'additionalProperties': False}
screen_portfolio
Screen a whole portfolio
Screen a whole portfolio. Screens up to 15 holdings under all four standards and returns the share of the portfolio that is compliant under each, the holdings that fail, and a combined dividend purification ratio.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['holdings'], 'properties': {'holdings': {'type': 'string', 'description': 'Comma-separated tickers, each optionally followed by a colon and the value held, for weighting.'}}, 'additionalProperties': False}
Changed
calculate_zakat
Oct. 1, 2026, 2:40 a.m.
Changed
screen_portfolio
Oct. 1, 2026, 2:40 a.m.
Changed
find_halal_alternatives
Oct. 1, 2026, 2:40 a.m.
Changed
purify_dividend
Oct. 1, 2026, 2:40 a.m.
Changed
list_standards
Oct. 1, 2026, 2:40 a.m.
Changed
screen_company
Oct. 1, 2026, 2:40 a.m.
Added
calculate_zakat
Sept. 29, 2026, 2:40 a.m.
Added
screen_portfolio
Sept. 29, 2026, 2:40 a.m.
Added
find_halal_alternatives
Sept. 29, 2026, 2:40 a.m.
Added
purify_dividend
Sept. 29, 2026, 2:40 a.m.
Added
list_standards
Sept. 29, 2026, 2:40 a.m.
Added
screen_company
Sept. 29, 2026, 2:40 a.m.