MCP ٹولز

cc_server ایک ہی MCP (JSON-RPC 2.0) ٹول رجسٹری رکھتا ہے، جو مرکزی سرور پورٹ (ڈیفالٹ 9030) پر POST /mcp اور GET /sse کے ذریعے پیش کی جاتی ہے، پروٹوکول ورژن 2024-11-05۔ ہر کلائنٹ اِسی ایک رجسٹری تک پہنچتا ہے: ڈیسک ٹاپ، ویب بلڈ، بیرونی MCP کلائنٹس اور بلٹ اِن ایجنٹ رن ٹائم۔ بیرونی MCP سرورز کو ایک ڈائنامک تہہ کے طور پر اِسی رجسٹری میں پل بنایا جا سکتا ہے۔

رجسٹری کا حجم

پیمائش	تعداد
cc_server کی رجسٹر کردہ ٹولز	110
packages/cc_mcp سے	108
packages/cc_mcp_client سے (ٹول ڈسکوری)	2
بیس رجسٹری میں رجسٹر شدہ (server_mcp_registry.dart)	63
بوٹ کے بعد، سروسز کے آنے پر رجسٹر شدہ (cc_server_runtime.dart)	47
بیس رجسٹری کے 63 میں سے، کوڈ گراف ریپوزٹری پر مشروط	5

پانچ کوڈ گراف ٹولز صرف اُس وقت رجسٹر ہوتے ہیں جب ہوسٹ buildServerMcpRegistry کو کوئی کوڈ گراف ریپوزٹری دے۔ cc_server ہمیشہ ایک دیتا ہے، اس لیے بھیجے گئے بائنری میں سب 110 زندہ ہوتے ہیں۔

پوری رجسٹری tools/list میں بغیر کسی ڈسکوری گیٹنگ کے ظاہر کی جاتی ہے۔ ٹکٹ میں ترمیم ٹائپ شدہ ٹولز سے ہوتی ہے۔

بیرونی کلائنٹس ہمیشہ پورا کیٹلاگ دیکھتے ہیں

tools/list کبھی تراشا نہیں جاتا۔ MCP کلائنٹس ٹول کے نام اُسی فہرست کی اپنی کیشڈ نقل کے خلاف جانچتے ہیں اور سرور سے پوچھے بغیر ہر غیر درج نام سے انکار کر دیتے ہیں، چنانچہ وہاں چھپایا گیا ٹول محض خاموش نہیں بلکہ ناقابلِ رسائی ہوتا ہے۔

بلٹ اِن ہارنس مختلف ہے: یہ فی درخواست صرف تعریفوں کا ایک مقیم ذیلی مجموعہ لوڈ کرتا ہے اور باقی پہلی استعمال پر کھینچ لاتا ہے، جو ہارنس کی طرف کا رویہ ہے اور اِس رجسٹری کو نہیں بدلتا۔ دیکھیں ٹول کانٹیکسٹ اور پرامپٹ کیشنگ۔

ہر ٹول کلاس رجسٹر ہوتی ہے

packages/cc_mcp/lib/src/tools/ کے نیچے موجود سورس فائل وہ ٹول ہے جسے ایجنٹ کال کر سکتا ہے۔ packages/cc_server_core/test/mcp_tool_registration_ratchet_test.dart بلڈ کو ناکام کر دیتا ہے اگر کوئی نئی ٹول کلاس کسی چیز سے تعمیر نہ ہو رہی ہو۔

مشترک پیرامیٹرز

workspace_id

لازمی ہر اُس ٹول پر جو ورک اسپیس اسکوپ والا ڈیٹا چھوتا ہے۔ workspace_id غائب ہو یا غلط ہو تو واضح خرابی واپس آتی ہے، اور ایسی قدر جو ہدف ہستی کے ورک اسپیس سے میل نہ کھائے، خاموشی سے نظر انداز ہونے کے بجائے مسترد کر دی جاتی ہے۔ حقیقی طور پر گلوبل ٹولز پر اِسے چھوڑ دیں: list_workspaces اور چھ نیوز فیڈ ٹولز (list_feeds، list_articles، get_article، set_article_read، set_article_saved، refresh_feeds)، جو سرور کے مالک کی فی صارف فیڈ فہرست پر سوار ہوتے ہیں۔ ڈسکوری ٹولز (search_tool_bm25، list_my_tools) اِسے اختیاری طور پر لیتے ہیں تاکہ وہ گفتگو کے موڈ کے لحاظ سے قابلِ کال ہونے کی درجہ بندی کر سکیں۔ جب سرور کسی ایجنٹ کو ڈسپیچ کرتا ہے تو ورک اسپیس سرور کی طرف سے مسلط کر دیا جاتا ہے، اس لیے ایجنٹ کوئی بیرونی id دے کر کسی دوسرے ورک اسپیس تک نہیں پہنچ سکتا۔

