hamravesh-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HAMRAVESH_ORG | No | Default organization name (e.g. wgcup). Recommended but not required. | |
| HAMRAVESH_OTP | No | OTP code for two-factor authentication (if enabled). | |
| HAMRAVESH_BASE | No | Base URL for the Hamravesh API (default: https://api.hamravesh.com). | |
| HAMRAVESH_EMAIL | No | Email address for JWT authentication. | |
| HAMRAVESH_API_KEY | No | API key for authentication (recommended). | |
| HAMRAVESH_PASSWORD | No | Password for JWT authentication. | |
| HAMRAVESH_ALLOW_WRITE | No | Set to '1' to enable write operations (restart, redeploy, etc.). Default off. | |
| HAMRAVESH_ALLOW_DELETE | No | Set to '1' to enable delete operations. Default off. |
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 | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| hamravesh_whoamiA | پروفایل کاربر + فهرست سازمانها، نقشها، بودجه و کلاسترها. |
| hamravesh_list_appsA | فهرست اپهای دارکوب یک سازمان (با وضعیت، دامنه، منابع، replicas). |
| hamravesh_get_appB | جزئیات کامل یک اپ دارکوب (env، دامنه، منابع، بیلد، وضعیت). برای جلوگیری از نشتِ رمز، مقدارِ env ها بهصورتِ پیشفرض ماسک میشود؛ با reveal_secrets=true مقدارها نمایش داده میشوند. |
| hamravesh_app_containersC | فهرست پادها/کانتینرهای یک اپ. |
| hamravesh_app_logsB | لاگهای یک اپ. ابتدا با hamravesh_app_containers نامِ pod را بگیر. endpoint پارامترهای from_index/to_index/reference_index میخواهد؛ این ابزار پیشفرضِ معقول میگذارد (آخرین ~۲۰۰ خط). |
| hamravesh_app_manifestsC | منیفستهای Kubernetes یک اپ (YAML). |
| hamravesh_app_buildsC | تاریخچهی بیلدهای یک اپ. |
| hamravesh_list_databasesC | فهرست دیتابیسهای مدیریتشده (DBaaS) یک سازمان. |
| hamravesh_get_databaseC | جزئیاتِ یک دیتابیسِ DBaaS (با شناسهی app_id آن). |
| hamravesh_create_databaseA | ساخت یک دیتابیسِ مدیریتشده (DBaaS). واحدها: cpu = millicore (۱۰۰۰=۱ core)، ram/disk = MB. num_of_standbys = تعدادِ standby (۰ = فقط master). plan را از |
| hamravesh_database_powerC | روشن یا خاموش کردنِ یک دیتابیسِ DBaaS. (غیرفعال — برای فعالسازی HAMRAVESH_ALLOW_WRITE=1) [پیشنمایش: dry_run:true یا env HAMRAVESH_DRY_RUN=1] |
| hamravesh_delete_databaseA | حذفِ کاملِ یک دیتابیسِ DBaaS (برگشتناپذیر). نیازمندِ ALLOW_DELETE. (غیرفعال — برای فعالسازی HAMRAVESH_ALLOW_WRITE=1) [پیشنمایش: dry_run:true یا env HAMRAVESH_DRY_RUN=1] |
| hamravesh_set_basic_authA | تنظیمِ Basic Auth روی ingressِ یک اپ دارکوب (محافظت با یوزر/پسورد). برای حذفِ محافظت، username/password را خالی بگذار. (روشِ امن: GET اپ → ادغام → PUT.) (غیرفعال — برای فعالسازی HAMRAVESH_ALLOW_WRITE=1) [پیشنمایش: dry_run:true یا env HAMRAVESH_DRY_RUN=1] |
| hamravesh_list_registriesC | فهرست کانتینر رجیستریها و مصرف فضای آنها. |
| hamravesh_list_marketplace_productsC | فهرستِ محصولاتِ بازارچه/SaaS (اپهای یککلیکی: GitLab Runner، n8n، WordPress، Grafana، Metabase، …). ⚠️ مسیرِ بازارچه پیشوندِ /marketplace/ دارد (نه /api/v1/app/) — همین باعثِ ۴۰۴ در گزارشهای قبلی بود. |
| hamravesh_list_saasC | فهرستِ سرویسهای بازارچه/SaaSِ نصبشدهی یک سازمان. |
| hamravesh_get_saasC | جزئیاتِ یک سرویسِ SaaSِ نصبشده (با service_id). |
| hamravesh_create_saasA | ساختِ یک سرویسِ بازارچه/SaaS (اپِ یککلیکی مثل GitLab Runner / n8n / WordPress / Grafana). هر محصول فیلدهای خودش را دارد؛ اول با hamravesh_list_marketplace_products محصول (id/product_type/suggested_plan_id/plans) و فیلدهای لازم را ببین، سپس بدنهی کامل را در |
| hamravesh_billingC | وضعیت مالی سازمان: کیفپولها، بودجه و بدهی. |
| hamravesh_list_apikeysC | فهرست کلیدهای API سازمان. |
| hamravesh_restart_appC | ریاستارت یک اپ (همهی پادها دوباره راه میافتند). (غیرفعال — برای فعالسازی HAMRAVESH_ALLOW_WRITE=1) [پیشنمایش: dry_run:true یا env HAMRAVESH_DRY_RUN=1] |
| hamravesh_redeploy_appC | دیپلوی مجدد اپ از روی آخرین کامیت/بیلد. (غیرفعال — برای فعالسازی HAMRAVESH_ALLOW_WRITE=1) [پیشنمایش: dry_run:true یا env HAMRAVESH_DRY_RUN=1] |
| hamravesh_scale_appA | تغییر تعداد replica های یک اپ. (غیرفعال — برای فعالسازی HAMRAVESH_ALLOW_WRITE=1) [پیشنمایش: dry_run:true یا env HAMRAVESH_DRY_RUN=1] |
| hamravesh_set_app_enabledC | روشن/خاموش کردن یک اپ (is_enabled). (غیرفعال — برای فعالسازی HAMRAVESH_ALLOW_WRITE=1) [پیشنمایش: dry_run:true یا env HAMRAVESH_DRY_RUN=1] |
| hamravesh_update_app_envsA | بهروزرسانی متغیرهای محیطی یک اپ. |
| hamravesh_create_appA | ساخت یک اپِ داکر-ایمیجِ جدید در دارکوب (بدنهاش با تست زنده تأیید شده). به plan (uuid پلن منابع)، namespace (id عددی namespace) و organization (id عددی سازمان) نیاز دارد — این مقادیر را از hamravesh_get_app روی یک اپِ موجود ببین (plan آن، و idِ namespace و organization همان اپ را بردار). (غیرفعال — برای فعالسازی HAMRAVESH_ALLOW_WRITE=1) [پیشنمایش: dry_run:true یا env HAMRAVESH_DRY_RUN=1] |
| hamravesh_delete_appA | حذفِ کاملِ یک اپ دارکوب (برگشتناپذیر). نیازمند ALLOW_DELETE. (غیرفعال — برای فعالسازی HAMRAVESH_ALLOW_WRITE=1) [پیشنمایش: dry_run:true یا env HAMRAVESH_DRY_RUN=1] |
| hamravesh_create_apikeyC | ساخت یک کلید API جدید برای سازمان. مقدار کلید فقط همین یک بار برمیگردد. (غیرفعال — برای فعالسازی HAMRAVESH_ALLOW_WRITE=1) [پیشنمایش: dry_run:true یا env HAMRAVESH_DRY_RUN=1] |
| hamravesh_delete_apikeyC | حذف یک کلید API (با شناسهی id، نه مقدار value). (غیرفعال — برای فعالسازی HAMRAVESH_ALLOW_WRITE=1) [پیشنمایش: dry_run:true یا env HAMRAVESH_DRY_RUN=1] |
| hamravesh_requestA | درخواست خام به هر endpoint همروش (برای کارهایی که ابزار اختصاصی ندارند). GET همیشه مجاز است؛ POST/PUT/PATCH نیازمند ALLOW_WRITE و DELETE نیازمند ALLOW_DELETE است. فهرست کامل مسیرها در ENDPOINTS.md پروژه است. |
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 30 tools
Each tool targets a distinct resource/action, and the main potential confusions (e.g., list_saas vs. list_marketplace_products, create_saas vs. create_app) are clarified by their descriptions. A couple of similar lifecycle actions on different resources could still cause misselection, but the boundaries are mostly clear.
The dominant hamravesh_verb_noun pattern is consistent and readable. The few exceptions like app_containers, app_logs, app_manifests, and database_power break the otherwise predictable convention, but they are still recognizable and not chaotic.
At 30 tools, the server exceeds the 25-tool threshold and feels heavy even for a broad cloud-management API. Several write tools are disabled by default, and some subresource operations could plausibly be consolidated, making the surface larger than necessary.
Core app and database lifecycles are well covered, including create/read/delete, but SaaS has no update/delete tool, database plans/updates are missing as dedicated tools, and app updates are limited to envs/basic auth. The raw hamravesh_request tool helps agents work around these gaps, but notable operations still lack first-class support.