Halal or Not

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

Is it halal? Food, medicines, stocks, funds and crypto, with a verdict for each of the four schools.

The publisher's own server: halal.sh Shariah compliance

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinanceMedia & Design

Overview

AI-generated overview

A remote MCP server that answers halal questions about food, cosmetics, medicines, stocks, funds, crypto and everyday life, with verdicts per Sunni school.

What you can do
Check ingredients, products by barcode, and search products by name or brand, each with a verdict per school and flagged ingredients explained one by one, including E-numbers and additives. Screen US-listed stocks and funds or ETFs against Shariah standards, and classify cryptocurrencies by what they do. Read medicine labels for gelatine, alcohol and other flagged ingredients, with the ruling on necessity leading. Ask general halal questions on money, crypto, medicine, food and everyday life, and browse the rulebook, topics and school differences. Get today's prayer times for a place, with both Asr times and Ramadan suhoor and iftar.
When to use it
Useful when someone wants a quick halal check on a packaged food, cosmetic, medicine, stock, fund or coin, or wants to compare how the four Sunni schools rule on a topic. Also handy for prayer times and Ramadan timings.
Requirements
A remote streamable HTTP endpoint; no sign-in, API key or environment variable is declared. The assistant needs network access to the hosted service. Product, medicine and fund lookups rely on public sources such as Open Food Facts, Open Beauty Facts, openFDA and SEC filings.
Before you install
All tools are described as read-only and nothing about the user is stored, but queries are sent to a third-party hosted service and to public data sources. Verdicts are religious guidance, not a substitute for a qualified scholar or, for medicines, for medical advice; the medicine tool is framed so nobody stops a prescribed medicine.

Installation

In SourceWeft

  1. Open Halal or Not 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%2Fhalalornot/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": {
    "halal-or-not": {
      "type": "http",
      "url": "https://goodturn-mcp.pages.dev/halalornot/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

13

check_ingredients

Check an ingredients list

Check an ingredients list. Takes the ingredients exactly as printed on the pack. Returns an overall verdict, a verdict for each school, and every flagged ingredient with the reason.

Parameterscontextingredientsrequired

check_product_by_barcode

Check a product by barcode

Check a product by barcode. Looks the barcode up in Open Food Facts, then Open Beauty Facts, and checks its ingredients.

Parametersbarcoderequired

search_products

Find products by name and check them

Find products by name and check them. Searches Open Food Facts by name or brand (for example 'Haribo Starmix') and returns up to five matches, each with a verdict, plus a 'say' line for the best match. Where a brand states the source of an ingredient its label leaves unnamed (Haribo: pork gelatine in its standard UK range), that statement decides it and is quoted in brand_statement.

Parametersqrequiredcountry

explain_ingredient

Explain one ingredient or E-number

Explain one ingredient or E-number. For example 'E471', 'carmine', 'prawns', 'whey' or 'alcohol denat'. Returns the verdict for each school and the reasoning.

Parametersnamerequiredcontext

screen_stock

Is this stock halal?

Is this stock halal? Screens a US-listed stock via Mizan: first the business (each standard's excluded industries), then the AAOIFI, Dow Jones Islamic, S&P Shariah and MSCI Islamic debt screens. A company name also works (nvidia, philip morris). Links to halal alternatives in the same industry.

Parameterstickerrequired

ask_is_it_halal

Ask any 'is it halal' question

Ask any 'is it halal' question. Covers money (savings, credit cards, mortgages, BNPL, insurance, pensions, trading), crypto, medicine, food and drink, and everyday life (music, dogs, tattoos, nail polish, smoking, games, photos, jobs). Returns the verdict, the main scholarly views and halal alternatives. Also recognises single ingredients and E-numbers.

Parametersqrequired

check_fund

Is this fund, ETF or pension fund halal?

Is this fund, ETF or pension fund halal? Recognises Shariah funds by name or ticker. For other US-registered funds and ETFs, reads the latest SEC holdings report and screens every holding by industry and debt. UK-listed ETFs (VUSA, CSPX, VWRL, SWDA, EQQQ, ISF and others) and fund names (Vanguard S&P 500, FTSE 100 tracker, LifeStrategy) are answered through a US fund tracking the same index, or from what the index holds, with UK Shariah options.

Parameterstickerrequired

check_crypto

Is this cryptocurrency halal?

Is this cryptocurrency halal? Classifies a coin by what it does (lending, gambling, meme, stablecoin, staking, general-purpose) and gives the scholarly views on crypto and on how it's used.

Parameterscoinrequired

check_medicine

Is this medicine halal?

Is this medicine halal? Reads a medicine's active and inactive ingredients from its US label (openFDA) and flags gelatine, alcohol, pig-derived enzymes and heparin. The headline and say line lead with the ruling on necessity, so nobody stops a prescribed medicine; the ingredient reading follows (ingredient_headline, verdict)

Parametersnamerequired

get_prayer_times

Today's prayer times for a place, with Ramadan suhoor and iftar

Today's prayer times for a place, with both Asr times and Ramadan suhoor and iftar. Answers 'is it halal?' for food, cosmetics, medicines, stocks, funds, crypto, money products and everyday life, showing where the four Sunni schools and the main scholarly bodies agree and where they differ, with the reasoning and halal alt...

Parameterslatloncitydatemethod

list_topics

Every question the rulebook covers

Every question the rulebook covers. Answers 'is it halal?' for food, cosmetics, medicines, stocks, funds, crypto, money products and everyday life, showing where the four Sunni schools and the main scholarly bodies agree and where they differ, with the reasoning and halal alt...

Parameterscategory

explain_schools

How the four schools differ on food

How the four schools differ on food. Answers 'is it halal?' for food, cosmetics, medicines, stocks, funds, crypto, money products and everyday life, showing where the four Sunni schools and the main scholarly bodies agree and where they differ, with the reasoning and halal alt...

Takes no parameters.

list_rules

The full rulebook

The full rulebook. Answers 'is it halal?' for food, cosmetics, medicines, stocks, funds, crypto, money products and everyday life, showing where the four Sunni schools and the main scholarly bodies agree and where they differ, with the reasoning and halal alt...

Takes no parameters.

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 Halal integrations