ٹول ڈسکوری

دونوں cc_mcp سے نہیں بلکہ cc_mcp_client سے آتے ہیں اور دونوں موڈ گارڈ سے رجوع کرتے ہیں، اس لیے وہ بتاتے ہیں کہ موجودہ گفتگو کے موڈ میں کیا کال کرنا ممکن ہے۔

ٹول	تفصیل
search_tool_bm25	ٹول کیٹلاگ میں کلیدی لفظ سے تلاش کریں؛ مماثل ٹولز، اُن کے آرگومنٹ اسکیما اور یہ کہ ہر ایک اس وقت قابلِ کال ہے یا نہیں، واپس کرتا ہے
list_my_tools	اس گفتگو میں اس وقت قابلِ کال ٹولز کی فہرست دیں، جو اُس کے موڈ سے فلٹر شدہ ہو

تیسرا ڈسکوری ٹول، search_tools، صرف بلٹ اِن ہارنس کے اندر موجود ہے اور اِس MCP رجسٹری کا حصہ نہیں۔ یہ رن کی اپنی ٹول سطح کی درجہ بندی کرتا ہے اور search_tool_bm25 کے برعکس جو کچھ ملے اُس کے اسکیما لوڈ کر لیتا ہے تاکہ ایجنٹ اپنی اگلی باری میں کسی مماثل ٹول کو کال کر سکے۔ ہارنس پر چلنے والے ایجنٹس کو اِسی کو ترجیح دینی چاہیے؛ MCP کلائنٹس کے پاس search_tool_bm25 ہے۔

ایجنٹ ٹولز

ٹول	تفصیل
list_agents	کسی ورک اسپیس میں رجسٹر شدہ ایجنٹس کی فہرست دیں

ایجنٹس کے درمیان پیغام رسانی اور تفویض

ایجنٹس اسپیسز کے ذریعے ایک دوسرے سے بات کرتے ہیں (پائیدار، روسٹر پر نظر آنے والے)۔ ask_agent درخواست/جواب ہے جس کی ٹائم آؤٹ لازمی ہے؛ delegate_task سرور کی طرف سے گہرائی کی حد، چکر کی شناخت، بجٹ لفافے اور خود مختاری کی چھت سے محفوظ کیا جاتا ہے۔

ٹول	تفصیل
send_to_agent	کسی دوسرے ایجنٹ کو یک طرفہ پیغام بھیجیں، جسے to_agent_id یا بالکل درست to_agent_name سے مخاطب کیا گیا ہو
ask_agent	کسی دوسرے ایجنٹ سے سوال پوچھیں اور اس کا جواب یا ٹائم آؤٹ کا انتظار کریں
delegate_task	کسی کام کو ٹریک ہونے والے ذیلی ٹکٹ کے طور پر دوسرے ایجنٹ کو تفویض کریں
consult_agent	مہارتوں کے لحاظ سے بہترین مماثل ماہر کو اسپیس میں شامل کریں اور اسے ایک مرکوز بریف کے ساتھ ڈسپیچ کریں
todo_read	اس گفتگو کی محفوظ شدہ ٹاسک چیک لسٹ پڑھیں

مہارت کے ٹولز

ہر انسٹال اور اپ ڈیٹ ایک ناکامی پر بند اسکین گیٹ سے گزرتا ہے، اس سے پہلے کہ مہارت کا کوئی مواد ڈسک یا ایجنٹ کے پرامپٹ تک پہنچے۔

