Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • GitHub MCP Server
  • Deriv API MCP Server
  • Phrases MCP Server
  • Xano MCP Server for Smithery
  • MCP Server for ArangoDB
Back to MCP Servers
Malaysia Prayer Time MCP Server

Malaysia Prayer Time MCP Server

Public
amanasmuei/mcp-server-malaysia-prayer-time

Provides accurate Malaysia Islamic prayer times via Model Context Protocol, supporting city, zone code, or coordinate queries with real-time schedules, current prayer status, and seamless integration with Claude Desktop.

python
0 tools
May 29, 2025
Updated Jun 4, 2025

Supercharge Your AI with Malaysia Prayer Time MCP Server

MCP Server

Unlock the full potential of Malaysia Prayer Time MCP Server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

Features • Installation • Configuration • Usage • API Reference • Troubleshooting • Contributing • License


Overview

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.

Features

✅ 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

Installation

Prerequisites

  • Python 3.10 or higher
  • Claude Desktop (latest version)
  • pip or uv package manager

Option 1: Installation from GitHub

# 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 .

Option 2: Using uv (Recommended)

# 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 .

Configuration

Configure Claude Desktop

  1. Create or edit the Claude Desktop configuration file:

macOS:

mkdir -p ~/Library/Application\ Support/Claude/ nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

mkdir -p %APPDATA%\Claude notepad %APPDATA%\Claude\claude_desktop_config.json
  1. Add the following configuration (adjust paths according to your setup):
{ "mcpServers": { "malaysia-prayer-time": { "command": "/absolute/path/to/your/.venv/bin/python", "args": [ "main.py" ], "cwd": "/absolute/path/to/mcp-server-malaysia-prayer-time" } } }
  1. Restart Claude Desktop completely

Usage

Once configured, you can interact with prayer times through Claude Desktop using natural language queries:

Examples

Get Prayer Times by City/Zone

  • "What are the prayer times for Kuala Lumpur today?"
  • "Show prayer times for Ipoh, Malaysia"
  • "Get prayer times for PRK02" (using zone code)

Get Prayer Times by Coordinates

  • "What are the prayer times at coordinates 3.1390, 101.6869?"
  • "Show prayer schedule for location 5.4141, 100.3288"

List Available Zones

  • "List all prayer time zones in Malaysia"
  • "Show me all available JAKIM zone codes"

API Reference

Available Tools

The MCP server exposes the following tools to Claude:

get_prayer_times

Retrieves 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_coordinates

Retrieves prayer times based on geographic coordinates.

Parameters:

  • latitude (float): Latitude coordinate
  • longitude (float): Longitude coordinate
  • date (string, default: "today"): Date in YYYY-MM-DD format or "today"

list_zones

Lists all available prayer time zones in Malaysia with their corresponding codes.

Prayer Time Information

The server provides these prayer times:

  • Imsak (pre-dawn meal time, if available)
  • Fajr (dawn prayer)
  • Syuruk/Sunrise
  • Dhuhr (noon prayer)
  • Asr (afternoon prayer)
  • Maghrib (sunset prayer)
  • Isha (night prayer)

Zone Coverage

The server currently supports all JAKIM zones in Malaysia. The coordinate-based lookup supports these major areas:

  • Kuala Lumpur/Selangor: SGR01-SGR04
  • Perak: PRK01-PRK04
  • Penang: PNG01
  • Johor: JHR01
  • Kedah: KDH01
  • Terengganu: TRG01
  • Kelantan: KTN01
  • Melaka: MLK01

Troubleshooting

Common Issues

Claude Cannot Connect to the Server

  1. Verify configuration paths are absolute and correct

  2. Check Claude logs:

    # macOS tail -f ~/Library/Logs/Claude/mcp*.log # Windows type %APPDATA%\Claude\Logs\mcp*.log
  3. Test the server directly:

    cd /path/to/mcp-server-malaysia-prayer-time python main.py

No Prayer Times Available

  1. Verify internet connectivity
  2. Check if the zone code is valid (use list_zones)
  3. The API may be temporarily unavailable - try again later

City Not Found

Try using a different spelling, a nearby major city, or the appropriate zone code

Contributing

Contributions are welcome! Here's how you can contribute:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add some amazing feature'
  4. Push to the branch: git push origin feature/amazing-feature
  5. Open a Pull Request

Development Setup

# 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 pytest

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • waktusolat.app - For providing the prayer time data API
  • Model Context Protocol - For the MCP framework
  • JAKIM - For the official prayer times
  • Claude Desktop - For the AI integration platform

Created by abdul rahman m asmuei amanasmuei@gmail.com

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • GitHub MCP Server
    GitHub MCP Server

    Enhance Claude Desktop with seamless GitHub integration via Model Context Protocol, enabling natural...

    Added May 30, 2025
  • Deriv API MCP Server
    Deriv API MCP Server

    Model Context Protocol server enabling seamless interaction with the Deriv API to retrieve active tr...

    2 tools
    Added May 30, 2025
  • Phrases MCP Server
    Phrases MCP Server

    Efficient MCP (Model Context Protocol) server for managing inspirational phrases with full CRUD capa...

    6 tools
    Added May 30, 2025
  • Xano MCP Server for Smithery
    Xano MCP Server for Smithery

    Model Context Protocol server enabling seamless integration between Claude AI and Xano databases wit...

    Added May 30, 2025
  • MCP Server for ArangoDB
    MCP Server for ArangoDB

    Model Context Protocol server enabling seamless interaction with ArangoDB through core database oper...

    7 tools
    Added May 30, 2025