← All agent tools

Calendar & time Islamic Network (AlAdhan)

AlAdhan Prayer Times API

Look up prayer schedules and Hijri dates for a location using ordinary HTTP requests.

Source review: 2026-10-16 · Imported: 1 November 2026

A practical starting point

What could you build?

Build a personal calendar helper that displays the next prayer time for a selected city.

Before you connect

Choose the appropriate calculation method and timezone. Local conventions can produce different times.

Capabilities & requirements

Dated specifications from the licensed source dataset. “Not published” indicates missing information, rather than confirmed absence.

AlAdhan Prayer Times API specifications
CapabilityDetails and source
StatusNot published

No GA/beta label on the API or terms pages.

Source (external) · Not published by vendor: checked 2026-10-17 on https://aladhan.com/prayer-times-api
API key requiredNo key

Test request returned HTTP 200 without a key.

Source (external) · Verified 2026-10-17 by test request to https://api.aladhan.com/v1/timingsByCity/17-10-2026?city=London&country=United%20Kingdom&method=15
Free tierFree

Described as a free REST API.

Source (external) · Verified 2026-10-17 on https://aladhan.com/prayer-times-api
Rate limit12 requests/s

ratelimit-limit and x-ratelimit-limit-second headers on the source publisher’s test request.

Source (external) · Verified 2026-10-17 by test request to https://api.aladhan.com/v1/timingsByCity/17-10-2026?city=London&country=United%20Kingdom&method=15
Official MCP serverNot published

No official MCP server is listed on the developer pages.

Source (external) · Not published by vendor: checked 2026-10-17 on https://aladhan.com/clients-api
Official SDKPHP, JavaScript

Two official SDKs listed on the API Clients page.

Source (external) · Verified 2026-10-17 on https://aladhan.com/clients-api
Data license / termsNot published

No data license is published; the terms provide the API as-is, without warranty.

Source (external) · Not published by vendor: checked 2026-10-17 on https://aladhan.com/credits-and-terms
Commercial use allowedNot published

The terms do not address commercial use.

Source (external) · Not published by vendor: checked 2026-10-17 on https://aladhan.com/credits-and-terms
CORS / browser useAccess-Control-Allow-Origin: *

Returned on a GET with a third-party Origin header.

Source (external) · Verified 2026-10-17 by test request to https://api.aladhan.com/v1/timingsByCity/17-10-2026?city=London&country=United%20Kingdom&method=15
Freshness / coverageComputed per request; any location

Any city or coordinates. Times are calculated with the Pray Times formulas.

Source (external) · Verified 2026-10-17 on https://aladhan.com/credits-and-terms

Operational reference

Additional facts and qualifications retained from AgentAPIList’s CC BY 4.0 dataset, with provider references.

Price

Free. AlAdhan describes itself as offering a free REST API.

Provider reference (external)

API key / auth

Not required. The source publisher’s test request ran without any key.

Provider reference (external)

Rate limit

12 requests per second, per the ratelimit-limit and x-ratelimit-limit-second headers on the source publisher’s test request.

Provider reference (external)

Terms

Use is subject to the credits, terms and conditions linked from aladhan.com. The service is operated by Mamluk LLC for Islamic Network.

Provider reference (external)

Calculation methods

Pick a method with method=<id>. The full list is served by the Calculation Methods API.

Provider reference (external)

Endpoint

GET https://api.aladhan.com/v1/timingsByCity/{DD-MM-YYYY}?city=…&country=…&method=…

Provider reference (external)

Setup references

HTTP request example

Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.

curl -sS "https://api.aladhan.com/v1/timingsByCity/16-10-2026?city=London&country=United%20Kingdom&method=15"
Agent connection example

Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.

// Agent tool definition (JSON Schema) — implement with HTTP GET
{
  "name": "aladhan_timings_by_city",
  "description": "Daily prayer times and Hijri date from AlAdhan. Free, no API key. Max 12 req/s.",
  "input_schema": {
    "type": "object",
    "properties": {
      "date": { "type": "string", "description": "DD-MM-YYYY" },
      "city": { "type": "string" },
      "country": { "type": "string" },
      "method": { "type": "integer", "description": "Calculation method id" }
    },
    "required": ["date", "city", "country"]
  }
}
// GET https://api.aladhan.com/v1/timingsByCity/{date}?city={city}&country={country}&method={method}

A tool schema needs an HTTP implementation; it does not by itself install an MCP server. Keep credentials out of browser code.

Other connections to explore

Back to the full directory →

Source & reuse

Download the complete licensed source snapshot (JSON), including the original source’s caveats, alternative notes and examples.