Port of esolat-mcp to Cloudflare Workers as a fully stateless MCP Streamable HTTP server.
No Docker. No Python. No server to manage. Runs on Cloudflare's global edge — free tier eligible.

• ✅ Full MCP Streamable HTTP protocol (JSON-RPC 2.0)
• ✅ Compatible with M365 Copilot, Claude.ai, and any MCP HTTP client
• ✅ Token-based auth in URL path (same pattern as Docker edition)
• ✅ Health dashboard endpoint
• ✅ All 3 original tools preserved:
  • get_monthly_prayer_times — JAKIM/e-Solat (Malaysia) or Aladhan (global)
  • find_nearest_mosques — e-Solat JAKIM (Malaysia) or OpenStreetMap (global)
  • get_yearly_islamic_events — JAKIM or Aladhan
• ✅ CORS headers for browser-based clients
• ✅ Batch JSON-RPC support

npm install -g wrangler
wrangler login

git clone <this-repo>
cd esolat-cfworker
npm install

wrangler secret put MCP_WEBHOOK_TOKEN
# Enter a strong random token when prompted
# e.g.: openssl rand -hex 32

npm run deploy

Your Worker will be live at:

https://esolat-mcp.<your-subdomain>.workers.dev

npm run dev
# Worker runs at http://localhost:8787

Test with curl:

# Initialize
curl -X POST http://localhost:8787/mcp/<TOKEN>/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

# List tools
curl -X POST http://localhost:8787/mcp/<TOKEN>/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# Get prayer times
curl -X POST http://localhost:8787/mcp/<TOKEN>/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_monthly_prayer_times","arguments":{"location_name":"Kajang"}}}'

Claude.ai / M365 Copilot
        │
        │  HTTPS POST (JSON-RPC 2.0)
        ▼
Cloudflare Workers Edge
  ┌─────────────────────────────┐
  │  Token auth (path-based)    │
  │  MCP protocol handler       │
  │  Tool dispatcher            │
  └─────────────────────────────┘
        │
        ├──► api.waktusolat.app  (Malaysia prayer times)
        ├──► e-solat.gov.my      (JAKIM mosque + events)
        ├──► api.aladhan.com     (Global fallback)
        └──► nominatim.osm.org   (Geocoding)

In Microsoft 365 Copilot Studio or Copilot extensibility settings:

1. Add a new MCP connector
2. Set the URL to:

   https://esolat-mcp.<your-subdomain>.workers.dev/mcp/<YOUR_TOKEN>/mcp
   

3. Transport: Streamable HTTP
4. No additional auth headers needed (token is in the path)

• e-solat JAKIM - For the official prayer times
• WaktuSolat.app - Prayer Time by GPS
• Model Context Protocol - For the MCP framework

This project is licensed under the MIT License.

This integration pulls data directly from the official e-Solat JAKIM (Department of Islamic Development Malaysia) portal. However, please note:

• No Liability: This integration is a community-driven project provided "as is" without any guarantees. The maintainer is not solely or legally responsible for any discrepancies, inaccuracies, delays, or omissions in prayer times or calendar dates.
• Verify Important Times: Users are strictly advised to regularly check and verify times against the official JAKIM eSolat Portal or official local announcements, especially for critical obligations (e.g., fasting, community prayers).
• Network & Upstream Dependencies: Synchronization depends on upstream API availability and local network connectivity. Discrepancies caused by unexpected server updates from JAKIM or local server downtime are outside the control of this software.

By using this tool, you acknowledge and agree that the developer holds no liability for missed schedules or data inaccuracies.