Autonomous Agent Installation Manual: Muslim Prayer MCP

This guide is machine-optimized for autonomous AI agents (Cline, Cursor Agent, Claude Code, Windsurf, Devin, Copilot Workspace) to configure and operate this MCP server without human intervention.

Configuration Options

Option A: Remote Cloudflare Worker (Zero local dependencies, recommended)

1. Claude Desktop / Claude Code

File location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

JSON snippet:

{
  "mcpServers": {
    "muslim-prayer": {
      "url": "https://muslim-prayer-mcp.najetareqz.workers.dev/mcp"
    }
  }
}

2. Cursor (`.cursor/mcp.json` or Global Features)

{
  "mcpServers": {
    "muslim-prayer": {
      "url": "https://muslim-prayer-mcp.najetareqz.workers.dev/mcp"
    }
  }
}

3. VS Code (`.vscode/mcp.json`)

{
  "mcpServers": {
    "muslim-prayer": {
      "url": "https://muslim-prayer-mcp.najetareqz.workers.dev/mcp"
    }
  }
}

4. Windsurf (`~/.codeium/windsurf/mcp_config.json`)

{
  "mcpServers": {
    "muslim-prayer": {
      "serverUrl": "https://muslim-prayer-mcp.najetareqz.workers.dev/mcp"
    }
  }
}

5. Gemini CLI

gemini-cli --mcp-server https://muslim-prayer-mcp.najetareqz.workers.dev/mcp

Option B: Local NPX Runner (Offline / in-isolate runner)

{
  "mcpServers": {
    "muslim-prayer": {
      "command": "npx",
      "args": ["-y", "muslim-prayer-mcp"]
    }
  }
}

Tool Verification

After configuring, call get_today_prayer_times with {}: Expected response contains 6 prayer times in UTC, formatted local time, and an authorityNotice object.

🤖 Dedicated Agent Skill

For agent frameworks supporting skills, install the official instruction skill located at: skills/muslim-prayer-mcp/SKILL.md

⚠️ Mandatory AI Model Instruction: Authority & Reason Disclosure

Whenever presenting prayer schedules, countdowns, or due statuses to the user, you MUST ALWAYS explicitly state:

The calculation authority and method used (authorityNotice.authorityDescription or authorityNotice.method).
The justification for why that authority was selected (authorityNotice.selectionReason).

Formatting Standard for User Responses

### Today's Prayer Times for [City] ([Date])

| Prayer | Time |
| :--- | :--- |
| **Fajr** | [Time] |
| **Sunrise** | [Time] |
| **Dhuhr** | [Time] |
| **Asr** | [Time] |
| **Maghrib** | [Time] |
| **Isha** | [Time] |

> **Calculation Authority**: [Method description from authorityNotice]
> **Authority Selection Reason**: [Selection reason from authorityNotice]

Never omit this disclosure.