Wasilah

What Wasilah MCP server does

Wasilah MCP server exposes Islamic reference data as callable MCP tools. It covers five daily prayers and sunrise, the next upcoming prayer, the direction of the Kaaba, Islamic calendar conversion, and full-surah Quran recitation links. The service is intended for questions such as prayer times for a city, the Qibla bearing from a location, or the Hijri date for a Gregorian date.

Prayer calculations use the same astronomy implementation as the Wasilah app. For matching location, date, calculation method, and Asr rule, the connector and app are designed to produce the same minute-level results. On Fridays, the prayer-time response labels Dhuhr as Jumu'ah.

How it works

Location-aware tools accept either a city name or explicit latitude, longitude, and timezone values. City names are resolved against a bundled offline database containing selected major cities and all national capitals. Coordinates are the fallback for locations absent from that database.

Prayer methods include options such as Karachi, ISNA, MWL, and Umm al-Qura. The Asr setting can be automatic, Shafi'i, or Hanafi. The default behavior follows the app's Karachi calculation method and Hanafi Asr setting. Qibla and prayer values are calculated on the server rather than retrieved from an external API.

Hijri conversion uses Umm al-Qura when supported by the runtime's ICU data. Otherwise, Wasilah uses a tabular calculation, which can differ by one day from a local moon-sighting announcement. Quran audio returns a streaming URL for a complete surah along with its name and ayah count.

Setup and configuration

Wasilah MCP server can run locally or as a Cloudflare Worker. For local development, install the npm dependencies, run the test suite, and start the development worker. The local MCP endpoint is available at /mcp on port 8787. MCP Inspector can connect to that endpoint for interactive tool testing.

Deployment uses Wrangler after authentication. The deployed connector URL is the Worker URL followed by /mcp. In Claude, add that address as a custom connector, then ask for a supported reference lookup. No sign-in, API key, or application-specific environment variable is required.

Tools and capabilities

• get_prayer_times returns the five obligatory prayers and sunrise for a city or coordinate set.
• get_next_prayer identifies the upcoming prayer and reports the remaining time.
• get_qibla calculates a compass bearing toward the Kaaba.
• get_hijri_date converts a supplied Gregorian date to an Islamic date.
• get_quran_audio supplies a full-surah recitation URL, surah name, and ayah count.

Limitations and notes

The Wasilah MCP server provides public reference data only. It is stateless, does not call external services, and does not access the Wasilah app's on-device Salah tracker. It also does not store personal information or expose user history; account and OAuth-backed features are outside its scope.

City resolution depends on the bundled database. Supplying coordinates directly is more reliable for smaller or unlisted places. Hijri results are calendar calculations rather than a substitute for an official local moon-sighting decision. The Quran audio capability returns a streaming link rather than audio content embedded in the MCP response.