Salaah MCP

★ 3

from yusufk

FastAPI and MCP service providing Islamic prayer times and other useful calculations.

🔥🔥✓ VerifiedFreeAdvanced setup

⌁ labsco summary — our analysis, not the vendor's

What it is — a FastAPI + MCP service that calculates Islamic prayer times and related astronomical data using the islamic_times library.

What you get —

Prayer-time calculation for a location and date — e.g. "give me today's prayer times for Johannesburg using the Egyptian method"
Qiblah direction and distance from any coordinates
Detailed sun information (rise, transit, set, altitude, azimuth)
Moon position and phase/illumination data

Requirements — no API key or account; an SSE_URL env var configures the transport. Python with uv.

Cost snapshot — free (no license stated in the metadata); built on the open-source islamic_times engine, no paid service.

Setup effort — self-host: clone, pip install uv, uv install, and uv run run.py; API serves on localhost:8000.

Our take — A solid, self-contained option for Muslim prayer-time and astronomy calculations without external dependencies. Caveat: the repo ships as a self-hosted FastAPI service with no license field set in the metadata, so confirm licensing before redistribution.

Source: the project README — summarized 2026-07-08.

⌁ readme from github — mirrored (latest on GitHub ↗)

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

API Endpoints

Calculate Prayer Times

POST /prayer_times

Calculate prayer times for a given location and date.

Example request:

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

Example response:

{
  "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.

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

Example response:

{
  "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:

{
  "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:

{
  "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.

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

Example response:

[
  {
    "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:

Create a configuration file:

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

Save this as claude_desktop_config.json in your Claude Desktop configuration directory.
Make sure the MCP service is running:

uv run run.py

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.

Copy & paste — that's it

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

Before it works, you'll need: SSE_URL

Installation

Clone the repository:

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

Install uvv and dependencies:

pip install uv
uv install

Usage

uv run run.py

The API will be available at:

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