
A Model Context Protocol (MCP) server for Malaysia Prayer Time data
A Model Context Protocol (MCP) server for Malaysia Prayer Time data
·
Features • Installation • Configuration • Usage • API Reference • Troubleshooting • Contributing • License
Malaysia Prayer Time MCP Server provides accurate Islamic prayer times for locations throughout Malaysia. This server implements the Model Context Protocol (MCP) to seamlessly integrate with Claude Desktop, delivering real-time prayer schedules directly through your AI assistant.
The server utilizes the waktusolat.app API to retrieve JAKIM-verified prayer times and supports searching by city, zone code, or coordinates.
✅ Location-Based Times: Get prayer times for any city or district in Malaysia
✅ Coordinate Support: Find prayer times using latitude and longitude coordinates
✅ Zone Code Access: Directly query using JAKIM zone codes (e.g., SGR03 for Kuala Lumpur)
✅ Complete Prayer Schedule: Retrieve all daily prayer times (Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha)
✅ Current Prayer Status: Determine the current and next prayer times
✅ Robust Error Handling: Graceful handling of network issues and API changes
✅ Seamless Claude Integration: Clean integration with Claude Desktop via MCP
pip or uv package manager# Clone the repository
git clone https://github.com/yourusername/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 .# Clone the repository
git clone https://github.com/yourusername/mcp-server-malaysia-prayer-time.git
cd mcp-server-malaysia-prayer-time
# Create and activate a virtual environment using uv
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
# Install dependencies
uv pip install -e .macOS:
mkdir -p ~/Library/Application\ Support/Claude/
nano ~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows:
mkdir -p %APPDATA%\Claude
notepad %APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"malaysia-prayer-time": {
"command": "/absolute/path/to/your/.venv/bin/python",
"args": [
"main.py"
],
"cwd": "/absolute/path/to/mcp-server-malaysia-prayer-time"
}
}
}Once configured, you can interact with prayer times through Claude Desktop using natural language queries:
The MCP server exposes the following tools to Claude:
get_prayer_timesRetrieves prayer times for a specific city or zone code in Malaysia.
Parameters:
city (string, default: "kuala lumpur"): City name or zone code (e.g., "SGR03")country (string, default: "malaysia"): Currently only supports "malaysia"date (string, default: "today"): Date in YYYY-MM-DD format or "today"get_prayer_times_by_coordinatesRetrieves prayer times based on geographic coordinates.
Parameters:
latitude (float): Latitude coordinatelongitude (float): Longitude coordinatedate (string, default: "today"): Date in YYYY-MM-DD format or "today"list_zonesLists all available prayer time zones in Malaysia with their corresponding codes.
The server provides these prayer times:
The server currently supports all JAKIM zones in Malaysia. The coordinate-based lookup supports these major areas:
Verify configuration paths are absolute and correct
Check Claude logs:
# macOS
tail -f ~/Library/Logs/Claude/mcp*.log
# Windows
type %APPDATA%\Claude\Logs\mcp*.logTest the server directly:
cd /path/to/mcp-server-malaysia-prayer-time
python main.pylist_zones)Try using a different spelling, a nearby major city, or the appropriate zone code
Contributions are welcome! Here's how you can contribute:
git checkout -b feature/amazing-featuregit commit -m 'Add some amazing feature'git push origin feature/amazing-feature# Clone your fork
git clone https://github.com/yourusername/mcp-server-malaysia-prayer-time.git
cd mcp-server-malaysia-prayer-time
# Set up development environment
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]" # Installs dev dependencies
# Run tests
pytestThis project is licensed under the MIT License - see the LICENSE file for details.
Created by abdul rahman m asmuei
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add malaysia-prayer-time -- /absolute/path/to/your/.venv/bin/python main.py{
"mcpServers": {
"malaysia-prayer-time": {
"args": [
"main.py"
],
"command": "/absolute/path/to/your/.venv/bin/python"
}
}
}code --add-mcp '{"name":"malaysia-prayer-time","args":["main.py"],"command":"/absolute/path/to/your/.venv/bin/python"}'[mcp_servers.malaysia-prayer-time]
command = "/absolute/path/to/your/.venv/bin/python"
args = ["main.py"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/clone-the-repository to learn what the "Clone the repository" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
This server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/clone-the-repository)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "clone-the-repository" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.