{
  "markdown": "# Wasilah MCP\n\nA remote [Model Context Protocol](https://modelcontextprotocol.io) 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.\n\nPrayer 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.\n\n## Tools\n\n| Tool | What it returns |\n| --- | --- |\n| `get_prayer_times` | The five daily prayers plus sunrise for a city or coordinates. Marks Dhuhr as Jumu'ah on Fridays. |\n| `get_next_prayer` | The next upcoming prayer and time remaining. |\n| `get_qibla` | Compass bearing to the Kaaba. |\n| `get_hijri_date` | Islamic date for a given Gregorian date (Umm al-Qura, with a tabular fallback). |\n| `get_quran_audio` | A streaming full-surah recitation URL plus surah name and ayah count. |\n\nEvery 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.\n\n## Run locally\n\n```bash\nnpm install\nnpm test        # exercises every tool through the MCP endpoint, no server needed\nnpm run dev     # serves the worker on http://localhost:8787\n```\n\nWith the dev server running, point the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) at `http://localhost:8787/mcp` to browse and call the tools interactively.\n\n## Deploy (Cloudflare Workers)\n\n```bash\nnpx wrangler login\nnpm run deploy\n```\n\nWrangler 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.\n\n## Add to Claude\n\n1. Settings, then Connectors.\n2. Add custom connector.\n3. Paste `https://<your-worker-url>/mcp`.\n4. Ask something like \"What time is Maghrib in Dhaka today?\" or \"Which way is the Qibla from Madinah?\"\n\nThis server is authless and stateless. It exposes only public reference data; it holds no personal information and needs no sign-in.\n\n## Notes\n\n- **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.\n- **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.\n- **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.\n- **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.\n",
  "bytes": 3214,
  "sha": "165e9cde71180d040915e5839371d8b03bbe0dffd8b70106df9e7fa98024096e",
  "repo_slug": "mumullickm/wasilah-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mumullickm_wasilah_mcp_5b9a4615/readme"
}