> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# أدوات Didit MCP: مرجع الأدوات (169 أداة للتحقق من الهوية)

> كل أداة يوفرها خادم Didit MCP المستضاف، مجمّعة حسب المجال، مع نوعها (قراءة/كتابة/حذف)، ونطاق OAuth، والإذن المطلوب لكل دور.

يمنح الخادم المستضاف على `https://mcp.didit.me/mcp` المستخدمَ الذي سجّل الدخول **169 أداة**: 80 للقراءة، و62 للكتابة، و27 تدميرية.
تُدرج أيضاً 17 أداة من [أدوات Investigator](#investigator)، لكنها لا تعمل إلا بعد تفعيل Investigator لمؤسستك.
وهناك أداتان أخريان (`didit_org_top_up` و`didit_org_reveal_application_api_key`) مخفيتان عن كل كتالوج مصادَق عليه عبر OAuth، ولا تظهران إلا على خادم stdio محلي، والذي يضيف كذلك خمس أدوات لإعداد الحساب (انظر [الاستضافة الذاتية](https://docs.didit.me/ar/integration/mcp/installation.md#الاستضافة-الذاتية)).

تُولَّد هذه الصفحة من سجل الأدوات في [`didit-protocol/mcp`](https://github.com/didit-protocol/mcp) (`src/index.ts`، وهو الإصدار الذي يعلنه الخادم المستضاف في `serverInfo`). تأتي الأسماء والأنواع والوسائط المطلوبة من استجابة `tools/list` الخاصة بالخادم، أما إذن الدور فيأتي من `src/permissions.ts`.

## كيفية قراءة الجدول

| العمود | المعنى |
| - | - |
| **النوع** | من تعليقات MCP الخاصة بالأداة. **قراءة** تعني أنها للقراءة فقط. **كتابة** تنشئ شيئاً أو تغيّره. **تدميرية** تحذف بيانات أو تستبدلها، أو تغيّر شيئاً يسري فوراً (سير عمل منشور، أو قرار على جلسة)، أو تكشف سرّاً، أو تنقل أموالاً؛ ويطلب العملاء تأكيداً قبل تشغيل هذه الأدوات. تُحتسب الفحوصات المستقلة القابلة للفوترة ضمن الكتابة. |
| **النطاق** | نطاق OAuth الذي تتضمن موارده إذن دور الأداة: `didit:verification` للجلسات والشركات والحالات والشبكات والمعاملات وقائمة الحظر؛ و`didit:management` لسير العمل والاستبيانات والقوائم وwebhooks والتكاملات والأعضاء والأدوار ومفاتيح API وسجلات التدقيق والمؤسسة والتطبيقات والاشتراك والمستخدمين. أما **أيٌّ منهما** فيعني التحليلات، التي يشملها النطاقان، أو أداة لا تتحقق من الإذن لكل دور، فتعمل تحت أي نطاق وافقت عليه. انظر [المصادقة](https://docs.didit.me/ar/integration/mcp/authentication.md#النطاقات). |
| **إذن الدور** | الإذن الذي يجب أن يملكه دور مؤسستك، كما يتحقق منه الخادم الخلفي لـ Didit. الشرطة (-) تعني أن نقطة النهاية مرتبطة بالعضوية أو لا تتحقق من الدور. إذا لم يملك دورك هذا الإذن، تُعيد الأداة خطأ `missing_scope` يسمّي الإذن. |

تقبل كل أداة الوسيطين الاختياريين `organization_id` و`application_id` لتثبيت النطاق. عند وجود مؤسسة وتطبيق واحد، يُحدَّدان تلقائياً. وعند وجود أكثر من واحد، تشمل أدوات `*_search` وكذلك `didit_analytics` الجميع، وتفعل أدوات `*_list` الخاصة بكل تطبيق الشيء نفسه عند عدم تمرير أي نطاق.

> [!NOTE]
>
> ترفض `didit_session_delete` و`didit_session_batch_delete` العمل من دون `confirm: true` في وسائطهما، وكذلك أدوات قرار Investigator (`accept` و`override` و`batch_accept` و`rereview` و`question_answer` و`question_dismiss`) والأداة المحلية فقط `didit_org_reveal_application_api_key`. تحتاج `didit_case_manage` هذه الوسيطة عند رفع SAR، وتحتاجها `didit_vendor_user_delete` و`didit_vendor_business_delete` عندما تكون `delete_all` بقيمة true.

***

## الاكتشاف والعمل عبر التطبيقات

تمتد هذه الأدوات على كل مؤسسة وتطبيق يمكنك الوصول إليهما في استدعاء واحد، ويُوسَم كل صف بمؤسسته وتطبيقه.

| الأداة | النوع | النطاق | إذن الدور | ما تفعله |
| - | - | - | - | - |
| `didit_context_get` | قراءة | أيٌّ منهما | - | كل مؤسسة وتطبيق يمكنك الوصول إليهما، متداخلَين، بالإضافة إلى المؤسسة والتطبيق الافتراضيين عند وجود واحد فقط. استدعها أولاً. |
| `didit_session_search` | قراءة | `didit:verification` | `list:sessions` | البحث في جلسات التحقق عبر جميع تطبيقاتك ومؤسساتك، الأحدث أولاً. |
| `didit_transaction_search` | قراءة | `didit:verification` | `list:transactions` | البحث في المعاملات المراقَبة عبر جميع تطبيقاتك ومؤسساتك. |
| `didit_case_search` | قراءة | `didit:verification` | `list:cases` | البحث في حالات التحقيق عبر جميع تطبيقاتك ومؤسساتك. |
| `didit_vendor_user_search` | قراءة | `didit:management` | `list:users` | البحث عن عميل نهائي بالاسم أو البريد الإلكتروني أو `vendor_data` عبر جميع تطبيقاتك. |
| `didit_vendor_business_search` | قراءة | `didit:verification` | `list:businesses` | البحث عن شركة KYB عبر جميع تطبيقاتك. |
| `didit_workflow_search` | قراءة | `didit:management` | `read:workflows` | البحث عن سير عمل بالمعرّف أو التسمية عبر جميع تطبيقاتك؛ وتحدد النتيجة المؤسسة والتطبيق اللذين يملكانه. |
| `didit_analytics` | قراءة | أيٌّ منهما | `read:analytics` | تحليلات مجمّعة لنافذة زمنية محددة (تفصيل الطلبات، ومسار تحويل الميزات، ومعدل التحويل) عبر جميع تطبيقاتك. |

***

## الجلسات (KYC وKYB)

| الأداة | النوع | النطاق | إذن الدور | ما تفعله |
| - | - | - | - | - |
| `didit_session_create` | كتابة | `didit:verification` | `create:sessions` أو `write:sessions` | إنشاء جلسة تحقق لسير عمل. تُرجع `session_id` و`url` و`session_token`. |
| `didit_session_list` | قراءة | `didit:verification` | `list:sessions` | عرض الجلسات في تطبيق واحد. تشمل كل التطبيقات إذا لم تحدد نطاقاً. |
| `didit_session_get_decision` | قراءة | `didit:verification` | `read:sessions` | القرار الكامل وجميع البيانات المستخرجة لجلسة. |
| `didit_session_get_location_evidence` | قراءة | `didit:verification` | `read:sessions` | أدلة الموقع الدقيق لجلسة واحدة لكل خطوة موقع: الإعداد الذي حكم عليها، والحكم، وكل محاولة، ونقاط المرجع، والمسافات والمناطق. |
| `didit_session_update_status` | تدميري | `didit:verification` | `write:sessions` | الموافقة على جلسة أو رفضها أو طلب إعادة تقديمها. |
| `didit_session_update_data` | كتابة | `didit:verification` | `write:sessions` | تصحيح البيانات المستخرجة من مستند الهوية (تجاوز من المراجِع). |
| `didit_session_update_poa_data` | كتابة | `didit:verification` | `write:sessions` | تصحيح البيانات المستخرجة من مستند إثبات العنوان. |
| `didit_session_delete` | تدميري | `didit:verification` | `delete:sessions` | حذف جلسة واحدة نهائياً مع بيانات التحقق ووسائطها. يتطلب `confirm: true`. |
| `didit_session_batch_delete` | تدميري | `didit:verification` | `delete:sessions` | حذف عدة جلسات KYC نهائياً حسب أرقام الجلسات، أو كل جلسات KYC في التطبيق. يتطلب `confirm: true`. لا تتأثر جلسات KYB إطلاقاً. |
| `didit_session_generate_pdf` | كتابة | `didit:verification` | `read:sessions` | إنشاء تقرير تحقق بصيغة PDF لجلسة. |
| `didit_session_list_reviews` | قراءة | `didit:verification` | `read:sessions` | سجل المراجعات وسجل النشاط لجلسة. |
| `didit_session_add_review` | كتابة | `didit:verification` | `write:sessions` | إضافة ملاحظة مراجعة إلى جلسة، مع إمكانية تغيير حالتها. |
| `didit_session_share` | كتابة | `didit:verification` | `write:sessions` | مشاركة جلسة متحقق منها مع شريك موثوق (KYC القابل لإعادة الاستخدام). |
| `didit_session_import_shared` | كتابة | أي منهما | — | استيراد جلسة شاركها معك شريك (KYC القابل لإعادة الاستخدام). |
| `didit_session_create_import` | كتابة | أي منهما | — | بدء مهمة استيراد جماعي من ملف CSV أو NDJSON مستضاف. |
| `didit_session_get_import_template` | قراءة | أي منهما | — | تنزيل قالب الاستيراد (عناوين الأعمدة والتنسيق). |
| `didit_session_get_import` | قراءة | أي منهما | — | حالة مهمة الاستيراد الجماعي وملخصها. |
| `didit_session_get_import_errors` | قراءة | أي منهما | — | الأخطاء لكل صف في مهمة الاستيراد الجماعي. |
| `didit_session_explain_decision` | قراءة | `didit:verification` | `read:sessions` | سبب انتهاء الجلسة بحالة مقبولة أو مرفوضة أو قيد المراجعة: الميزة الحاسمة، وكل تحذير كان له أثر، وكل قاعدة حالة تم تفعيلها، وأي تجاوز من المراجِع، وإعداد سير العمل الذي يقف وراء كل سبب. |
| `didit_session_webhooks` | قراءة | `didit:verification` | `read:sessions` | عمليات تسليم webhook المرسلة لجلسة واحدة خلال آخر 30 يوماً: الوجهة، وحالة HTTP، والتوقيت، ورؤوس التوقيع، ونسخة محدودة من payload. |
| `didit_session_webhook_resend` | كتابة | `didit:verification` | `create:sessions` | إعادة إرسال عملية تسليم webhook مسجلة لجلسة إلى endpoint المُعدّ، مثلاً بعد إصلاح الـ endpoint. |

***

## سير العمل

سير العمل البسيط قائمة ميزات مسطّحة، أما مخططات سير العمل فتضيف الفروع والشروط وخطوات Document AI. انظر [متقدم: سير العمل المتفرع](https://docs.didit.me/ar/integration/mcp/advanced.md#سير-العمل-المتفرع).

| الأداة | النوع | النطاق | إذن الدور | ما تفعله الأداة |
| - | - | - | - | - |
| `didit_workflow_list` | قراءة | `didit:management` | `read:workflows` | عرض سير العمل الخاصة بالتحقق. تشمل كل التطبيقات إذا لم تحدد نطاقًا. |
| `didit_workflow_create` | كتابة | `didit:management` | `write:workflows` | إنشاء سير عمل بسيط وخطي من قائمة مرتبة من الميزات. ينشره ما لم تمرر `status: "draft"`. |
| `didit_workflow_get` | قراءة | `didit:management` | `read:workflows` | الإعدادات الكاملة لسير عمل واحد، بما في ذلك نقاط البيانات التي تُعاد لكل ميزة. |
| `didit_workflow_update` | تدميري | `didit:management` | `write:workflows` | تغيير الإعدادات على المستوى الأعلى لسير العمل (التسمية، وعلامة الافتراضي، وإعادة المحاولات، والانتهاء، والعلامة البيضاء، وقوائم السماح). |
| `didit_workflow_delete` | تدميري | `didit:management` | `write:workflows` | حذف مسودة سير عمل. |
| `didit_workflow_get_graph` | قراءة | `didit:management` | `read:workflows` | مخطط العقد لسير عمل مع حالته وقابلية تحريره. تُلخَّص الإعدادات الكبيرة ما لم تطلبها كاملة. |
| `didit_workflow_get_field_definitions` | قراءة | `didit:management` | `read:workflows` | كل حقل يمكنك التفرع بناءً عليه، وعوامل التشغيل التي يقبلها كل حقل. |
| `didit_workflow_get_feature_config_schema` | قراءة | أيٌّ منهما | — | كل مفتاح `config` تقبله كل ميزة في سير العمل، مع نوعه وحدوده وقيمته الافتراضية ومعناه. |
| `didit_workflow_get_id_verification_methods_catalog` | قراءة | `didit:management` | `read:workflows` | لكل دولة، عمليات البحث غير المستندية والمحافظ الرقمية للهوية المتاحة، وهل هي مفعّلة فعليًا، وأسعار كتالوج عمليات البحث الخاص بها. |
| `didit_workflow_get_kyb_registry_catalog` | قراءة | أيٌّ منهما | — | لكل دولة، مستويات بيانات الشركات التي تقدمها السجلات، وهل تُباع مراقبة السجلات، مع الأسعار. لا يلزم مؤسسة أو تطبيق. |
| `didit_workflow_get_branch_fields` | قراءة | `didit:management` | `read:workflows` | الحقول المتاحة عند نقطة تفرّع واحدة في مخطط مرشح. |
| `didit_workflow_validate_graph` | قراءة | `didit:management` | `read:workflows` | التحقق من مخطط كامل بتشغيل تجريبي. لا يحفظ أي شيء. |
| `didit_workflow_edit_graph` | تدميري | `didit:management` | `write:workflows` | تعديل مخطط موجود بعمليات صغيرة؛ يجلب الخادم المخطط الكامل بنفسه ويحفظ مسودة. |
| `didit_workflow_set_graph` | تدميري | `didit:management` | `write:workflows` | استبدال المخطط الكامل لسير العمل. يحفظ مسودة، والنشر خطوة منفصلة. |
| `didit_workflow_create_draft` | كتابة | `didit:management` | `write:workflows` | إنشاء مسودة قابلة للتحرير من سير عمل منشور. |
| `didit_workflow_publish` | تدميري | `didit:management` | `write:workflows` | نشر المسودة المعلّقة حتى تستخدمها الجلسات الجديدة. |
| `didit_workflow_build_graph` | قراءة | `didit:management` | `read:workflows` | بناء مخطط كامل من مواصفات ميزات بسيطة دون حفظ أي شيء. |

***

## مساعد الامتثال

ابنِ سير عمل من ملفك التنظيمي: مقابلة تكيفية، والالتزامات المنطبقة عليك مع المراجع، وسير عمل متعدد الدول يُولَّد تلقائيًا.

| الأداة | النوع | النطاق | إذن الدور | ما تفعله الأداة |
| - | - | - | - | - |
| `didit_compliance_interview_next` | قراءة | `didit:management` | `read:workflows` | السؤال التالي في مقابلة الامتثال التكيفية، أو `done` عند اكتمالها. مرّر كل الإجابات المجمّعة حتى الآن في كل استدعاء. |
| `didit_compliance_profile_get` | قراءة | `didit:management` | `read:workflows` | ملف الامتثال المخزّن لديك: إجابات المقابلة والسمات المشتقة منها. |
| `didit_compliance_profile_set` | تدميري | `didit:management` | `write:workflows` | تخزين إجابات المقابلة المكتملة، مع استبدال أي ملف امتثال موجود. |
| `didit_compliance_requirements` | قراءة | `didit:management` | `read:workflows` | الالتزامات التنظيمية المنطبقة عليك، مع المراجع، المشتقة من ملف الامتثال المخزّن. |
| `didit_compliance_generate_workflow` | قراءة | `didit:management` | `read:workflows` | توليد مخطط سير عمل متعدد الدول من ملف الامتثال المخزّن: جذع مشترك تتفرع منه فروع لكل دولة تتضمن الفحوصات التي تشترطها تلك الدولة. |
| `didit_compliance_check_workflow` | قراءة | `didit:management` | `read:workflows` | التحقق من الالتزامات التي تستوفيها نسخة سير العمل أو تخالفها، مع المراجع. |

***

## الاستبيانات

| الأداة | النوع | النطاق | إذن الدور | ما تفعله الأداة |
| - | - | - | - | - |
| `didit_questionnaire_list` | قراءة | `didit:management` | `read:questionnaires` | عرض الاستبيانات المخصّصة لتطبيق. |
| `didit_questionnaire_create` | كتابة | `didit:management` | `write:questionnaires` | إنشاء استبيان من قائمة مرتبة من الأسئلة. |
| `didit_questionnaire_append_choices` | كتابة | `didit:management` | `write:questionnaires` | إضافة خيارات إجابة إلى سؤال واحد في استبيان مسودة. |
| `didit_questionnaire_get` | قراءة | `didit:management` | `read:questionnaires` | الأسئلة وخياراتها لاستبيان واحد. |
| `didit_questionnaire_update` | تدميري | `didit:management` | `write:questionnaires` | تحديث عنوان الاستبيان أو وصفه أو أسئلته. |
| `didit_questionnaire_delete` | تدميري | `didit:management` | `write:questionnaires` | حذف استبيان. |

***

## واجهات التحقق المستقلة

استدعاءات منفردة قابلة للفوترة دون جلسة. كل واحدة منها طلب POST يستهلك أرصدة، حتى تلك التي تبدو كاستعلامات (`kyb_search`، `face_search`).

| الأداة | النوع | النطاق | إذن الدور | وظيفتها |
| - | - | - | - | - |
| `didit_verify_id` | كتابة | `didit:verification` | `create:sessions` | التحقق من مستند هوية من صورته الأمامية (وصورته الخلفية اختيارياً). |
| `didit_verify_poa` | كتابة | `didit:verification` | `create:sessions` | التحقق من مستند إثبات العنوان. |
| `didit_verify_database` | كتابة | `didit:verification` | `create:sessions` | التحقق من بيانات الهوية مقابل مصادر رسمية وطنية وعالمية. |
| `didit_verify_kyb_search` | كتابة | `didit:verification` | `create:sessions` | البحث في سجلات الشركات الرسمية بالاسم أو برقم التسجيل، ويعيد قائمة بالمرشحين. |
| `didit_verify_kyb_select` | كتابة | `didit:verification` | `create:sessions` | استرجاع سجل الشركات الكامل لمرشح أعادته `didit_verify_kyb_search`. |
| `didit_verify_passive_liveness` | كتابة | `didit:verification` | `create:sessions` | كشف الحيوية السلبي من صورة واحدة. |
| `didit_verify_face_match` | كتابة | `didit:verification` | `create:sessions` | مقارنة صورتي وجه (1:1). |
| `didit_verify_face_search` | كتابة | `didit:verification` | `create:sessions` | البحث عن وجه بين الوجوه التي تم التحقق منها سابقاً (1:N). |
| `didit_verify_age` | كتابة | `didit:verification` | `create:sessions` | تقدير عمر الشخص من صورة وجهه. |
| `didit_verify_aml` | كتابة | `didit:verification` | `create:sessions` | فحص اسم مقابل قوائم العقوبات والأشخاص المعرّضين سياسياً وقوائم المراقبة، واختيارياً الأخبار السلبية. |
| `didit_verify_email_send` | كتابة | أيٌّ منهما | — | إرسال رمز لمرة واحدة إلى عنوان البريد الإلكتروني. |
| `didit_verify_email_check` | كتابة | أيٌّ منهما | — | التحقق من الرمز المرسل إلى عنوان البريد الإلكتروني. |
| `didit_verify_phone_send` | كتابة | أيٌّ منهما | — | إرسال رمز لمرة واحدة إلى رقم الهاتف. |
| `didit_verify_phone_check` | كتابة | أيٌّ منهما | — | التحقق من الرمز المرسل إلى رقم الهاتف. |

***

## مراقبة المعاملات

| الأداة | النوع | النطاق | إذن الدور | وظيفتها |
| - | - | - | - | - |
| `didit_transaction_list` | قراءة | `didit:verification` | `list:transactions` | عرض المعاملات المراقَبة في تطبيق واحد. وإذا لم تحدد نطاقاً فإنها تشمل كل التطبيقات. |
| `didit_transaction_create` | كتابة | `didit:verification` | `create:transactions` | إرسال معاملة للمراقبة وتقييم القواعد. |
| `didit_transaction_get` | قراءة | `didit:verification` | `list:transactions` | معاملة واحدة مراقَبة مع نتيجة تقييم القواعد. |
| `didit_transaction_screen_wallet` | كتابة | `didit:verification` | `create:transactions` | فحص عنوان محفظة عملات مشفرة بحثاً عن مخاطر AML دون إنشاء معاملة. |
| `didit_transaction_rule_list` | قراءة | `didit:verification` | `list:transactions` | عرض قواعد مراقبة المعاملات في التطبيق. |
| `didit_transaction_rule_get` | قراءة | `didit:verification` | `list:transactions` | قاعدة واحدة مع شروطها وتجميعها ونطاقها وإجراءاتها وعدّاداتها. |
| `didit_transaction_rule_create` | كتابة | `didit:verification` | `write:transactions` | إنشاء قاعدة مخصصة. |
| `didit_transaction_rule_update` | كتابة | `didit:verification` | `write:transactions` | تحديث جزئي لقاعدة. |
| `didit_transaction_rule_delete` | تدميري | `didit:verification` | `write:transactions` | حذف قاعدة مخصصة. |
| `didit_transaction_rule_backtest` | قراءة | `didit:verification` | `list:transactions` | تشغيل تجريبي لقاعدة افتراضية على ما يصل إلى أحدث 10,000 معاملة. لا يكتب أي بيانات. |
| `didit_transaction_rule_library_list` | قراءة | `didit:verification` | `list:transactions` | تصفح مكتبة القواعد الجاهزة من Didit مع حالة التثبيت. |
| `didit_transaction_rule_install` | كتابة | `didit:verification` | `write:transactions` | تثبيت قواعد جاهزة بمفتاح من المكتبة أو بحزمة. |
| `didit_transaction_rule_uninstall` | تدميري | `didit:verification` | `write:transactions` | إزالة قواعد جاهزة مثبّتة بمفتاح من المكتبة أو بحزمة. |
| `didit_transaction_sdk_token` | كتابة | أيٌّ منهما | — | إصدار token قصير الأمد مرتبط بمستخدم نهائي واحد لإرسال المعاملات من حزم SDK على جهة العميل. |

***

## Travel Rule

| الأداة | النوع | النطاق | إذن الدور | ما تفعله |
| - | - | - | - | - |
| `didit_travel_rule_get_settings` | قراءة | أيٌّ منهما | — | إعدادات Travel Rule الخاصة بك: ملف VASP، وسياسة التفاوض، وطرق الإثبات، وأوضاع كل شبكة، وعنوان Travel Address الخاص بك. |
| `didit_travel_rule_update_settings` | كتابة | أيٌّ منهما | — | تغيير إعدادات Travel Rule؛ أرسل الحقول المراد تغييرها فقط. يتطلب التفعيل اسمًا قانونيًا. |
| `didit_travel_rule_search_vasps` | قراءة | أيٌّ منهما | — | البحث في دليل VASP، مع درجات العناية الواجبة والشبكات التي يمكن الوصول إلى كل VASP عبرها. |
| `didit_travel_rule_list_wallet_addresses` | قراءة | أيٌّ منهما | — | دفتر عناوين المحافظ الذي تُطابق معه التحويلات الواردة، مع حالة التحقق من ملكية كل عنوان. |
| `didit_travel_rule_add_wallet_address` | كتابة | أيٌّ منهما | — | إضافة محفظة تتحكم بها إلى دفتر العناوين، ويمكن اعتبارها موثّقة الملكية بالفعل عبر الإقرار الذاتي. |
| `didit_travel_rule_update_wallet_address` | كتابة | أيٌّ منهما | — | تحديث تفاصيل صاحب العنوان في إدخال دفتر العناوين. |
| `didit_travel_rule_delete_wallet_address` | إتلافي | أيٌّ منهما | — | حذف إدخال من دفتر العناوين؛ يتوقف فورًا عن مطابقة التحويلات الجديدة. |
| `didit_travel_rule_confirm_ownership` | إتلافي | أيٌّ منهما | — | تأكيد ملكية المحفظة أو نفيها في تحويل ينتظر إثبات الملكية. |
| `didit_travel_rule_transfer_action` | إتلافي | أيٌّ منهما | — | إنهاء تحويل صادر بتجزئة المعاملة على السلسلة، أو إلغاء تحويل غير نهائي، أو إعادة تشغيل توجيه التحويل إلى الطرف المقابل. |
| `didit_travel_rule_get_vasp` | قراءة | أيٌّ منهما | — | الحصول على إدخال واحد من دليل VASP بالمعرّف، بالحقول نفسها الموجودة في صف البحث: المسارات، وقوائم الشبكات، والأسماء المستعارة، وجهات الاتصال، والكيانات. |
| `didit_travel_rule_list_networks` | قراءة | أيٌّ منهما | — | حالة كل شبكة Travel Rule لتطبيقك، مع السبب، وسجل المشاركة الخاص بك، واستبيان العناية الواجبة. |
| `didit_travel_rule_request_network` | كتابة | أيٌّ منهما | — | طلب الانضمام إلى شبكة Travel Rule كمشارك. ينتظر الطلب حتى يُعتمد استبيان العناية الواجبة. |
| `didit_travel_rule_get_network_questionnaire` | قراءة | أيٌّ منهما | — | استبيان العناية الواجبة للوصول إلى الشبكة: الحالة، والإجابات المحفوظة، وملاحظة المراجِع، وسجل الحالات. |
| `didit_travel_rule_update_network_questionnaire` | كتابة | أيٌّ منهما | — | حفظ الإجابات في مسودة الاستبيان. أرسل الإجابات المراد تغييرها فقط. |
| `didit_travel_rule_submit_network_questionnaire` | إتلافي | أيٌّ منهما | — | إرسال الاستبيان المحفوظ للمراجعة. لا يمكن تعديله أثناء المراجعة. |
| `didit_travel_rule_set_counterparty_vasp` | كتابة | أيٌّ منهما | — | اختيار VASP الطرف المقابل لتحويل صادر تعذّر توجيهه، وإعادة تشغيل التبادل نحوه. |
| `didit_travel_rule_list_messages` | قراءة | أيٌّ منهما | — | الرسائل وطلبات المستندات المتبادلة مع VASP الطرف المقابل في تحويل، من الأقدم إلى الأحدث. |
| `didit_travel_rule_send_message` | كتابة | أيٌّ منهما | — | إرسال رسالة أو طلب مستند إلى VASP الطرف المقابل في تحويل. تتضمن التحويلات رسائل فقط إذا كانت مع عميل آخر لدى Didit أو تتم عبر البريد الإلكتروني. |
| `didit_travel_rule_list_counterparty_contacts` | قراءة | أيٌّ منهما | — | جهات اتصال الامتثال المستخدمة للوصول إلى VASP طرف مقابل عبر البريد الإلكتروني: جهات المنصة وجهات تطبيقك الخاصة. |
| `didit_travel_rule_add_counterparty_contact` | كتابة | أيٌّ منهما | — | إضافة جهة اتصال امتثال لـ VASP في الدليل، وتكون خاصة بتطبيقك. |
| `didit_travel_rule_delete_counterparty_contact` | إتلافي | أيٌّ منهما | — | حذف إحدى جهات اتصال الطرف المقابل الخاصة بتطبيقك. |
| `didit_travel_rule_get_sandbox_scenarios` | قراءة | أيٌّ منهما | — | VASP الاختباري من Didit الذي تتبادل معه تطبيقات البيئة التجريبية، والسيناريوهات (قبول، رفض، عدم تطابق الاسم، عدم القدرة على الوصول، انتهاء المهلة، الاستضافة الذاتية) التي يختارها كل عنوان محفظة. |
| `didit_travel_rule_trigger_test_inbound` | كتابة | أيٌّ منهما | — | للتطبيقات في البيئة التجريبية فقط: يجعل VASP الاختباري من Didit يرسل إليك تحويل Travel Rule واردًا. |

***

## مستخدمو المورد والشركات

| الأداة | النوع | النطاق | إذن الدور | ما تفعله |
| - | - | - | - | - |
| `didit_vendor_user_list` | قراءة | `didit:management` | `list:users` | قائمة المستخدمين الموثّقين مجمّعين حسب `vendor_data`. تشمل كل التطبيقات عند عدم تحديد نطاق. |
| `didit_vendor_user_create` | كتابة | `didit:management` | `create:users` | إنشاء سجل مستخدم يدويًا. |
| `didit_vendor_user_get` | قراءة | `didit:management` | `read:users` | مستخدم واحد حسب `vendor_data`. |
| `didit_vendor_user_update` | كتابة | `didit:management` | `write:users` | تحديث حقول الملف التعريفي للمستخدم. |
| `didit_vendor_user_update_status` | كتابة | `didit:management` | `write:users` | تعيين حالة المستخدم إلى `ACTIVE` أو `FLAGGED` أو `BLOCKED`. |
| `didit_vendor_user_delete` | إتلافي | `didit:management` | `delete:users` | حذف المستخدمين دفعة واحدة حسب `vendor_data`، أو حذف جميع المستخدمين. |
| `didit_vendor_business_list` | قراءة | `didit:verification` | `list:businesses` | قائمة الشركات الموثّقة مجمّعة حسب `vendor_data`. تشمل كل التطبيقات عند عدم تحديد نطاق. |
| `didit_vendor_business_create` | كتابة | `didit:verification` | `create:businesses` | إنشاء سجل شركة يدويًا. |
| `didit_vendor_business_get` | قراءة | `didit:verification` | `read:businesses` | شركة واحدة حسب `vendor_data`. |
| `didit_vendor_business_update` | كتابة | أيٌّ منهما | — | تحديث حقول الملف التعريفي للشركة. |
| `didit_vendor_business_update_status` | كتابة | `didit:verification` | `write:businesses` | تعيين حالة الشركة إلى `ACTIVE` أو `FLAGGED` أو `BLOCKED`. |
| `didit_vendor_business_delete` | إتلافي | `didit:verification` | `delete:businesses` | حذف الشركات دفعة واحدة حسب `vendor_data` أو المعرّف الداخلي، أو حذف جميع الشركات. |

***

## القوائم وقائمة الحظر وقائمة السماح

| الأداة | النوع | النطاق | إذن الدور | الوظيفة |
| - | - | - | - | - |
| `didit_lists_list` | قراءة | `didit:management` | `read:lists` | جميع القوائم في التطبيق: قوائم الحظر وقوائم السماح والقوائم المخصصة. |
| `didit_lists_create` | كتابة | `didit:management` | `create:lists` | إنشاء قائمة سماح أو قائمة مخصصة. |
| `didit_lists_get` | قراءة | `didit:management` | `read:lists` | قائمة واحدة بمعرّف UUID. |
| `didit_lists_update` | كتابة | `didit:management` | `write:lists` | إعادة تسمية قائمة أو تغيير وصفها. |
| `didit_lists_delete` | تدميري | `didit:management` | `delete:lists` | حذف قائمة وكل إدخالاتها. |
| `didit_lists_entries_list` | قراءة | `didit:management` | `read:lists` | الإدخالات الموجودة في قائمة واحدة. |
| `didit_lists_entry_create` | كتابة | `didit:management` | `create:lists` | إضافة إدخال إلى قائمة، بالقيمة أو من جلسة. |
| `didit_lists_entry_upload_face` | كتابة | `didit:management` | `create:lists` | إضافة وجه إلى قائمة وجوه من صورة، دون جلسة. |
| `didit_lists_entry_delete` | تدميري | `didit:management` | `delete:lists` | إزالة إدخال من قائمة. |
| `didit_blocklist_get` | قراءة | `didit:verification` | `read:blocklist` | عرض إدخالات قائمة الحظر (أداة مساعدة قديمة). |
| `didit_blocklist_add` | كتابة | `didit:verification` | `write:blocklist` | إضافة إدخال إلى قائمة الحظر (أداة مساعدة قديمة). |
| `didit_blocklist_remove` | تدميري | `didit:verification` | `write:blocklist` | إزالة إدخال من قائمة الحظر (أداة مساعدة قديمة). |
| `didit_allowlist_add` | كتابة | `didit:verification` | `write:blocklist` | إضافة إدخال إلى قائمة السماح (أداة مساعدة قديمة). |

***

## الحالات

| الأداة | النوع | النطاق | إذن الدور | الوظيفة |
| - | - | - | - | - |
| `didit_case_list` | قراءة | `didit:verification` | `list:cases` | عرض الحالات في تطبيق واحد. تشمل جميع التطبيقات عند عدم تحديد نطاق. |
| `didit_case_get` | قراءة | `didit:verification` | `read:cases` | حالة واحدة مع تفاصيلها. |
| `didit_case_create` | كتابة | `didit:verification` | `write:cases` | فتح حالة. |
| `didit_case_statistics` | قراءة | `didit:verification` | `list:cases` | أعداد الحالات حسب الحالة وإحصاءات مشابهة. |
| `didit_case_manage` | تدميري | `didit:verification` | `write:cases` | تعيين حالة أو حلها أو إعادة فتحها أو تصعيدها أو التعليق عليها أو تحديثها. |

***

## شبكات الاحتيال

| الأداة | النوع | النطاق | إذن الدور | الوظيفة |
| - | - | - | - | - |
| `didit_network_list` | قراءة | `didit:verification` | `list:networks` | عرض شبكات الاحتيال في تطبيق واحد، مع مرشحات وحدة التحكم ومؤشرات الأداء الرئيسية فيها. |
| `didit_network_get` | قراءة | `didit:verification` | `read:networks` | شبكة احتيال واحدة مع أعضائها وإشاراتها؛ المخطط والخريطة والجدول الزمني عند الطلب. |
| `didit_network_membership_get` | قراءة | `didit:verification` | `read:networks` | شبكات الاحتيال التي تنتمي إليها جلسة أو جلسة شركة أو مستخدم أو شركة أو معاملة. |

***

## Investigator

تظهر هذه الأدوات في `tools/list` لكل مستخدم مسجّل الدخول، لكنها لا تعمل إلا بعد تفعيل [Investigator](https://docs.didit.me/ar/console/investigator.md) لمؤسستك.

| الأداة | النوع | النطاق | إذن الدور | الوظيفة |
| - | - | - | - | - |
| `didit_investigator_queue_list` | قراءة | أيٌّ منهما | — | عرض تقارير Investigator المفتوحة في قائمة انتظار المراجعة، مع التوصية ودرجة ثقة كل تقرير. |
| `didit_investigator_report_get` | قراءة | أيٌّ منهما | — | تقرير Investigator واحد: التوصية والثقة والمخاطر والسرد والأدلة والسوابق والأسئلة. |
| `didit_investigator_record_get` | قراءة | أيٌّ منهما | — | أحدث مراجعة من Investigator لعملية تحقق واحدة أو معاملة واحدة، سواء كانت مفتوحة أو مُبتّ فيها. |
| `didit_investigator_accept` | تدميري | أيٌّ منهما | — | قبول توصية Investigator على عنصر واحد؛ يُبتّ في العنصر ويُسجَّل باسمك. |
| `didit_investigator_override` | تدميري | أيٌّ منهما | — | البت في عنصر واحد بإجراء آخر وفئة وسبب بدلاً من التوصية. |
| `didit_investigator_batch_accept` | تدميري | أيٌّ منهما | — | قبول ما يصل إلى 50 توصية جاهزة دفعة واحدة؛ يُتخطّى أي عنصر لا يمكن قبوله مع ذكر سببه. |
| `didit_investigator_add_note` | كتابة | أيٌّ منهما | — | إضافة معلومة عن عنصر في تقرير كملاحظة للفريق تقرؤها المراجعة التالية. |
| `didit_investigator_rereview` | تدميري | أيٌّ منهما | — | طلب من Investigator مراجعة عنصر من جديد؛ يحل التقرير الجديد محل التقرير المفتوح. |
| `didit_investigator_question_list` | قراءة | أيٌّ منهما | — | أسئلة السياسة التي يطرحها Investigator، من الأحدث إلى الأقدم. |
| `didit_investigator_question_get` | قراءة | أيٌّ منهما | — | سؤال سياسة واحد مع سجل الفريق خلال آخر 30 يومًا بشأن ذلك الموقف والإجابات الممكنة. |
| `didit_investigator_question_answer` | تدميري | أيٌّ منهما | — | الإجابة عن سؤال سياسة؛ تكتب معظم الإجابات إصدارًا جديدًا من السياسة. |
| `didit_investigator_question_dismiss` | تدميري | أيٌّ منهما | — | إغلاق سؤال سياسة دون إجابة. |
| `didit_investigator_backtest_start` | كتابة | أيٌّ منهما | — | بدء اختبار رجعي مجاني يعيد تشغيل السياسة الحالية على قرارات آخر 30 أو 90 يومًا. ولا يتخذ أي قرار. |
| `didit_investigator_backtest_get` | قراءة | أيٌّ منهما | — | اختبار رجعي محفوظ: مدى التوافق لكل قائمة انتظار ولكل مستوى ولكل حد. |
| `didit_investigator_performance_get` | قراءة | أيٌّ منهما | — | مدى توافق Investigator مع فريقك وحجم عمله والوقت الموفّر والتجاوزات خلال 7 أو 30 أو 90 يومًا. |
| `didit_investigator_dashboard_get` | قراءة | أيٌّ منهما | — | لوحة Investigator: الأتمتة خلال 30 يومًا، والسجل الأسبوعي، والإنفاق، والتجاوزات. |
| `didit_investigator_activity_list` | قراءة | أيٌّ منهما | — | سجل نشاط Investigator من الأحدث إلى الأقدم: ما قام به الوكيل والأشخاص. |

***

## التقارير وسجل التدقيق والتنبيهات

| الأداة | النوع | النطاق | إذن الدور | ما تفعله |
| - | - | - | - | - |
| `didit_report_list` | قراءة | أيهما | — | عرض تقارير التصدير. |
| `didit_report_get` | قراءة | أيهما | — | حالة تقرير تصدير واحد وتفاصيله. |
| `didit_report_get_download_url` | قراءة | أيهما | — | رابط تنزيل موقّع لتقرير مكتمل. |
| `didit_report_export` | كتابة | أيهما | — | بدء تصدير (الجلسات أو المعاملات أو المستخدمين أو الشركات). |
| `didit_audit_log_list` | قراءة | أيهما | — | إدخالات سجل التدقيق لتطبيق: من غيّر ماذا. |
| `didit_alert_list` | قراءة | `didit:management` | `read:applications` | التنبيهات المُعدّة لتطبيق. |
| `didit_alert_configure` | كتابة | `didit:management` | `write:applications` | إعداد تنبيه واحد حسب نوعه. |

***

## webhook

| الأداة | النوع | النطاق | إذن الدور | ما تفعله |
| - | - | - | - | - |
| `didit_webhook_list` | قراءة | `didit:management` | `read:webhooks` | وجهات webhook الخاصة بتطبيق. |
| `didit_webhook_create` | كتابة | `didit:management` | `write:webhooks` | إنشاء وجهة webhook. يُحجب سر التوقيع في الاستجابة، فانسخه من وحدة التحكم. |
| `didit_webhook_get` | قراءة | `didit:management` | `read:webhooks` | وجهة webhook واحدة، مع حجب سر التوقيع. |
| `didit_webhook_update` | تدميرية | `didit:management` | `write:webhooks` | تغيير عنوان URL للوجهة أو إصدارها أو مؤشر تفعيلها أو الأحداث المشترك فيها. |
| `didit_webhook_delete` | تدميرية | `didit:management` | `write:webhooks` | حذف وجهة webhook. |

***

## السوق

| الأداة | النوع | النطاق | إذن الدور | ما تفعله |
| - | - | - | - | - |
| `didit_marketplace_list_catalog` | قراءة | `didit:management` | `read:integrations` | سوق المزودين: تحليلات البلوكتشين وفحص AML ومزودو التحقق من رقم الهاتف والحسابات البنكية وشبكات Travel Rule، مع بيانات الاعتماد التي يحتاجها كل منها. |
| `didit_marketplace_list_connections` | قراءة | `didit:management` | `read:integrations` | اتصالات التطبيق في السوق وعضويات الشبكات، مع الحالة وآخر استخدام. لا تُعاد الأسرار أبدًا. |
| `didit_marketplace_request_integration` | كتابة | `didit:management` | `write:integrations` | طلب تكامل لا يزال غير متاح بالخدمة الذاتية؛ يتابع فريق Didit الطلب. |

***

## المؤسسة والأعضاء والفوترة والعلامة التجارية

تُعرَّف أداتان في هذه المجموعة (`didit_org_top_up` و`didit_org_reveal_application_api_key`) في الخادم لكنهما مخفيتان عن كتالوج كل مستدعٍ مصادَق عليه بـ OAuth؛ وتظهران فقط في خادم stdio محلي.

| الأداة | النوع | النطاق | إذن الدور | ما تفعله |
| - | - | - | - | - |
| `didit_org_list` | قراءة | أيهما | — | المؤسسات التي تنتمي إليها. |
| `didit_org_list_applications` | قراءة | أيهما | — | تطبيقات مؤسسة واحدة. |
| `didit_org_get_application` | قراءة | أيهما | — | تفاصيل التطبيق، مع حجب مفتاح API. |
| `didit_org_reveal_application_api_key` | تدميرية | أيهما | — | إرجاع مفتاح API الخام للتطبيق. يحتاج معرّفات صريحة و`confirm: true`. مخفية في الموصل المستضاف. |
| `didit_org_get_balance` | قراءة | `didit:management` | `read:subscription` | رصيد الائتمان وإعدادات إعادة الشحن التلقائي. |
| `didit_org_top_up` | تدميرية | أيهما | — | إنشاء جلسة دفع عبر Stripe لإضافة الرصيد. مخفية في الموصل المستضاف. |
| `didit_branding_get` | قراءة | `didit:management` | `read:customization` | العلامة التجارية (الشعارات والألوان) المطبقة على واجهة التحقق لديك. |
| `didit_branding_update` | كتابة | `didit:management` | `write:customization` | رفع صور جديدة للعلامة التجارية. |
| `didit_org_list_members` | قراءة | `didit:management` | `list:members` | أعضاء مؤسسة. |
| `didit_org_invite_member` | كتابة | `didit:management` | `write:members` | دعوة عضو عبر البريد الإلكتروني مع تحديد دور. |
| `didit_org_update_member` | كتابة | `didit:management` | `write:members` | تغيير دور عضو. |
| `didit_org_remove_member` | تدميرية | `didit:management` | `delete:members` | إزالة عضو من المؤسسة. |
| `didit_org_list_roles` | قراءة | `didit:management` | `list:roles` | الأدوار المتاحة في المؤسسة. |
| `didit_org_list_api_keys` | قراءة | `didit:management` | `read:applications` | بيانات وصفية لمفاتيح API مع حجب القيم الخام. |

***

## مدخلات الملفات

تقبل الأدوات التي تأخذ ملفًا (`didit_verify_id` و`didit_verify_poa` و`didit_verify_passive_liveness` و`didit_verify_face_match` و`didit_verify_face_search` و`didit_verify_age` و`didit_lists_entry_upload_face` و`didit_branding_update`) الملف بإحدى صيغتين:

* `*_base64`: محتوى الملف ضمن الطلب، كنص base64 خام أو كعنوان `data:` URL. استخدم هذه الصيغة مع endpoint المستضاف.
* `*_path`: مسار مطلق على الجهاز الذي يشغّل الخادم. يعمل فقط مع خادم stdio محلي يشارك نظام الملفات معك.

تفرض الصيغتان حدًا أقصى قدره 15 MB وقائمة سماح للبايتات السحرية (PNG وJPG وWebP وGIF وBMP وICO وPDF). وتقبل وسيلة النقل المستضافة أجسام JSON حتى 25 MB.

***

> [card] [أمثلة](https://docs.didit.me/ar/integration/mcp/examples.md)
>
> محادثات تستخدم هذه الأدوات من البداية إلى النهاية.

> [card] [متقدم](https://docs.didit.me/ar/integration/mcp/advanced.md)
>
> الأدوار وسلوك العمل عبر التطبيقات وسير العمل المتفرع وwebhook والاستضافة الذاتية.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.