ٹول	تفصیل
list_skills	کسی ورک اسپیس میں دستیاب مہارت کے سلگس کی فہرست دیں
create_skill	مارک ڈاؤن مواد سے ایک نئی مہارت بنائیں
install_skill	کسی مہارت کی پوری ڈائریکٹری کسی GitHub ریپوزٹری سے پن شدہ ref پر انسٹال کریں
update_skill	انسٹال شدہ GitHub مہارت کو نئے ref پر اپ ڈیٹ کریں، دوبارہ اسکین اور دوبارہ پن کرتے ہوئے
list_skill_updates	ایسی مہارتوں کی فہرست دیں جن کا نیا ورژن دستیاب ہو
verify_skills	لاک شدہ مہارتوں کو ڈسک پر موجود مواد کے ہیشز کے خلاف جانچیں
pin_skill	ڈسک پر موجود کسی مہارت کو ہیش کر کے skills-lock.json میں درج کریں

پلان، پلے بک اور آرٹی فیکٹ ٹولز

ٹول	تفصیل
submit_plan	پلان موڈ کا آؤٹ پٹ معاہدہ: ایک ٹائپ شدہ PlanDocument جاری کریں جو Plan Studio میں کھلتا ہے
create_playbook	کسی پلان کو ٹائپ شدہ {{param}} پلیس ہولڈرز کے ساتھ ایک نامزد، ورژن شدہ ٹیمپلیٹ کے طور پر محفوظ کریں
run_playbook	کسی پلے بک کو پیرامیٹر قدروں کے ساتھ وجود میں لائیں، جس سے ایک پلان بنے جسے آپریٹر منظور کرتا ہے
publish_artifact	ٹائپ شدہ بلاکس کی ایک ترتیب وار فہرست (مارک ڈاؤن، ٹیبل، چارٹ، mermaid، کوڈ، JSON) شائع کریں جو کلائنٹ میں نیٹو طور پر رینڈر ہو
revise_artifact	کسی شائع شدہ آرٹی فیکٹ کا مواد بدل دیں
list_artifacts	ورک اسپیس کے آرٹی فیکٹس کی فہرست دیں
get_artifact	ایک آرٹی فیکٹ پڑھیں
complete_goal	گفتگو کے فعال پائیدار ہدف (جو /goal یا /loop سے شروع ہوا) کو حاصل شدہ قرار دیں

ورک اسپیس ٹولز

ٹول	تفصیل
list_workspaces	تمام ورک اسپیسز کو اُن کی ids اور ناموں کے ساتھ درج کریں (گلوبل؛ کوئی workspace_id نہیں)

ریپو ٹولز

ٹول	تفصیل
list_repos	کسی ورک اسپیس میں رجسٹر شدہ ریپوز کی فہرست دیں۔ ایجنٹ کالرز کو اُن کی گفتگو کے الگ تھلگ کاپی آن رائٹ worktree پاتھز ملتے ہیں، اصل چیک آؤٹ کبھی نہیں

پیغام رسانی کے ٹولز

ٹول	تفصیل
list_spaces	کسی ورک اسپیس میں پیغام رسانی کے اسپیسز کی فہرست دیں
get_messages	کسی اسپیس سے پیغامات حاصل کریں
send_message	ایک اسپیس کو نامزد بھیجنے والے ایجنٹ کے طور پر پیغام بھیجیں
get_space_notes	کسی اسپیس کی مشترکہ حوالگی دستاویز پڑھیں
update_space_notes	کسی اسپیس کی مشترکہ حوالگی دستاویز بدل دیں
todo_write	اس گفتگو کی ٹاسک چیک لسٹ ایک ہی کال میں بدل دیں (پوری فہرست پاس کریں)

ریویو ٹولز

