Mizan

Working · 38 ms

io.github.GoodTurnStudio/mizanv1.1.0

Shariah screening of US stocks under four standards, halal alternatives, purification and zakat.

Finance & Payments

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://goodturn-mcp.pages.dev/mizan/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

calculate_zakat Read-only

Zakat owed on cash, gold, silver, shares and business stock, using live gold and silver prices.

cashnumber

Cash and bank balances.

nisabstring

Which nisab to use. Defaults to silver.

currencystring

Defaults to USD.

gold_gramsnumber

Gold held, in grams.

gold_valuenumber

Or the value of gold held.

owed_to_younumber

Money owed to you that you expect to be repaid.

silver_gramsnumber

Silver held, in grams.

silver_valuenumber

Or the value of silver held.

debts_due_nownumber

Debts due now, deducted.

business_stocknumber

Value of business stock for sale.

shares_tradingnumber

Market value of shares held for trading (counted in full)

shares_longtermnumber

Market value of shares held long term.

share_zakatable_pctnumber

Share of long-term holdings treated as zakatable, default 25.

Tools (6)

calculate_zakat

Zakat owed on cash, gold, silver, shares and business stock, using live gold and silver prices.

read-only

Argument	Type	Description
cash	number	Cash and bank balances.
nisab	string	Which nisab to use. Defaults to silver.
currency	string	Defaults to USD.
gold_grams	number	Gold held, in grams.
gold_value	number	Or the value of gold held.
owed_to_you	number	Money owed to you that you expect to be repaid.
silver_grams	number	Silver held, in grams.
silver_value	number	Or the value of silver held.
debts_due_now	number	Debts due now, deducted.
business_stock	number	Value of business stock for sale.
shares_trading	number	Market value of shares held for trading (counted in full)
shares_longterm	number	Market value of shares held long term.
share_zakatable_pct	number	Share of long-term holdings treated as zakatable, default 25.

Input schema (JSON)

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

Argument	Type	Description
ticker*	string	The holding to replace: a US listing symbol or company name.

Input schema (JSON)

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

purify_dividend

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

Argument	Type	Description
ticker*	string	US listing symbol.
dividend	number	The dividend received, in any currency.

Input schema (JSON)

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

Argument	Type	Description
ticker*	string	US listing symbol (a common company name also works).

Input schema (JSON)

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

Argument	Type	Description
holdings*	string	Comma-separated tickers, each optionally followed by a colon and the value held, for weighting.

Input schema (JSON)

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