Mizan

io.github.GoodTurnStudioPublished by GitHub account GoodTurnStudiov1.1.0Updated Oct 25, 2026

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

The publisher's own server: Mizan

VerifiedStreamable HTTPWeb executableFinanceKnowledge & Memory

Overview

AI-generated overview

Mizan is a remote MCP server that lets an assistant screen US-listed stocks against four Shariah equity standards, find halal alternatives, purify dividends and

What you can do
Screen a single US-listed company against four Shariah standards, on business activity and on debt, with ratios, thresholds and verdicts returned. Screen a portfolio of up to 15 holdings and see the compliant share under each standard, the failing holdings and a combined purification ratio. List the four standards with their denominators and thresholds. Compute dividend purification amounts from a company's latest 10-K interest income. Find halal alternatives in the same or a related industry, plus Shariah index funds for US and UK investors. Calculate zakat on cash, gold, silver, shares and business stock using live metal prices.
When to use it
Useful when an assistant needs to check whether a US-listed stock or a whole portfolio is Shariah-compliant, to compare results across AAOIFI, Dow Jones Islamic Market, S&P Shariah and MSCI Islamic, or to work out dividend purification and zakat figures.
Requirements
A remote streamable HTTP endpoint; no sign-in, packages, environment variables or headers are declared. The server calls live price and filing data, so network access on the server side is implied.
Before you install
All tools are described as read-only and nothing about the user is stored, but results are screening guidance based on live prices and filings, not financial or religious advice. Verify figures before acting on them.

Installation

In SourceWeft

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

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.GoodTurnStudio%2Fmizan/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "mizan": {
      "type": "http",
      "url": "https://goodturn-mcp.pages.dev/mizan/mcp"
    }
  }
}

README

goodturn-mcp

Remote MCP servers for 25 free, read-only everyday helpers by Good Turn Studio: money, health, jobs, travel, shopping, halal checks, football and scripture reading. One Cloudflare Worker turns each product's public OpenAPI spec into an MCP server, so any assistant that speaks MCP (Claude, ChatGPT, Alexa+, Cursor, VS Code and others) can use them.

  • One server per product: https://goodturn-mcp.pages.dev/<slug>/mcp
  • All products in one: https://goodturn-mcp.pages.dev/all/mcp (tool names start with the product slug)
  • Streamable HTTP, stateless JSON, MCP 2025-11-25 (and 2025-06-18, 2025-03-26), no sign-in
  • Every tool is read-only, with a title and annotations (readOnlyHint: true, destructiveHint: false, idempotentHint: true)
  • Nothing about the user is stored. Privacy: https://goodturn-mcp.pages.dev/privacy

Products

ProductSlugWhat it does
MizanmizanShariah screening of US stocks under four standards, halal alternatives, purification, zakat
Halal or NothalalornotHalal checks for food, ingredients, medicines, stocks, funds and crypto
Fare DealsfaredealsCheap flights from any city, and the cheapest days to fly
Cheapest PricecheapestpriceThe lowest current price for a product, checked live
Spin My DayspinmydayA whole day out in any city, matched to weather, mood and diet
Cancel My SubcancelmysubHow to cancel US and UK subscriptions, and what a card charge is
Lower My BilllowermybillCall scripts and low-cost plans to lower household bills
Price Drop BackpricedropbackStore price-adjustment rules, deadlines and a claim message
Find My MoneyfindmymoneyOfficial unclaimed money searches in the US and UK
Supplement ChecksupplementcheckSupplement labels and doses against official upper limits
Plate PalplatepalCalories and nutrition for foods, chain meals and barcodes
Plan My WorkoutplanmyworkoutWorkout plans and how to do any exercise
Med Bill CheckmedbillcheckUS medical bills against Medicare rates, with dispute letters
Appeal My ClaimappealmyclaimUS health insurance denials, rights, deadlines and appeal letters
Job SpotterjobspotterCurrent US and UK job listings
Sync My CyclesyncmycycleLikely cycle phase today, with food and workout ideas
Wardrobe ConnectwardrobeconnectClothes that match a description or a picture
Form GuideformguideFootball form, fixtures, results and tables
Books Like ThisbookslikethisBooks like one you enjoyed, and screen adaptations
Talmud ScrollertalmudDaily Talmud with Daf Yomi, and tractates in English
Scroll the GurbanigurbaniDaily Gurbani with English, any Ang or shabad
Gita ScrollergitaDaily Bhagavad Gita verses with English
Scroll the LoreloreGreek and Norse myth, Homer, Hesiod and the Poetic Edda
Stoic ScrollerstoicsMarcus Aurelius, Epictetus and Seneca
Bible SwipebibleDaily Bible readings and any passage

How it works

  • build.py reads each product's live openapi.json and writes products.js: one tool per GET operation, named from its operationId, with inputs from its parameters. Descriptions are tidied into plain tool descriptions.
  • worker.mjs is the MCP server: initialize, tools/list and tools/call, which calls the product's own API and returns its answer. Answers with a say field carry a ready-made summary.
  • servers.json lists every server for the official MCP Registry (as io.github.GoodTurnStudio/<slug>). The Publish to the MCP Registry workflow logs in with GitHub OIDC and runs publish.py; publish.ps1 does the same from Windows.

Build and test

npm installnpm run build          # python3 build.py, then bundle to deploy/_worker.jsnpm test               # every product through the worker, against the live APIsnpm run test:live      # every tool through the deployed servers with the MCP SDK client

Deploy deploy/ as a Cloudflare Pages project in advanced mode (_worker.js).

Licence

MIT for this code. Each product's API, data and answers belong to that product and are served under its own terms, linked from its page at https://goodturn-mcp.pages.dev/<slug>.

Source: README.md at commit 7a0f5b3

Tools

6

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.

Parameterstickerrequired

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

Takes no parameters.

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.

Parameterstickerrequireddividend

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.

Parameterstickerrequired

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.

Parametersholdingsrequired

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.

Parameterscashnisabcurrencygold_gramsgold_valueowed_to_yousilver_gramssilver_valuedebts_due_nowbusiness_stockshares_tradingshares_longterm+1 more

Version history

1
  1. v1.1.0LatestSep 29, 2026

Score

100% 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 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Mizan integrations