ٹول	تفصیل
start_ai_review	کسی PR کے لیے AI ریویو شروع کریں: ریویو کے شعبے شمار کریں، ماہر ریویوورز کو PR اسپیس میں پھیلائیں، واک تھرو تصنیف کریں اور حتمی شکل دیں
add_review_node	ریویو اسپیس میں ایک ساختی ریویو نتیجہ (فائل، لائن، P0–P3 ترجیح) شامل کریں
confirm_review_node	کسی ہم مرتبہ کا نتیجہ تصدیق کریں؛ مصنف خود تصدیق نہیں کر سکتا
resolve_review_node	تبدیلی واقعی کرنے کے بعد کسی نتیجے کو حل شدہ قرار دیں؛ ریویو اسپیس میں ایک نشان پوسٹ کرتا ہے
dismiss_review_node	ایسے نتیجے کو مسترد کریں جو لاگو نہ ہوتا ہو؛ ایک سرکشی کا فیکٹ ریکارڈ کرتا ہے تاکہ ریویوورز اسے دوبارہ نشان زد کرنا بند کر دیں
request_peer_review	کسی نتیجے پر دوسری نظر کے لیے کسی دوسرے ریویوور ایجنٹ سے کہیں
dispatch_reviewers	مماثل ریویوور ایجنٹس کو بیک وقت ایک ریویو اسپیس میں ڈسپیچ کریں
submit_reviewer_verdict	فی ریویوور ship/hold/block فیصلہ اعتماد اور وضاحت کے ساتھ پوسٹ کریں
finalize_review	فی نوڈ اتفاقِ رائے اور فی PR فیصلہ شمار کریں اور ریویو بند کریں
set_cohort_summary	کسی ریویو کوہارٹ کا آسان زبان والا خلاصہ سیٹ کریں
add_review_diagram	کسی کوہارٹ کے ساتھ ایک ساختی، گراف سے تصدیق شدہ خاکہ (sequence، entityRelation، stateMachine) منسلک کریں
publish_review_to_github	حتمی ریویو GitHub پر ان لائن تبصروں کے ساتھ ایک خلاصہ باڈی کی صورت میں شائع کریں

میموری ٹولز

ٹول	تفصیل
search_memory	فیکٹس اور پالیسیوں میں تلاش کریں (کلیدی لفظ، سیمنٹک یا ہائبرڈ — ہائبرڈ ڈیفالٹ ہے)
propose_fact	کسی ڈومین میں ایک مختصر مارک ڈاؤن فیکٹ محفوظ کریں
supersede_fact	ایک فیکٹ کو کسی دوسرے سے منسوخ شدہ قرار دیں
propose_policy	کسی ڈومین میں ایک معیاری قاعدہ محفوظ کریں (اس پر لکھنے کی اجازت درکار ہے)
supersede_policy	ایک پالیسی کو ریٹائر کریں — اسے غیر فعال نشان زد کرتا ہے مگر آڈٹ کے لیے رکھتا ہے
list_policies	فعال پالیسیوں کی فہرست دیں، اختیاری طور پر ڈومین سے فلٹر شدہ
list_memory_domains	ورک اسپیس کے میموری ڈومینز کو فیکٹ اور پالیسی کے شمار کے ساتھ درج کریں
record_observation	ایجنٹ کی ورکنگ میموری میں ایک خام مشاہدہ ریکارڈ کریں
get_my_notes	کال کرنے والے ایجنٹ کی ورکنگ میموری کا اسکریچ پیڈ پڑھیں
update_my_notes	کال کرنے والے ایجنٹ کی ورکنگ میموری کا اسکریچ پیڈ اپ ڈیٹ کریں
remember	اس سیشن کے لیے ایجنٹ کی ہاٹ ورکنگ میموری میں ایک نوٹ شامل کریں (TTL اور گنتی سے محدود)
consolidate_memory	ایک استحکام (“نیند”) پاس چلائیں: میعاد ختم ہو چکے ہاٹ آئٹمز نکالیں اور پائیدار آئٹمز کو طویل مدتی فیکٹس میں ڈھالیں
harmonize_memory	ایجنٹس کے درمیان یقین کی تطبیق (SHMR) چلائیں اور تضادات نشان زد کریں
list_memory_conflicts	شناخت شدہ تضادات اور یہ کہ ہر ایک کیسے حل ہوا، کی فہرست دیں

گورننس ٹولز

