trackmcp
Back to directory
yusufk

salaah-mcp

View on GitHub

A FastAPI and MCP service providing Islamic prayer times calculations

3 stars PythonOthers Updated May 7, 2026
mcp-serverprayer-times

Documentation

Salaah MCP (Muslim Community Prayer Times)

A FastAPI and MCP service providing Islamic prayer times calculations using the islamic_times library.

Screenshot

Dependencies

This project relies on the following main dependencies:

  • FastAPI: Web framework for building APIs
  • FastAPI MCP: Model Control Protocol
  • islamic_times: Core calculation engine for prayer times
  • Pydantic: Data validation

Installation

1. Clone the repository:

bash
git clone https://github.com/yourusername/salaah-mcp.git
cd salaah-mcp

2. Install uvv and dependencies:

bash
pip install uv
uv install

Usage

bash
uv run run.py

The API will be available at:

  • Development: http://localhost:8000
  • Production: http://localhost:8000 (configurable via UVV_PORT environment variable)

API Endpoints

Calculate Prayer Times

`POST /prayer_times`

Calculate prayer times for a given location and date.

Example request:

json
{
  "latitude": -26.1528113,
  "longitude": 28.0049996,
  "method": "EGYPTIAN"
}

Example response:

json
{
  "method": "Egyptian General Authority of Survey (Egypt)",
  "fajr": "2025-06-01T05:19:11.373053+02:00",
  "sunrise": "2025-06-01T06:47:44.369263+02:00",
  "zuhr": "2025-06-01T12:05:43.358460+02:00",
  "asr": "2025-06-01T15:23:52.560113+02:00",
  "sunset": "2025-06-01T17:23:52.560113+02:00",
  "maghrib": "2025-06-01T17:23:52.560113+02:00",
  "isha": "2025-06-01T18:43:09.341111+02:00",
  "midnight": "2025-06-02T00:06:02.228763+02:00"
}

Get Qiblah Direction

`POST /qiblah`

Get Qiblah direction and distance from any location.

json
{
  "latitude": -26.1528113,
  "longitude": 28.0049996,
  "date": "2025-06-01T00:00:00Z"
}

Example response:

json
{
  "distance_km": 5452,
  "distance_mi": 3388,
  "direction": "NNE",
  "angle_decimal": 14.647,
  "angle_dms": "014° 38′ 49.84″"
}

Get Sun Information

`POST /sun`

Get detailed sun position and timing information.

Example response:

json
{
  "sunrise": "2025-06-01T06:47:40",
  "transit": "2025-06-01T12:05:33",
  "sunset": "2025-06-01T17:23:36",
  "apparent_altitude": -42.659,
  "apparent_azimuth": 276.796,
  "distance_au": 1.014106,
  "apparent_declination": 22.166,
  "apparent_right_ascension": "04h 39m 56.17s",
  "greenwich_hour_angle": 99.904,
  "local_hour_angle": 127.951
}

Get Moon Information

`POST /moon`

Get detailed moon position and phase information.

Example response:

json
{
  "moonrise": "2025-06-01T11:39:22",
  "transit": "2025-06-01T16:25:15",
  "moonset": "2025-06-01T22:54:19",
  "illumination": 36.38,
  "apparent_altitude": 25.803,
  "azimuth": 305.203,
  "distance_km": 388391,
  "parallax": 0.941,
  "topocentric_declination": 15.892,
  "topocentric_right_ascension": "09h 52m 04.77s",
  "greenwich_hour_angle": 21.198,
  "local_hour_angle": 49.245
}

Calculate Moon Visibility

`POST /moon/visibility`

Calculate new moon visibility using Yallop's criterion.

json
{
  "latitude": -26.1528113,
  "longitude": 28.0049996,
  "date": "2025-05-27T00:00:00Z",
  "days": 3,
  "criterion": 1
}

Example response:

json
[
  {
    "criterion": "Yallop",
    "date": "2025-05-27T15:28:52",
    "value": -0.788,
    "description": "F: Not visible; below the Danjon limit."
  },
  {
    "criterion": "Yallop",
    "date": "2025-05-28T15:56:44",
    "value": 0.958,
    "description": "A: Easily visible."
  }
]

Available Calculation Methods

  • ISNA: Islamic Society of North America
  • MWL: Muslim World League
  • UMM_AL_QURA: Umm al-Qura University, Makkah
  • EGYPTIAN: Egyptian General Authority of Survey
  • KARACHI: University of Islamic Sciences, Karachi
  • TEHRAN: Institute of Geophysics, University of Tehran
  • JAFARI: Shia Ithna Ashari, Leva Research Institute, Qom

Claude Desktop Integration

To use the prayer times service with Claude Desktop:

1. Create a configuration file:

json
{
  "mcpServers": {
    "Salaah Times": {
      "command": "/Users/yusuf/.local/bin/mcp-proxy",
      "env": {
        "SSE_URL": "http://localhost:8000/mcp"
      }
    }
  }
}

2. Save this as `claude_desktop_config.json` in your Claude Desktop configuration directory.

3. Make sure the MCP service is running:

bash
uv run run.py

4. Start Claude Desktop and you can now ask questions about prayer times like:

  • "What time is Asr prayer today?"
  • "When is Fajr tomorrow in Johannesburg?"
  • "Show me all prayer times for London"

The AI will use the MCP service to calculate accurate prayer times based on your queries.

Frequently asked questions

What is salaah-mcp?

salaah-mcp is A FastAPI and MCP service providing Islamic prayer times calculations

How do I install salaah-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is salaah-mcp open source?

Yes — it is hosted on GitHub at https://github.com/yusufk/salaah-mcp and has 3 stars.

Related MCP tools

MinishLabsemble

Fast and Accurate Code Search for Agents. Uses 99% fewer tokens than grep+read

5,993 Python
agentscode-searchembeddings+4
JerBoumaFinanceToolkit

Transparent and Efficient Financial Analysis

5,288 Python
financial-statementsstock-datafundamental-analysis+17
atilaahmettanertradingview-mcp

TradingView MCP server — real-time market data, technical analysis, screeners & backtesting for Claude, ChatGPT, Cursor & any MCP client. Stocks, crypto, forex & futures across global exchanges. Hosted or self-host.

4,351 Python
claude-desktopcryptocurrencymcp-server+10
mutonbyopenshorts

Open source AI clip generator: turns long videos into viral 9:16 shorts with AI moment detection, face tracking, subtitles and dubbing. Self-host free with Docker (MIT), or use the cloud with GPU speed from $12/mo. MCP server and API for AI agents.

3,851 Python
clip-generatoropen-sourceshorts+10
taylorwilsdongoogle_workspace_mcp

Control Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Search & Drive with AI - Comprehensive Google Workspace MCP Server & CLI Tool

3,117 Python
aigmailgoogle-calendar+17
jgravellejcodemunch-mcp

Cut AI token costs 95%+ on code exploration. The leading MCP server for precise, symbol-level GitHub code retrieval via tree-sitter AST. Works with Claude Code, Cursor & any MCP client. 313B+ tokens saved.

2,651 Python
claudeclaude-codeai-coding+17

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP