Wasilah MCP (Model Context Protocol) — Prayer Times, Qibla, Hijri, 99 Names, Quran Audio

A remote Model Context Protocol server that exposes Wasilah Islamic reference data to Claude as a custom connector. It supports English and Bengali, providing answers for prayer-time queries, Qibla, Hijri-date, 99 Names, and Quran audio, using Bangladesh offsets. It includes 9 tools.

🛠️ Key Features

Prayer times, Qibla, Hijri calendar, 99 Names, and Quran audio
English + Bengali responses
Prayer times computed with the same astronomy engine as the Wasilah app (ported from lib/features/prayer_times/prayer_astronomy.dart)
Tooling count: 9

🚀 Use Cases

Get prayer times for a location and date
Determine Qibla direction
Retrieve Hijri dates
Ask about the 99 Names
Request Quran audio

⚡ Developer Benefits

Uses an astronomy engine aligned with the Wasilah app to match results to the minute for the same location, date, method, and madhab
Access via MCP connector in Claude using the server URL

⚠️ Limitations

Tool documentation in the provided excerpt is incomplete (only the start of the get_prayer_times description is shown)

Wasilah MCP

A remote Model Context Protocol server that exposes Wasilah's Islamic reference data to Claude as a custom connector. Add the URL in Claude and it can answer prayer-time, Qibla, Hijri-date, and Quran-audio questions directly.

Prayer times are computed with the same astronomy engine as the Wasilah app (ported from lib/features/prayer_times/prayer_astronomy.dart), so the connector and the app agree to the minute for the same location, date, method, and madhab.

Tools

Tool	What it returns
`get_prayer_times`	The five daily prayers plus sunrise for a city or coordinates. Marks Dhuhr as Jumu'ah on Fridays.
`get_next_prayer`	The next upcoming prayer and time remaining.
`get_qibla`	Compass bearing to the Kaaba.
`get_hijri_date`	Islamic date for a given Gregorian date (Umm al-Qura, with a tabular fallback).
`get_quran_audio`	A streaming full-surah recitation URL plus surah name and ayah count.

Every location tool accepts either a city name (resolved against a bundled offline database) or explicit latitude + longitude + timezone. Prayer tools also accept method (Karachi, ISNA, MWL, Umm al-Qura, and others) and asr (auto, shafii, hanafi). The connector makes no external network calls.

Run locally

bash

npm install
npm test        # exercises every tool through the MCP endpoint, no server needed
npm run dev     # serves the worker on http://localhost:8787

With the dev server running, point the MCP Inspector at http://localhost:8787/mcp to browse and call the tools interactively.

Deploy (Cloudflare Workers)

bash

npx wrangler login
npm run deploy

Wrangler prints the deployed URL, for example https://wasilah-mcp.<subdomain>.workers.dev. The connector endpoint is that URL plus /mcp. Visiting the root URL serves a short landing page with the connector URL and setup steps.

Add to Claude

Settings, then Connectors.
Add custom connector.
Paste https://<your-worker-url>/mcp.
Ask something like "What time is Maghrib in Dhaka today?" or "Which way is the Qibla from Madinah?"

This server is authless and stateless. It exposes only public reference data; it holds no personal information and needs no sign-in.

Notes

Prayer parity. Calculation-method angles, the Asr shadow factors, and the solar geometry mirror the app exactly. The app's default is Karachi method with Hanafi Asr.
Hijri source. Uses the Umm al-Qura calendar where the runtime's ICU supports it, and a tabular calculation otherwise. A tabular date can differ from a moon-sighting announcement by a day.
Fully offline. The connector makes no external API calls. City lookups use a bundled offline database (a subset of GeoNames, CC BY 4.0: top cities per country plus every capital); prayer times, Qibla, and Hijri date are computed on the server. Pass coordinates directly for places not in the database.
Personal data is out of scope. This server does not touch the on-device Salah tracker. Exposing per-user history would require a Wasilah backend with accounts and OAuth.

city	string	optional	City name to resolve, e.g. "Dhaka" or "Madinah". Ignored when latitude and longitude are given.
latitude	number	optional	Latitude in degrees, north positive.
longitude	number	optional	Longitude in degrees, east positive.
timezone	string	optional	IANA timezone, e.g. "Asia/Dhaka". Used with explicit latitude/longitude. If omitted, the zone is inferred from the nearest known city and reported in the answer.
date	string	optional	Date as YYYY-MM-DD. Defaults to today in the location’s timezone.
method	string	optional	Calculation method. Defaults to "karachi" (the app default).
asr	string	optional	Asr juristic method. "auto" follows the calculation method’s regional default.
offset_minutes	object	optional	Optional per-prayer adjustment in whole minutes, matching the offset settings in the Wasilah app, e.g. {"maghrib": 3}. Applies to the five obligatory prayers only; Sunrise is never offset. These are the user's own adjustments, not a calculation method.

city	string	optional	City name to resolve, e.g. "Dhaka" or "Madinah". Ignored when latitude and longitude are given.
latitude	number	optional	Latitude in degrees, north positive.
longitude	number	optional	Longitude in degrees, east positive.
timezone	string	optional	IANA timezone, e.g. "Asia/Dhaka". Used with explicit latitude/longitude. If omitted, the zone is inferred from the nearest known city and reported in the answer.
method	string	optional
asr	string	optional
offset_minutes	object	optional	Optional per-prayer adjustment in whole minutes, matching the offset settings in the Wasilah app, e.g. {"maghrib": 3}. Applies to the five obligatory prayers only; Sunrise is never offset. These are the user's own adjustments, not a calculation method.

city	string	optional	City name to resolve, e.g. "Dhaka" or "Madinah". Ignored when latitude and longitude are given.
latitude	number	optional	Latitude in degrees, north positive.
longitude	number	optional	Longitude in degrees, east positive.
timezone	string	optional	IANA timezone, e.g. "Asia/Dhaka". Used with explicit latitude/longitude. If omitted, the zone is inferred from the nearest known city and reported in the answer.

year	integer	optional	Hijri year, e.g. 1448.
month	integer	optional	Hijri month number, 1 = Muharram.
date	string	optional	Gregorian date YYYY-MM-DD; returns the Hijri month containing it. Defaults to today.
method	string	optional	umm_al_qura (default, the Saudi civil calendar) or tabular (Kuwaiti arithmetic).
language	string	optional	Language for significant-day notes. Defaults to en.

number	integer	optional	Name number, 1 to 99.
search	string	optional	Match against transliteration, English meaning, Bengali or Arabic.

Wasilah

Wasilah MCP (Model Context Protocol) — Prayer Times, Qibla, Hijri, 99 Names, Quran Audio

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_prayer_times

get_next_prayer

get_qibla

get_hijri_date

get_ifb_district_offset

get_hijri_calendar

get_asma_ul_husna

get_tasbeeh

get_quran_audio

Wasilah MCP

Tools

Run locally

Deploy (Cloudflare Workers)

Add to Claude

Notes

Install

Remote endpoint

Related servers

dhikr	string	optional	Phrase to look up, by transliteration, meaning or Arabic, e.g. "SubhanAllah", "forgiveness" or "أستغفر".
language	string	optional	Language for meanings and notes. Defaults to en.

surah	integer	required	Surah number, 1 to 114.
reciter	string	optional	Reciter edition. Defaults to "ar.alafasy" (Mishary Rashid Alafasy). Only ar.alafasy, ar.abdulbasitmurattal and ar.abdullahbasfar have single-file surah audio; the others are per-ayah.