ٹول	تفصیل
create_goal	ایک تنظیمی ہدف بنائیں (کمپنی، ٹیم، ایجنٹ یا ٹاسک کی سطح)
list_goals	اہداف کو سطح، حیثیت اور مجموعی پیش رفت کے ساتھ درج کریں
update_goal_progress	کسی ہدف کی پیش رفت سیٹ کریں
create_approval	کسی زیرِ انتظام ایکشن (پلان سے اخراج، مرج، ریلیز، بھرتی، حسب ضرورت) کے لیے بورڈ منظوری کھولیں
list_approvals	منظوریوں کی فہرست دیں، اختیاری طور پر حیثیت سے فلٹر شدہ
decide_approval	ایک فیصلہ ریکارڈ کریں: منظور کریں، مسترد کریں، نظرثانی طلب کریں، یا دوبارہ جمع کرائیں
comment_approval	کسی بورڈ منظوری پر تبصرہ کریں
exit_plan_mode	ایک plan_exit منظوری کھولیں (اور منظوری ملنے پر استعمال کریں)، جو گفتگو کو پلان موڈ سے باہر منتقل کر دیتی ہے
agent_heartbeat	زندہ ہونے کی اطلاع دیں (فعال، بیکار، پھنسا ہوا)؛ خاموش ہو جانا رن ٹائم ہیلتھ کو پہلے حال ہی میں گم شدہ اور پھر آف لائن کر دیتا ہے
list_runtime_health	ہر ایجنٹ کی رن ٹائم ہیلتھ درج کریں
list_agent_presence	ہر ایجنٹ کی موجودگی درج کریں (ہیلتھ، لائف سائیکل، چل رہے اور قطار میں شمار، گنجائش)
get_org_chart	رپورٹنگ درخت پڑھیں، جس کی جڑ پر CEO ہو اور جو reports_to سے نیسٹ ہو
create_work_product	کسی ٹکٹ سے منسلک ایک پائیدار ڈیلیوریبل بنائیں
save_work_product_revision	ایک نئی ریویژن محفوظ کریں؛ ہم وقتی ترمیم پر مسترد ہونے کے لیے base_revision_id پاس کریں
list_work_products	ورک پراڈکٹس کی فہرست دیں، اختیاری طور پر ایک ٹکٹ تک فلٹر شدہ
get_work_product	ایک ورک پراڈکٹ کو اس کی ریویژن تاریخ کے ساتھ پڑھیں
create_runtime_profile	ایک دوبارہ قابلِ استعمال رن ٹائم پروفائل بیان کریں (پروٹوکول خاندان، CLI کمانڈ، مقرر لانچ آرگومنٹس)
list_runtime_profiles	ورک اسپیس کے رن ٹائم پروفائلز کی فہرست دیں

کوڈ گراف ٹولز

