MCP Server

Halal or Not

io.github.GoodTurnStudio/halalornot
Finance & Investing Knowledge & Documentation Public & reachable MCP 2026-07-28

What this MCP does

Provides Islamic-law assessments for food, medicine, financial products, crypto, stocks, funds, and everyday practices across four Sunni schools.

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.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': "The question in plain words, for example 'Is a credit card halal?'"}}, 'additionalProperties': False}
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.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['coin'], 'properties': {'coin': {'type': 'string', 'description': 'Coin name or symbol, for example bitcoin, ETH, AAVE.'}}, 'additionalProperties': False}
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.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'Fund or ETF ticker (VOO, QQQ, SPUS) or a Shariah fund name.'}}, 'additionalProperties': False}
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.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['ingredients'], 'properties': {'context': {'enum': ['food', 'cosmetic', 'medicine'], 'type': 'string', 'default': 'food', 'description': "'cosmetic' for products used on the skin, 'medicine' for medicines and supplements; these change how alcohol, carmine and necessity are treated."}, 'ingredients': {'type': 'string', 'description': 'Ingredients list as printed, comma separated.'}}, 'additionalProperties': False}
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)
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'Brand or generic name.'}}, 'additionalProperties': False}
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.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['barcode'], 'properties': {'barcode': {'type': 'string', 'description': 'EAN-13, EAN-8 or UPC barcode digits.'}}, 'additionalProperties': False}
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.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'The ingredient or E-number, for example E471, carmine, gelatin or alcohol denat.'}, 'context': {'enum': ['food', 'cosmetic'], 'type': 'string', 'description': 'Whether the ingredient is in food or a cosmetic. Defaults to food.'}}, 'additionalProperties': False}
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...
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
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...
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'lat': {'type': 'number', 'description': 'Latitude of the place, in decimal degrees. Goes with lon instead of city.'}, 'lon': {'type': 'number', 'description': 'Longitude of the place, in decimal degrees. Goes with lat instead of city.'}, 'city': {'type': 'string', 'description': 'City name, for example London or Chicago, IL.'}, 'date': {'type': 'string', 'format': 'date', 'description': 'The day, YYYY-MM-DD. Defaults to today.'}, 'method': {'enum': ['isna', 'mwl', 'umm_al_qura', 'egypt', 'karachi', 'moonsighting'], 'type': 'string', 'description': 'Calculation method: isna (North America), mwl (Muslim World League), umm_al_qura, egypt, karachi or moonsighting.'}}, 'additionalProperties': False}
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...
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
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...
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'category': {'enum': ['money', 'crypto', 'medicine', 'food', 'life'], 'type': 'string', 'description': 'Only topics in this area: money, crypto, medicine, food or life.'}}, 'additionalProperties': False}
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.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'A US stock ticker, for example AAPL or TSLA.'}}, 'additionalProperties': False}
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.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'A product, brand or barcode to look up, for example Haribo Starmix or 5000159484695.'}, 'country': {'type': 'string', 'default': 'united-kingdom', 'description': "Open Food Facts country slug, for example united-kingdom, united-states, france. 'world' means no filter. Also picks the Amazon store for halal versions (amazon.co.uk for the UK and Ireland)."}}, 'additionalProperties': False}
Changed
list_rules
Oct. 1, 2026, 2:40 a.m.
Changed
explain_schools
Oct. 1, 2026, 2:40 a.m.
Changed
list_topics
Oct. 1, 2026, 2:40 a.m.
Changed
get_prayer_times
Oct. 1, 2026, 2:40 a.m.
Changed
check_medicine
Oct. 1, 2026, 2:40 a.m.
Changed
check_crypto
Oct. 1, 2026, 2:40 a.m.
Changed
check_fund
Oct. 1, 2026, 2:40 a.m.
Changed
ask_is_it_halal
Oct. 1, 2026, 2:40 a.m.
Changed
screen_stock
Oct. 1, 2026, 2:40 a.m.
Changed
explain_ingredient
Oct. 1, 2026, 2:40 a.m.
Changed
search_products
Oct. 1, 2026, 2:40 a.m.
Changed
check_product_by_barcode
Oct. 1, 2026, 2:40 a.m.
Changed
check_ingredients
Oct. 1, 2026, 2:40 a.m.
Added
list_rules
Sept. 29, 2026, 2:40 a.m.
Added
explain_schools
Sept. 29, 2026, 2:40 a.m.
Added
list_topics
Sept. 29, 2026, 2:40 a.m.
Added
get_prayer_times
Sept. 29, 2026, 2:40 a.m.
Added
check_medicine
Sept. 29, 2026, 2:40 a.m.
Added
check_crypto
Sept. 29, 2026, 2:40 a.m.
Added
check_fund
Sept. 29, 2026, 2:40 a.m.
Added
ask_is_it_halal
Sept. 29, 2026, 2:40 a.m.
Added
screen_stock
Sept. 29, 2026, 2:40 a.m.
Added
explain_ingredient
Sept. 29, 2026, 2:40 a.m.
Added
search_products
Sept. 29, 2026, 2:40 a.m.
Added
check_product_by_barcode
Sept. 29, 2026, 2:40 a.m.
Added
check_ingredients
Sept. 29, 2026, 2:40 a.m.