home / mcp / ezanvakti mcp server

EzanVakti MCP Server

Provides access to monthly and today’s Islamic prayer times via MCP using the EzanVakti API.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "hkilimci-ezanvakti.mcp.server": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "/path/to/EzanVakti.MCP.Server.csproj"
      ]
    }
  }
}

You have a Model Context Protocol (MCP) server that provides access to Islamic prayer times from the EzanVakti API. It exposes a set of endpoints for listing countries, finding cities and districts, retrieving monthly prayer schedules, and getting today’s prayer times, making it easy to integrate accurate prayer data into your applications or assistants.

How to use

Use an MCP client to connect to the EzanVakti MCP Server. The server exposes tools to fetch country lists, city and district data, monthly prayer times for a district, and today’s prayer times. You can also search for a city and receive its associated prayer times. When you ask for prayer times, you typically provide a district (or city) and receive a structured schedule with Hijri and Gregorian dates and the six daily prayers (Imsak, Gunes, Ogle, Ikindi, Aksam, Yatsi) along with Qibla time and sunrise/sunset.

Typical usage patterns include: - Listing all countries to determine which region you can query - Selecting a country to view its cities - Choosing a city to view its districts and then requesting a monthly prayer timetable for a district - Performing a smart search to locate a city and fetch its prayer times in one step - Requesting today’s prayer times for a given district to display current day schedules in your app.

How to install

Prerequisites you need before installing the MCP server:

- .NET 8.0 SDK or later

- A compatible MCP client (for example a code editor or tool that supports MCP) so you can connect and send queries.

# Install and build the MCP server locally
# 1) Restore dependencies
dotnet restore

# 2) Build the project
dotnet build

Running the server

For development you can run the server directly from your development environment.

dotnet run

Available tools

GetCountries

Lists all countries available in the EzanVakti database.

GetCities

Retrieves cities/provinces for a specific country by countryId.

GetDistricts

Retrieves districts within a specific city by cityId.

GetPrayerTimes

Fetches the full monthly prayer schedule for a district by districtId.

SearchCityPrayerTimes

Searches for a city by name and returns its prayer times, optionally filtered by country.

GetTodayPrayerTimes

Gets today’s prayer times for a specified district.