kasra-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KASRA_BASE_URL | Yes | The base URL of the Kasra Lite instance (e.g., https://app.kasralite.com). | |
| KASRA_PASSWORD | Yes | Your Kasra Lite password. | |
| KASRA_USERNAME | Yes | Your Kasra Lite username. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| kasra_get_profileB | دریافت اطلاعات پروفایل کاربر جاری شامل نام، کد پرسنلی، شناسه شخص، واحد سازمانی، سمت و تاریخچه ورود‌های اخیر. Get current user profile, personnel ID, department, role, and recent login history. |
| kasra_get_dashboard_summaryA | دریافت خلاصه داشبورد و وضعیت کلی تردد شامل:
Get dashboard summary including last punch, cardex balance, total presence, worked hours, needed permissions, and requests status. |
| kasra_get_daily_reportA | دریافت گزارش تفصیلی کارکرد روزانه تردد (حضور، غیبت، ترددها و مرخصی‌ها). برای هر روز شامل:
|
| kasra_get_punch_gapsA | تحلیل ترددها و شناسایی بازههایی که کارمند در ساعات کاری بیرون بوده (خلأ بین خروج و ورود بعدی در شیفت). مناسب برای شناسایی ساعاتی که نیاز به ثبت مرخصی ساعتی دارند. Analyze daily punches to find gaps where the employee was out during their shift. Returns structured gap data (date, gapStart, gapEnd, duration) suitable for submitting hourly leave. |
| kasra_get_work_periodsC | دریافت لیست تمام دوره‌های کاری مالی و تردد موجود در سامانه (مانند شهریور 1405، مرداد 1405، ...). Get all available attendance and financial work periods with their IDs and titles. |
| kasra_get_monthly_reportA | دریافت گزارش سرجمع کارکرد ماهانه پرسنل. شامل کل حضور، کارکرد خالص، مازاد حضور، کسرحضور، اضافه‌کار، مرخصی‌ها و مأموریت‌های کل ماه. |
| kasra_get_cartable_itemsA | مشاهده اسناد و درخواست‌های کارتابل گردش کار (اسناد دریافتی برای بررسی، تأیید یا ارجاع). |
| kasra_get_credit_typesA | دریافت لیست کامل انواع مجوز‌ها، مرخصی‌ها، مأموریت‌ها و اضافه‌کارها با کد‌های سیستمی آنها. دسته‌ها شامل:
|
| kasra_get_submitted_requestsB | دریافت لیست درخواست‌های ثبت‌شده (مجوز‌ها، مرخصی‌ها، مأموریت‌ها) و وضعیت تأیید/رد آنها در بازه زمانی. |
| kasra_submit_credit_requestB | ثبت درخواست مجوز جدید (مرخصی ساعتی/روزانه، مأموریت ساعتی/روزانه، اضافه‌کار، دورکاری و ...). |
| kasra_delete_credit_requestB | حذف یا لغو درخواست مجوز یا مرخصی ثبت‌شده در سیستم. Cancel or delete a submitted permission, leave, mission, or remote work request. |
| kasra_get_messagesC | دریافت پیام‌ها، اعلانات و اطلاعیه‌های ارسالی سیستم برای کاربر جاری. Get user notifications, broadcast messages, and announcements. |
| kasra_get_desktop_shortcutsC | دریافت میان‌برهای میز کار و صفحات برگزیده کاربر. Get user desktop shortcuts and bookmarked pages. |
| kasra_get_system_shiftsB | دریافت لیست کلیه شیفت‌های کاری تعریف‌شده در سامانه کسرا (شیفت اداری، شیفت بدون پنجشنبه، شیفت دورکاری و ...). Get all work shifts defined in Kasra system. |
| kasra_get_personnel_groupsB | دریافت لیست کلیه گروه‌های پرسنلی تردد (مجوز‌های اضافه‌کار، تقلیل، دورکاری، شیفت‌ها و ...). Get all personnel groups and attendance policy groups. |
| kasra_export_daily_report_excelA | صدور گزارش تفصیلی کارکرد روزانه تردد به صورت فایل اکسل (Excel / .xls) و دریافت لینک مستقیم دانلود آن. Export daily attendance report to an Excel spreadsheet file (.xls) with direct download link. |
| kasra_get_holidaysB | دریافت تقویم تعطیلات رسمی ثبت‌شده در سیستم برای سال جاری. Get official calendar holidays defined in Kasra for the year. |
| kasra_get_user_menuC | دریافت ساختار کامل منوهای دسترسی کاربر در سامانه کسرا. Get the complete menu structure and subsystems available to the user. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 18 tools
Each tool targets a distinct resource or action: reporting tools separate daily, monthly, and dashboard views; request tools distinguish types, submitted requests, and submission/deletion; system data tools cover shifts, groups, holidays, and menus without overlap. Even related tools like punch gaps and daily report are clearly differentiated by output purpose.
All tools follow a consistent 'kasra_' prefix with snake_case verb_noun structure, e.g., kasra_get_profile, kasra_submit_credit_request, kasra_delete_credit_request. The few non-get verbs (submit, delete, export) are still in the same style, making the naming pattern predictable and reliable.
At 18 tools, the set is slightly above the typical 3-15 sweet spot but still reasonable for a broad attendance/HR system covering reports, requests, workflow, and configuration data. Some peripheral tools like get_desktop_shortcuts and get_user_menu could be considered expendable, which prevents a perfect score.
The core employee workflow is well covered: profile, dashboard, daily/monthly reports, punch gap analysis, submitting and deleting credit requests, and viewing submitted requests and cartable items. However, there is no update or approval action for cartable items, no request detail tool, and only daily report export is available, leaving minor workflow gaps.