get_prayer_timesLABSCO SUMMARY
Zone code beats city name when the name is ambiguous.
The data is the official JAKIM set through waktusolat.app, so the value here is purely in the asking: plain language in, the right zone resolved, the current and next prayer out. When a city name does not resolve, list the zones and use the code — that is the documented way through, not a workaround.
What it is
A Python MCP server over the waktusolat.app API, which serves JAKIM-verified prayer times for Malaysia. It resolves a city name, a zone code or a latitude and longitude to the right zone and returns that day's schedule.
What you get
get_prayer_times— by city name or zone code, for today or a given dateget_prayer_times_by_coordinates— by latitude and longitude, for today or a given datelist_zones— every available zone with its code, which is how you resolve an ambiguous place name- The full daily set: Imsak where available, Fajr, Syuruk, Dhuhr, Asr, Maghrib and Isha
- Current and next prayer, so the answer is what you asked rather than a table to read
- Coverage of all JAKIM zones, with coordinate lookup mapped across the major areas
Requirements
Python 3.10 or higher, and a clone installed with pip or uv into a virtual environment. The client config points at that environment's Python, the main script and the project directory as the working directory — absolute paths, or the client will not start it. Restart the client fully after editing the config. An internet connection is needed, since times come from the upstream API. MIT licensed.
Setup effort
Build from source — git clone https://github.com/amanasmuei/mcp-server-malaysia-prayer-time.git
USE CASES
01
Asking for today's times where you are
Name the city and get the full schedule with the current and next prayer already worked out.
02
Getting times for a place with no obvious name
Pass the coordinates instead and let it resolve the zone for you.
03
Pinning down the right zone once
List the zones, find the code for the district you mean, and use that code from then on.
3 tools
Listed in project docs. Your client may show a different list.
get_prayer_times_by_coordinateslist_zonesBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation.
Requires
Python 3.10 or later
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
# Clone the repository
git clone https://github.com/amanasmuei/mcp-server-malaysia-prayer-time.git
cd mcp-server-malaysia-prayer-time
# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
# Install dependencies
pip install -e .MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"malaysia-prayer-time": {
"command": "<YOUR_PATH_TO_VENV>/bin/python",
"args": [
"main.py"
],
"cwd": "<YOUR_PATH_TO_MCP_SERVER_MALAYSIA_PRAYER>"
}
}
}
