Waktu Solat MCP

MCP server for Malaysian prayer times via api.waktusolat.app. Works with Claude, Cursor, and other MCP clients.

Tools: get_prayer_times_today, get_prayer_times_month, get_next_prayer, list_zones

Zone codes (important)

Prayer tools require a JAKIM zone code (for example: WLY01, SGR01, JHR01).

If you are unsure which code to use, run:

• list_zones() to see all zones
• list_zones("SGR") to filter by state code (examples: SGR, JHR, WLY)

Example prompts in Claude/Cursor:

• "List all Selangor zones"
• "Get today's prayer times for WLY01"
• "What's the next prayer for SGR01?"

Local (stdio)

uv sync
uv run waktusolat-mcp

Claude Desktop config:

{
  "mcpServers": {
    "waktusolat": {
      "command": "uv",
      "args": ["--directory", "/path/to/waktu-solat-mcp", "run", "waktusolat-mcp"]
    }
  }
}

Claude Code (local stdio server):

claude mcp add --transport stdio waktusolat -- \
  uv --directory /path/to/waktu-solat-mcp run waktusolat-mcp

Verify in Claude Code:

claude mcp list
claude mcp get waktusolat

After connecting, try:

• "When is Maghrib in WLY01 today?"
• "Show me prayer times this month for SGR01"

Hosted (HTTP)

Public deployment (Railway):

• Web UI: https://web-production-99037.up.railway.app/
• MCP endpoint: https://web-production-99037.up.railway.app/mcp

Run with HTTP transport to serve a web UI with "Add to Cursor" / "Add to Claude" buttons:

uv run waktusolat-mcp-http

Or: MCP_TRANSPORT=streamable-http uv run waktusolat-mcp

• Web UI: http://localhost:8000/
• MCP endpoint: http://localhost:8000/mcp

Claude Code (remote HTTP server):

claude mcp add --transport http waktusolat https://web-production-99037.up.railway.app/mcp

Then run /mcp inside Claude Code to check connection/auth status.

Deploy to Railway, Render, etc. Set PORT (PaaS usually provides this). The app binds to 0.0.0.0 and uses PORT automatically. If behind a proxy, set MCP_BASE_URL to your public URL (for example this app uses https://web-production-99037.up.railway.app) so install links use the correct URL.

Docker

docker compose up --build
# Web UI: http://localhost:8000/
# MCP: http://localhost:8000/mcp