MCP سرور

NETTS اپنی دستاویزات کو ایک MCP سرور کے طور پر شائع کرتا ہے، تاکہ ایک AI ایجنٹ اندازے لگانے یا 700 KB کے ٹیکسٹ ڈمپ پر انحصار کرنے کے بجائے خود ان دستاویزات اور API کی تفصیلات کو تلاش کر سکے۔

https://doc.netts.io/mcp

سرور صرف پڑھنے کے لیے (read-only) ہے۔ یہ آپ کے اکاؤنٹ، کیز (keys) یا بیلنس کے بارے میں کچھ نہیں جانتا — صرف وہی جو اس سائٹ پر شائع ہوا ہے۔

ایک دوسرا، الگ سرور AI ایجنٹس کے لیے NETTS سے براہ راست رابطہ ہے:

https://doc.netts.io/feedback/mcp

صرف دستاویزات کے بارے میں ہی نہیں۔ یہ پوچھیں کہ سروس درحقیقت کیسا برتاؤ کرتی ہے، کوئی اینڈ پوائنٹ حقیقت میں کیا لوٹاتا ہے، عملی طور پر TRON Energy، Bandwidth، ڈیلیگیشن اور اسٹیکنگ کیسے کام کرتے ہیں، TRC-20 اور دیگر اسمارٹ معاہدوں کے ساتھ کس طرح تعامل (interact) کیا جائے۔ غلطیوں کی اطلاع دیں، خصوصیات تجویز کریں، سیکیورٹی سے متعلق خدشات اٹھائیں۔ ایک انسان اسے پڑھتا ہے اور جواب لکھتا ہے۔

جان بوجھ کر ایک کے بجائے دو سرور رکھے گئے ہیں۔ دستاویزات کا سرور صرف پڑھنے کے لیے (read-only) رہتا ہے، تاکہ میزبان ماڈل کو آزادانہ طور پر دستاویزات تلاش کرنے کی اجازت دے سکے؛ اس دوسرے سرور کے سائیڈ ایفیکٹس ہیں — یہ آپ کے متن کو محفوظ کرتا ہے اور لوگوں کو دکھاتا ہے — اور اسے کال کرنے سے پہلے صارف سے اجازت لینی چاہیے۔

ایجنٹ کو کیا ملتا ہے

ٹول	یہ کیا کرتا ہے
search_docs	دستاویزات کے صفحات پر مکمل متنی تلاش (Full-text search)
get_doc	ایک صفحے کا مکمل Markdown
list_docs	ہر صفحے کا انڈیکس
search_api	NETTS API v2 کے آپریشنز تلاش کریں
get_endpoint	کسی ایک آپریشن کے پیرامیٹرز، اسکیمات، جوابات اور ایرر کوڈز
get_openapi_schema	تصریح (specification) سے دوبارہ قابلِ استعمال اسکیمہ

بلاگ کو جان بوجھ کر انڈیکس نہیں کیا گیا ہے: وہ مضامین انسانوں کے لیے ہیں، اور ایک ایجنٹ کے لیے وہ شور (noise) ہیں۔

NETTS سے پوچھنا

کوئی بھی چیز جو دستاویزات میں واضح نہ ہو۔ ایک انسان اسے پڑھتا ہے اور جواب لکھتا ہے؛ کچھ بھی خودکار طور پر تیار نہیں کیا جاتا، اور آپ کی بھیجی گئی کوئی بھی چیز خود بخود سروس یا دستاویزات کو تبدیل نہیں کرتی۔

ٹول	یہ کیا کرتا ہے
ask_netts	NETTS کے عملے کو سوال، رپورٹ یا تجویز بھیجتا ہے، feedback_id اور access_token لوٹاتا ہے
get_answer	اسٹیٹس اور، ایک بار لکھے جانے کے بعد، جواب لوٹاتا ہے

ایک kind منتخب کریں تاکہ پیغام صحیح شخص تک پہنچ سکے:

kind	اس کے لیے استعمال کریں
question	سروس کیسے کام کرتی ہے، اینڈ پوائنٹ حقیقت میں کیا لوٹاتا ہے، TRON Energy اور Bandwidth، ڈیلیگیشن، اسٹیکنگ، TRC-20 اور دیگر معاہدے
documentation_error	صفحے پر کوئی چیز غلط ہے
missing_information	کوئی اہم بات سرے سے درج ہی نہیں ہے
suggestion	سروس یا API کو بہتر بنانے کے لیے کوئی خیال
security	سیکیورٹی سے متعلق کوئی تشویش یا سفارش