صرف اُس وقت رجسٹر ہوتے ہیں جب ہوسٹ کوئی کوڈ گراف ریپوزٹری فراہم کرے۔ انڈیکس بھیجے گئے گرامر سیٹ پر محیط ہے (Dart، JS/TS، PHP، Python، Rust، Zig، C/C++، Go، Java، Ruby، C#، Swift، Kotlin، R، Assembly، MATLAB، Ada)؛ کسی بھی دوسری زبان کے سمبل موجود نہیں ہوتے۔

ٹول	تفصیل
search_code	انڈیکس شدہ سمبلز کو نام، سگنیچر اور ڈاک تبصرے سے تلاش کریں (ہائبرڈ BM25 + سیمنٹک)
code_symbol	سمبلز کو بالکل درست نام سے دیکھیں؛ file:line اور سگنیچر واپس کرتا ہے
code_callers	وہ سمبلز درج کریں جو کسی سمبل کو کال کرتے یا اُس پر منحصر ہیں (آنے والے کنارے)
code_callees	وہ سمبلز درج کریں جنہیں کوئی سمبل کال کرتا یا جن پر منحصر ہے (جانے والے کنارے)
code_impact	کسی سمبل کے منتقلی اثر کا دائرہ ایک گہرائی تک شمار کریں

ٹکٹنگ ٹولز

ٹول	تفصیل
create_ticket	کنفیگر شدہ فراہم کنندہ پر ایک ٹکٹ بنائیں
get_ticket	ایک ٹکٹ id سے حاصل کریں
list_tickets	ٹکٹس کی فہرست دیں، اختیاری طور پر حیثیت یا تفویض کنندہ سے فلٹر شدہ
update_ticket	حیثیت، عنوان، تفصیل، ترجیح یا لیبلز اپ ڈیٹ کریں (حیثیت in_progress / completed جیسے متبادل نام قبول کرتی ہے)
assign_ticket	ایک ٹکٹ کسی ایجنٹ اور/یا ٹیم کو تفویض کریں
reassign_ticket	ایک ٹکٹ کسی دوسرے ایجنٹ کو دوبارہ تفویض کریں
add_ticket_collaborator	کسی ایجنٹ کو ٹکٹ پر تعاون کے لیے مدعو کریں (اس کے اسپیس میں شامل کیا جاتا ہے)
comment_on_ticket	کسی ٹکٹ پر تبصرہ کریں
close_ticket	ایک ٹکٹ بند کریں (اسے مکمل نشان زد کرتا ہے)، اختیاری آؤٹ پٹ کے ساتھ
fail_ticket	ایک ٹکٹ کو خرابی کے پیغام کے ساتھ ناکام نشان زد کریں
delegate_ticket	ایک ٹکٹ کسی ایجنٹ کو تفویض کریں، جس سے ایک ٹریک ہونے والا ٹکٹ بنتا ہے
ticket_pr_link	PR نوڈ id سے کسی ٹکٹ اور pull request کو لنک یا اَن لنک کریں (action: link | unlink)
ticket_relation	دو ٹکٹوں کے درمیان تعلق شامل یا ہٹائیں — blocked_by، blocking، related_to، duplicate_of، duplicated_by، sub_issue_of، parent_of (action: add | remove)
list_ticket_relations	کسی ٹکٹ کے پیرنٹ، ذیلی مسائل اور انحصار کے لنکس درج کریں

ٹیم اور پائپ لائن ٹولز

ٹول	تفصیل
record_team_activity	کسی ٹکٹ کے خلاف ٹیم لیڈر کی ایکٹیویٹی اندراج ریکارڈ کریں
preview_trigger	ڈرائی رن کریں کہ کوئی فرضی ایونٹ کون سے پائپ لائن رنز شروع کرے گا، بغیر کچھ کمٹ کیے
submit_output	کالر کے موجودہ پائپ لائن رن کے لیے ساختی آؤٹ پٹ پیلوڈ جمع کرائیں؛ رن کے اعلان کردہ آؤٹ پٹ اسکیما کے خلاف جانچا جاتا ہے

آرکیسٹریشن ٹولز

ٹول	تفصیل
propose_orchestration	ایک پیشگی منظوری کے لیے ایک ساختی کثیر ایجنٹ آرکیسٹریشن پلان جاری کریں؛ جانچ کرتا ہے اور کوئی خلاف ورزی ہو تو واپس کرتا ہے

نیوز فیڈ ٹولز

ٹول	تفصیل
list_feeds	رجسٹر شدہ RSS/Atom فیڈز کی فہرست دیں
list_articles	مضامین کی فہرست دیں، اختیاری طور پر فیڈ، غیر پڑھے یا محفوظ سے فلٹر شدہ
get_article	ایک مضمون حاصل کریں
set_article_read	کسی مضمون کو پڑھا یا غیر پڑھا نشان زد کریں
set_article_saved	کسی مضمون کو محفوظ یا غیر محفوظ کریں
refresh_feeds	ہر فعال فیڈ ابھی دوبارہ حاصل کریں

انکلوژر (رگ) ٹولز

رن کے اندر سے ضائع ہونے والی مشینیں چلائیں — ایک انکلوژر براؤزر یا Linux ڈیسک ٹاپ، ایک Android ایمولیٹر یا ایک iOS سمیولیٹر۔ بوٹ کے بعد، بغیر کسی شرط کے رجسٹر ہوتے ہیں: کوئی مشین واقعی بوٹ ہو سکتی ہے یا نہیں، یہ ایک پروب سوال ہے جس کا جواب ٹولز فی کال دیتے ہیں۔ ایک گفتگو میں دہرائی گئی کالیں ایک ہی مشین دوبارہ استعمال کرتی ہیں؛ اسکرین شاٹس تصویری مواد کے طور پر واپس آتے ہیں جس میں فی نتیجہ ایک تصویر کا بجٹ ہوتا ہے، اور نکالا گیا صفحہ/UI مواد ناقابلِ اعتماد ڈیٹا کے طور پر باڑ میں بند کر دیا جاتا ہے۔ چار یوز ٹولز کے ساتھ rig_close بھی enclosureControl ایکشن کلاس کا اعلان کرتے ہیں (یوز ٹولز networkEgress اور processSpawn بھی بتاتے ہیں؛ mobile_use اور ios_use packageInstall بھی بتاتے ہیں)، اس لیے صرف پڑھنے والے موڈز اُن سے انکار کر دیتے ہیں۔ rig_list کوئی اعلان نہیں کرتا — وہ صرف ورک اسپیس کی حالت پڑھتا ہے۔ فی سطح فعل کی مکمل ذخیرہ الفاظ رگز حوالہ میں ہے۔

ٹول	تفصیل
computer_use	انکلوژر VM میں Linux ڈیسک ٹاپ چلائیں: حرکت، کلک، ڈریگ، اسکرول، ٹائپ، ری سائز، کلپ بورڈ، اسکرین شاٹ
browser_use	ہیڈلیس Chromium، Firefox یا WebKit چلائیں (engine): نیویگیٹ، کلک، فل، ایکسٹریکٹ (a11y/DOM/console)، کلپ بورڈ، اسکرین شاٹ
mobile_use	ADB کے ذریعے Android چلائیں: معائنہ/اِن پٹ، اسکرین شاٹس، ایپس کی انسٹال/شروع/روکیں/ری سیٹ/اَن انسٹال، ڈیپ لنکس اور argv کی شکل والی ڈیوائس کمانڈز
ios_use	WebDriverAgent/CoreSimulator کے ذریعے iOS سمیولیٹر چلائیں: معائنہ/اِن پٹ، اسکرین شاٹس، ایپس کی انسٹال/شروع/روکیں/اَن انسٹال، ڈیپ لنکس اور argv کی شکل والے سمیولیٹر پراسیس
rig_list	کسی ورک اسپیس کے رگز سطح، حیثیت، ڈسپلے سائز اور کنٹرولر کے ساتھ درج کریں
rig_close	ایک رگ کو تباہ کریں اور اس کی ملکیت والی مشین کی حالت ضائع کر دیں

جو MCP پر پیش نہیں کیے جاتے

کیلنڈر اور میٹنگز کے پاس کوئی MCP ٹول نہیں۔ ایجنٹس آپ کا کیلنڈر، میٹنگز، ٹرانسکرپٹس، ایکشن آئٹمز یا فیصلے نہیں پڑھ سکتے۔ وہ خلاصہ جو ایکشن آئٹمز اور فیصلے پیدا کرتا ہے، بلٹ اِن meeting_summary پائپ لائن کے طور پر چلتا ہے، نہ کہ کسی ایسے ٹول کے طور پر جسے ایجنٹ کال کر سکے۔

موڈ کے لحاظ سے ٹول گیٹنگ

گیٹنگ ایک ہی ٹیبل (ModeToolPolicy) سے دو بار نافذ کی جاتی ہے: ایک بار Claude Code اڈاپٹر کے MCP ڈسپیچر میں اور ایک بار بلٹ اِن ہارنس رجسٹری میں۔ روکی گئی کال وجہ واپس کرتی ہے۔

موڈ	ٹول سطح
chat	ہر رجسٹر شدہ ٹول؛ کوئی اجازت فہرست نہیں
plan	ایک چنی ہوئی اجازت فہرست۔ worktree میں کوئی تحریر نہیں اور نہ create / assign / delegate ٹکٹ فعل، مگر میموری، آرٹی فیکٹس، ٹوڈوز، submit_plan، exit_plan_mode اور ڈسپیچ شدہ ٹکٹ پر ٹکٹ مکمل کرنے والے فعل کی اجازت ہے
review	ایک چنی ہوئی اجازت فہرست: ریویو میں شرکت، مواصلات، صرف پڑھنے والے کانٹیکسٹ حاصل کرنے والے اور ٹکٹ فعل کا پورا مجموعہ، بشمول create_ticket اور assign_ticket
orchestrate	ایک چنی ہوئی اجازت فہرست: تحقیق اور پڑھنے کے ٹولز نیز propose_orchestration، create_playbook اور run_playbook۔ بھرتیاں، تجزیہ اور ٹکٹ کی تکمیل منظوری کے بعد متعیّن انداز میں ہوتی ہیں، کبھی رن کے دوران نہیں

ہر موڈ میں اجازت یافتہ، اجازت فہرست سے قطع نظر:

مجموعہ	ٹولز
میموری اور آرٹی فیکٹس	search_memory، propose_fact، propose_policy، supersede_fact، supersede_policy، record_observation، update_my_notes، get_my_notes، list_memory_domains، list_policies، publish_artifact، revise_artifact، list_artifacts، get_artifact
کوڈ گراف	search_code، code_symbol، code_callers، code_callees، code_impact
رن میکینکس	search_tool_bm25، list_my_tools، todo_write، todo_read

کسی اجازت فہرست میں ہونا کسی ٹول کو قابلِ کال نہیں بنا دیتا، اور اُلٹا بھی سچ ہے: آپریٹر سے سوال کرنے کی صلاحیت ایک ہارنس ٹول (ask_user) ہے، اس لیے یہ اِس MCP کیٹلاگ میں سرے سے کبھی ظاہر نہیں ہوتی۔

منظوری گیٹ والے ٹولز

کوئی ٹول requiresApproval کا اعلان کر سکتا ہے۔ پھر ڈسپیچر ٹول چلنے سے پہلے ایک ApprovalPayload بناتا ہے اور اسے ConfirmationPort کے ذریعے سامنے لاتا ہے؛ cc_server اُس پورٹ کو وائر کرتا ہے، اس لیے گیٹ فعال ہے۔

اِس کا اعلان کرنے والے رجسٹر شدہ ٹولز: create_ticket، update_ticket، assign_ticket، reassign_ticket، close_ticket، ticket_relation، create_goal، update_goal_progress، create_approval، decide_approval، comment_approval، create_work_product، save_work_product_revision، create_runtime_profile، install_skill، update_skill۔

اِس سے الگ، متحد ایکشن گارڈریلز ہر اُس ٹول کو گیٹ کرتے ہیں جو خالی نہ ہونے والا ActionClass مجموعہ بتائے۔ کوئی prompt فیصلہ جس کے ساتھ کوئی منظور کنندہ جڑا نہ ہو، مسترد کر دیا جاتا ہے۔ دیکھیں گارڈریلز۔

وہ صلاحیتیں جن کے پیچھے کوئی ٹول نہیں

پروڈکٹ کی ہر صلاحیت ایجنٹ کی پہنچ میں نہیں۔ اِن کے پیچھے سرے سے کوئی ٹول نہیں، اس لیے کوئی ایسا نام جس کا حوالہ آپ نے کہیں اور دیکھا ہو، “unknown tool” واپس کرتا ہے:

صلاحیت	یہ بجائے اس کے کہاں رہتی ہے
ایجنٹ کی بھرتی، برطرفی یا ترمیم	ایجنٹس UI۔ کوئی hire_agent / fire_agent / update_agent ٹول نہیں ہے
ورک اسپیس بنانا	RPC پر workspace.upsert، جو سیڈ کرتا اور ملکیت کی مہر لگاتا ہے
پروجیکٹس (بنانا / فہرست / اپ ڈیٹ / فائل کرنا)	ٹکٹس UI۔ پروجیکٹس ایک آپریٹر سطح ہیں — دیکھیں پروجیکٹس
آپریٹر سے کوئی رکاوٹ ڈالنے والا سوال پوچھنا	ہارنس کا ask_user ٹول، نہ کہ MCP۔ یہ گفتگو میں ایک فارم رینڈر کرتا ہے اور جواب پر رک جاتا ہے
فی ایجنٹ تشخیص	کچھ نہیں۔ کوئی doctor نہیں ہے — دیکھیں ایجنٹ کی تشخیص
کیلنڈر اور میٹنگز	صرف انسانی کلائنٹس کے لیے RPC (اوپر دیکھیں)

مزید دیکھیں

• MCP سرور استعمال کریں
• موڈز
• گارڈریلز