یہ کیسے کام کرتا ہے:

1. ask_netts کو اپنے پیغام، ایک بے ترتیب (random) idempotency_key، اور — جب سوال کسی مخصوص صفحے یا آپریشن کے بارے میں ہو — doc_path یا operation_id کے ساتھ کال کریں۔ ان کی تصدیق شائع شدہ ریلیز کے مقابلے میں کی جاتی ہے، لہذا وہی ویلیوز استعمال کریں جو دستاویزات کے سرور نے آپ کو دی ہیں؛ عام سوالات کے لیے انہیں چھوڑ دیں۔
2. آپ کو ایک feedback_id، ایک access_token، جواب کا تخمینہ شدہ وقت اور poll_after_seconds واپس ملتے ہیں۔ ٹوکن کو سنبھال کر رکھیں: جواب حاصل کرنے کے لیے یہی واحد چابی ہے۔
3. بعد میں get_answer کے ساتھ واپس آئیں۔ جب تک کسی انسان نے جواب نہ دیا ہو، اسٹیٹس new یا in_review ہوگا۔

اسی باڈی کے ساتھ وہی idempotency_key دوبارہ بھیجنے سے نیا ریکارڈ بنانے کے بجائے وہی ریکارڈ واپس ملتا ہے، لہذا کنکشن منقطع ہونے پر کوئی نقصان نہیں ہوتا۔

اسے کال کرنے سے پہلے۔ یہ متن NETTS کے عملے کے پاس جاتا ہے۔ پہلے صارف سے پوچھیں، اور کبھی بھی API کیز، خفیہ معلومات، ذاتی یا اکاؤنٹ کا ڈیٹا شامل نہ کریں: کسی اکاؤنٹ کی ضرورت نہیں، جواب اسی کو ملتا ہے جس کے پاس رسائی ٹوکن (access token) ہو، اور اسی وجہ سے جواب میں کبھی بھی نجی یا اکاؤنٹ سے مخصوص معلومات شامل نہیں ہوتیں۔ کسی مخصوص اکاؤنٹ یا آرڈر سے متعلق کسی بھی چیز کے لیے، عام سپورٹ چینلز استعمال کریں۔

کوئی ویب ہکس (webhooks) نہیں ہیں: آپ خود جواب حاصل کرتے ہیں۔ کسی اکاؤنٹ کی ضرورت نہیں، اور چینل ریٹ لمیٹڈ (rate-limited) ہے۔ غلط استعمال روکنے کے لیے درخواستیں IP ایڈریس کے ساتھ لاگ کی جاتی ہیں؛ لاگز 90 دن تک رکھے جاتے ہیں۔

مربوط کریں

Cursor اور VS Code — کسی بھی دستاویز کے صفحے کے اوپری حصے میں موجود مینو میں Connect to Cursor اور Connect to VS Code والے آئٹمز استعمال کریں۔ وہ ایک کلک میں سرور انسٹال کر دیتے ہیں۔

Claude Code

claude mcp add --transport http netts-docs https://doc.netts.io/mcp

کوئی دوسری چیز — ٹرانسپورٹ Streamable HTTP ہے، بغیر تصدیق (no authentication) کے۔ دونوں سرورز شامل کریں: دستاویزات والا سرور، اور اگر آپ سوالات پوچھنے کی صلاحیت چاہتے ہیں تو فیڈ بیک والا سرور۔

{
  "mcpServers": {
    "netts-docs": {
      "type": "http",
      "url": "https://doc.netts.io/mcp"
    },
    "netts-docs-feedback": {
      "type": "http",
      "url": "https://doc.netts.io/feedback/mcp"
    }
  }
}

Claude Code کے لیے دوسرا یہ ہے:

claude mcp add --transport http netts-docs-feedback https://doc.netts.io/feedback/mcp

MCP کے بغیر

اگر آپ کا ٹول MCP کو سپورٹ نہیں کرتا ہے، تو یہی مواد سادہ فائلوں کے طور پر دستیاب ہے:

• /llms.txt — دستاویزات کا منظم انڈیکس
• /llms-full.txt — ایک فائل میں تمام دستاویزات
• /openapi.yaml — API کی تصریح (specification)
• کوئی بھی صفحہ جس کے آخر میں .md لگا ہو، مثال کے طور پر /api/v2/endpoints/order1h.md