AgileHero

npx add-mcp 'https://mcp.agilehero.io/mcp'

AgileHero एक अंतर्निहित MCP सर्वर के साथ आता है: किसी भी MCP-सक्षम AI सहायक में एक URL जोड़ें, अपने AgileHero खाते से साइन इन करें, और यह आपके प्रोजेक्ट्स पर आपकी सटीक अनुमतियों के साथ काम करता है — बोर्ड, बैकलॉग, एपिक्स, विकी, व्हाइटबोर्ड, रेट्रोस्पेक्टिव्स और रोडमैप में 49 टूल। यह संदर्भ सर्वर से ही उत्पन्न होता है, इसलिए यह हमेशा अद्यतित रहता है।

नए हैं? AI एजेंट अवलोकन से शुरू करें, या नीचे अपने क्लाइंट को कनेक्ट करना पर सीधे जाएं। इस सर्वर पर हर जगह रिच टेक्स्ट AgileHero मार्कअप (AHM) है — एक सख्त, सत्यापित XML बोली जिसे एजेंट कभी भी मानव सामग्री को दूषित न करें, इसके लिए डिज़ाइन किया गया है। किसी सहायक को कनेक्ट करने के बजाय स्क्रिप्ट लिख रहे हैं? REST API संदर्भ उसी OAuth साइन-इन का उपयोग करता है।

अपने AI क्लाइंट को कनेक्ट करें

कनेक्ट करने का मतलब दो चीजें हैं: अपने क्लाइंट में एंडपॉइंट URL जोड़ें, फिर जब क्लाइंट पूछे तो अपने AgileHero खाते से साइन इन करें। बनाने या पेस्ट करने के लिए कोई कुंजी नहीं है। एक बार कनेक्ट होने पर, क्लाइंट आपके रूप में, आपकी सटीक अनुमतियों के साथ कार्य करता है; हर कनेक्टेड क्लाइंट ऐप में Settings → AI clients के अंतर्गत सूचीबद्ध होता है, जहाँ आप इसे किसी भी समय रद्द कर सकते हैं। पर्यवेक्षक MCP सर्वर का उपयोग नहीं कर सकते: एक वर्कस्पेस जहाँ आप पर्यवेक्षक हैं, सूचीबद्ध नहीं है, और उसमें सब कुछ नहीं मिला के रूप में पढ़ा जाता है।

एंडपॉइंट

https://mcp.agilehero.io/mcp

ट्रांसपोर्ट

Streamable HTTP (POST)

साइन-इन

आपका AI क्लाइंट एक ब्राउज़र विंडो खोलता है; एक बार अनुमोदन करें, किसी भी समय Settings → AI clients में रद्द करें।

Claude Code

टर्मिनल में एक बार चलाएँ; Claude Code सर्वर को आपके उपयोगकर्ता-स्तरीय कॉन्फ़िग में संग्रहीत करता है और आपके ब्राउज़र के माध्यम से साइन इन करता है।

claude mcp add --transport http --scope user agilehero https://mcp.agilehero.io/mcp

• सभी फ्लैग सर्वर नाम से पहले आने चाहिए।
• फिर Claude Code सत्र के अंदर /mcp चलाएँ और Authenticate चुनें (या claude mcp login agilehero चलाएँ) और अपने ब्राउज़र में साइन-इन को अनुमोदित करें।

सत्यापित करें: claude mcp list चलाएँ — agilehero को कनेक्टेड दिखना चाहिए। यदि यह "needs authentication" दिखाता है, तो claude mcp login agilehero चलाएँ।

Claude Code दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

VS Code (GitHub Copilot)

किसी वर्कस्पेस में .vscode/mcp.json में जोड़ें, या सभी वर्कस्पेस के लिए "MCP: Open User Configuration" चलाएँ। सर्वर के पहली बार शुरू होने पर साइन-इन के लिए एक ब्राउज़र विंडो खुलती है।

.vscode/mcp.json

{
  "servers": {
    "agilehero": {
      "type": "http",
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• "type": "http" आवश्यक है — इसके बिना VS Code URL को चलाने के लिए कमांड मानता है।

सत्यापित करें: "MCP: List Servers" चलाएँ, agilehero शुरू करें, ब्राउज़र में साइन-इन पूरा करें, और जाँचें कि इसके टूल Chat दृश्य में दिखाई देते हैं।

VS Code (GitHub Copilot) दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

Codex

टर्मिनल से जोड़ें, फिर साइन इन करें — कॉन्फ़िग Codex CLI, IDE एक्सटेंशन और ChatGPT डेस्कटॉप ऐप द्वारा साझा किया जाता है।

codex mcp add agilehero --url https://mcp.agilehero.io/mcp
codex mcp login agilehero

• Codex अपने आप साइन-इन शुरू नहीं करता — सर्वर जोड़ने के बाद codex mcp login agilehero चलाएँ।

सत्यापित करें: codex mcp list चलाएँ — agilehero को प्रमाणित दिखना चाहिए; फिर Codex से अपने AgileHero प्रोजेक्ट्स सूचीबद्ध करने को कहें।

Codex दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

Zed

settings.json में जोड़ें, या Settings → AI → MCP Servers → Add Remote Server का उपयोग करें; Zed आपको साइन इन करने के लिए संकेत देता है।

~/.config/zed/settings.json

{
  "context_servers": {
    "agilehero": {
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• हेडर छोड़ दें — Zed केवल तभी साइन-इन शुरू करता है जब कोई Authorization हेडर कॉन्फ़िगर न हो।

सत्यापित करें: Zed को पुनः आरंभ करें, पूछे जाने पर अपने ब्राउज़र में साइन-इन को अनुमोदित करें, और इसे अपने AgileHero प्रोजेक्ट्स सूचीबद्ध करने को कहें — पहला सफल कॉल कनेक्शन की पुष्टि करता है।

Zed दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

GitHub Copilot CLI

~/.copilot/mcp-config.json में जोड़ें, या किसी रिपॉजिटरी के अंदर .mcp.json में।

~/.copilot/mcp-config.json

{
  "mcpServers": {
    "agilehero": {
      "type": "http",
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• GitHub Copilot CLI 1.0.83 या नया (Client ID Metadata Document समर्थन) आवश्यक है।
• Copilot CLI साइन-इन तब खोलता है जब सर्वर पहली बार इसके लिए पूछता है; आप सत्र के अंदर /mcp auth agilehero भी चला सकते हैं।

सत्यापित करें: Copilot CLI के अंदर /mcp चलाएँ — agilehero को इसके टूल के साथ कनेक्टेड सूचीबद्ध होना चाहिए।

GitHub Copilot CLI दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

Claude (वेब, डेस्कटॉप, Cowork)

AgileHero को कस्टम कनेक्टर के रूप में जोड़ें और साइन इन करें; कनेक्टर वेब पर Claude, Claude Desktop, Cowork और मोबाइल ऐप्स में उपलब्ध है।

Settings → Connectors → Add custom connector
Name: AgileHero
URL: https://mcp.agilehero.io/mcp
Sign in now

• कनेक्टर Claude Code में भी दिखाई देता है जब यह उसी Claude खाते से साइन इन होता है।
• निःशुल्क योजना: एक कस्टम कनेक्टर। Team और Enterprise: एक Owner कनेक्टर जोड़ता है, और हर सदस्य अपने स्वयं के AgileHero खाते से साइन इन करता है।

सत्यापित करें: एक नई चैट शुरू करें — AgileHero कनेक्टर्स के अंतर्गत सूचीबद्ध है, और Claude से अपने AgileHero प्रोजेक्ट्स सूचीबद्ध करने को कहना काम करता है।

Claude (वेब, डेस्कटॉप, Cowork) दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

ChatGPT

Developer मोड में एक कनेक्टर बनाएँ और OAuth से साइन इन करें।

Settings → Connectors → Create (Developer mode)
Name: AgileHero
MCP server URL: https://mcp.agilehero.io/mcp
Authentication: OAuth

• Developer मोड सक्षम के साथ Plus, Pro, Business, Enterprise और Edu पर उपलब्ध; किसी वर्कस्पेस में एक admin या owner सदस्यों के लिए कनेक्टर प्रकाशित करता है।

सत्यापित करें: AgileHero कनेक्टर सक्षम के साथ एक नई चैट खोलें और ChatGPT से अपने AgileHero प्रोजेक्ट्स सूचीबद्ध करने को कहें।

ChatGPT दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

अन्य क्लाइंट

कोई भी MCP क्लाइंट जो Client ID Metadata Documents के साथ OAuth का समर्थन करता है: एंडपॉइंट को रिमोट (Streamable HTTP) सर्वर के रूप में जोड़ें और अपने ब्राउज़र में साइन-इन को अनुमोदित करें।

Transport: Streamable HTTP
URL: https://mcp.agilehero.io/mcp
Authentication: OAuth (sign in when the client asks)

• केवल स्थिर टोकन या हेडर का समर्थन करने वाले क्लाइंट कनेक्ट नहीं हो सकते — AgileHero केवल OAuth साइन-इन का उपयोग करता है।

सत्यापित करें: क्लाइंट को पुनः आरंभ करें, पूछे जाने पर अपने ब्राउज़र में साइन-इन को अनुमोदित करें, और इसे अपने AgileHero प्रोजेक्ट्स सूचीबद्ध करने को कहें — पहला सफल कॉल कनेक्शन की पुष्टि करता है।

अन्य क्लाइंट दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

अभी समर्थित नहीं

ये क्लाइंट अभी AgileHero में साइन इन नहीं कर सकते। उनमें से अधिकांश में Client ID Metadata Documents के लिए समर्थन की कमी है, OAuth क्लाइंट-पंजीकरण विधि जो AgileHero उपयोग करता है (वर्तमान MCP अनुशंसा); हम नियमित रूप से विक्रेता दस्तावेज़ों की पुनः जाँच करते हैं और जैसे ही कोई क्लाइंट योग्य होता है, उसे ऊपर ले जाते हैं।

Cursorअभी नहीं

Cursor अभी Client ID Metadata Documents का समर्थन नहीं करता (इसके OAuth साइन-इन को Dynamic Client Registration या पूर्व-पंजीकृत क्लाइंट की आवश्यकता होती है), इसलिए यह अभी AgileHero से कनेक्ट नहीं हो सकता।

Cursor दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

OpenCodeअभी नहीं

OpenCode अभी Client ID Metadata Documents का समर्थन नहीं करता (इसके OAuth साइन-इन को Dynamic Client Registration या पूर्व-पंजीकृत क्लाइंट की आवश्यकता होती है), इसलिए यह अभी AgileHero से कनेक्ट नहीं हो सकता।

OpenCode दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

Gemini CLIअभी नहीं

Gemini CLI अभी Client ID Metadata Documents का समर्थन नहीं करता (इसके OAuth साइन-इन को Dynamic Client Registration या पूर्व-पंजीकृत क्लाइंट की आवश्यकता होती है), इसलिए यह अभी AgileHero से कनेक्ट नहीं हो सकता।

Gemini CLI दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

Clineअभी नहीं

Cline अभी Client ID Metadata Documents का समर्थन नहीं करता (इसके OAuth साइन-इन को Dynamic Client Registration या पूर्व-पंजीकृत क्लाइंट की आवश्यकता होती है), इसलिए यह अभी AgileHero से कनेक्ट नहीं हो सकता।

Cline दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

Google Antigravityअभी नहीं

Google Antigravity अभी Client ID Metadata Documents का समर्थन नहीं करता (इसके OAuth साइन-इन को Dynamic Client Registration या पूर्व-पंजीकृत क्लाइंट की आवश्यकता होती है), इसलिए यह अभी AgileHero से कनेक्ट नहीं हो सकता।

Google Antigravity दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

Ampअभी नहीं

Amp अभी Client ID Metadata Documents का समर्थन नहीं करता (इसके OAuth साइन-इन को Dynamic Client Registration या पूर्व-पंजीकृत क्लाइंट की आवश्यकता होती है), इसलिए यह अभी AgileHero से कनेक्ट नहीं हो सकता।

Amp दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

Raycast AIअभी नहीं

Raycast AI अभी Client ID Metadata Documents का समर्थन नहीं करता (इसके OAuth साइन-इन को Dynamic Client Registration या पूर्व-पंजीकृत क्लाइंट की आवश्यकता होती है), इसलिए यह अभी AgileHero से कनेक्ट नहीं हो सकता।

Raycast AI दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

Kiroअभी नहीं

Kiro आपके द्वारा प्रदान किए गए Client ID Metadata Document URL के साथ साइन इन करता है, और AgileHero अभी इसके लिए Client ID Metadata Document होस्ट नहीं करता।

Kiro दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

Warpअभी नहीं

Warp में अभी उपयोगकर्ता-जोड़े गए सर्वरों के लिए OAuth साइन-इन नहीं है, इसलिए यह अभी AgileHero से कनेक्ट नहीं हो सकता।

Warp दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

JetBrains AI Assistantअभी नहीं

JetBrains AI Assistant में रिमोट सर्वरों के लिए OAuth साइन-इन नहीं है, और mcp-remote ब्रिज को एक होस्टेड क्लाइंट दस्तावेज़ की आवश्यकता होगी — AgileHero अभी इसके लिए Client ID Metadata Document होस्ट नहीं करता।

JetBrains AI Assistant दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

Continueअभी नहीं

Continue में Streamable HTTP सर्वरों के लिए OAuth साइन-इन नहीं है, और mcp-remote ब्रिज को एक होस्टेड क्लाइंट दस्तावेज़ की आवश्यकता होगी — AgileHero अभी इसके लिए Client ID Metadata Document होस्ट नहीं करता।

Continue दस्तावेज़ · विक्रेता दस्तावेज़ों के विरुद्ध 2026-09-15 को सत्यापित

सर्वर निर्देश

हर MCP क्लाइंट को आरंभीकरण समय पर ये परंपराएँ प्राप्त होती हैं:

AgileHero MCP सर्वर।

हर id पैरामीटर और प्रतिक्रिया में हर id एक छोटा uid है — हमेशा list/get/search टूल द्वारा लौटाए गए uids का उपयोग करें, कभी भी अपना आविष्कार न करें। अधिकांश टूल को एक प्रोजेक्ट uid की आवश्यकता होती है — वर्कस्पेस और प्रोजेक्ट्स खोजने के लिए list_projects को पहले कॉल करें। search_cards (शीर्षक-उपस्ट्रिंग, एक प्रोजेक्ट) पर search (पूर्ण-पाठ, सभी सामग्री प्रकार) को प्राथमिकता दें।

अपडेट टूल पर, संग्रहों के लिए add_*/remove_* डेल्टा फ़ील्ड को प्राथमिकता दें (वृद्धिशील, सुरक्षित); सादे संग्रह फ़ील्ड (assigned_to, labels, checklists, cards_relations, links, attachments) पिछली स्थिति को REPLACE करते हैं और उनके डेल्टा के साथ संयोजित नहीं किए जा सकते। चेकलिस्ट आइटम { description, checked } हैं। list_cards / list_epics पर updated_since के साथ परिवर्तनों को पकड़ें।

किसी कार्ड की सूची या स्थिति बदलने के लिए move_card (update_card नहीं) का उपयोग करें; एक खाली list_id का अर्थ बैकलॉग है।

विकी, व्हाइटबोर्ड, रेट्रोस्पेक्टिव और रोडमैप टूल के लिए प्रोजेक्ट के वर्कस्पेस को Pro या परीक्षण योजना पर होना आवश्यक है। व्हाइटबोर्ड तत्व लेखन बैच टूल हैं और सभी-या-कुछ नहीं; तत्व uids get_whiteboard से आते हैं। रेट्रोस्पेक्टिव आइटम add_retro_items और move_retro_item के साथ प्रबंधित किए जाते हैं (move_card रेट्रोस्पेक्टिव कार्ड को अस्वीकार करता है)।

दैनिक सीमाएँ: टूल कॉल प्रति उपयोगकर्ता प्रति वर्कस्पेस मापी जाती हैं — निःशुल्क योजना पर 500/दिन, Pro या परीक्षण पर 5,000/दिन, 00:00 UTC पर रीसेट होती हैं। get_ahm_spec और list_projects कभी गिने नहीं जाते (न ही कोई कॉल जो एकल वर्कस्पेस के लिए जिम्मेदार नहीं है, जैसे एक असंबद्ध खोज)। सीमा से अधिक होने पर, टूल रीसेट या अपग्रेड तक दैनिक-सीमा त्रुटि लौटाते हैं।

सभी रिच टेक्स्ट (विकी पेज, कार्ड/एपिक विवरण, टिप्पणियाँ) AgileHero मार्कअप (AHM) है — सख्त XML, कभी markdown या HTML नहीं; कोई भी लिखने से पहले get_ahm_spec को एक बार कॉल करें। रिच-टेक्स्ट संपादन डिज़ाइन द्वारा दो-चरणीय हैं: preview_wiki_page_update / preview_description_update (परिणाम + preview_token), फिर उस टोकन के साथ मेल खाने वाला अपडेट टूल।

पूर्ण टूल दस्तावेज़: https://agilehero.io/docs/mcp

AHM विनिर्देश: https://agilehero.io/docs/mcp/agilehero-markup

टूल (49)

list_projectsकेवल-पढ़ने के लिए

टोकन के उपयोगकर्ता द्वारा एक्सेस किए जा सकने वाले हर वर्कस्पेस और प्रोजेक्ट को सूचीबद्ध करें, ताकि एजेंट प्रोजेक्ट uid को हल कर सके जो अधिकांश अन्य टूल को आवश्यक होता है। जब भी कोई प्रोजेक्ट uid ज्ञात न हो, इसे पहले कॉल करें — उपयोगकर्ता से कभी भी एक पेस्ट करने को न कहें। वर्कस्पेस (uid, name, plan, your role) उनके प्रोजेक्ट्स (uid, name, url) के साथ लौटाता है। Pro-पिलर टूल (विकी, मेट्रिक्स) के लिए वर्कस्पेस की योजना pro या परीक्षण होनी चाहिए।

searchकेवल-पढ़ने के लिए

उत्पाद की वैश्विक पूर्ण-पाठ खोज (OpenSearch): कार्ड, एपिक, विकी पेज और प्रोजेक्ट, जो शीर्षक, विवरण, टिप्पणियाँ, चेकलिस्ट आइटम और अनुलग्नक फ़ाइलनामों से मेल खाते हैं, प्रासंगिकता-क्रमबद्ध और हाल की वृद्धि के साथ। इसका उपयोग किसी भी चीज़ को सामग्री द्वारा खोजने के लिए करें ("वह कार्ड जहाँ हमने माइग्रेशन पर चर्चा की थी"); search_cards का उपयोग केवल एक प्रोजेक्ट के भीतर शीर्षक-उपस्ट्रिंग लुकअप के लिए करें। प्रत्येक परिणाम में एक प्रकार, एक क्रिया-तैयार uid (कार्ड get_card/update_card, एपिक get_epic, wiki_pages show_wiki_page, प्रोजेक्ट project_id पैरामीटर) होता है, एक डीप-लिंक url, और <mark>-हाइलाइट किए गए स्निपेट जो दिखाते हैं कि यह क्यों मेल खाता है। वैकल्पिक रूप से project_id या assigned_to_me के साथ स्कोप करें। page/per_page के साथ पेजिनेट करें; total_count पूर्ण मिलान गणना है।

पैरामीटर	प्रकार	आवश्यक	विवरण
query	string	हाँ	मुक्त-पाठ खोज क्वेरी
project_id	string		वैकल्पिक प्रोजेक्ट uid खोज को स्कोप करने के लिए
assigned_to_me	boolean		केवल टोकन के उपयोगकर्ता को सौंपे गए परिणाम
page	integer		पृष्ठ संख्या (डिफ़ॉल्ट 1)
per_page	integer		प्रति पृष्ठ परिणाम, 1-50 (डिफ़ॉल्ट 20)

get_cardread-only

एक कार्ड को पूर्ण रूप से पढ़ें: इसका AgileHero मार्कअप विवरण ब्लॉक आईडी के साथ और description_version (दो इनपुट preview_description_update / update_description लेते हैं), सूची स्थान, एपिक, लेबल, असाइनी, रिपोर्टर, प्रकार, अनुमान, नियत तिथि, चेकलिस्ट, लिंक, अनुलग्नक, संबंधित कार्ड और थ्रेडेड टिप्पणियाँ। केवल कार्ड uid लेता है — कोई project_id पैरामीटर नहीं है। कार्ड uid list_cards, search या search_cards से आते हैं।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	कार्ड का अद्वितीय पहचानकर्ता

get_epicread-only

एक एपिक को पूर्ण रूप से पढ़ें: इसका AgileHero मार्कअप विवरण ब्लॉक आईडी के साथ और description_version (दो इनपुट preview_description_update / update_description लेते हैं), नाम, संख्या, रंग, प्रारंभ/समाप्ति तिथियाँ, असाइनी, चेकलिस्ट, लिंक, अनुलग्नक, उस पर हर कार्ड (uid, संख्या, शीर्षक और उसकी सूची श्रेणी के साथ — null सूची = बैकलॉग — बोर्ड क्रम में, इसलिए यह एक एपिक के सभी कार्ड सूचीबद्ध करने और देखने का तरीका है कि कौन से करने हैं, प्रगति पर हैं या पूर्ण हैं) और थ्रेडेड टिप्पणियाँ। केवल एपिक uid लेता है — कोई project_id पैरामीटर नहीं है। एपिक uid list_epics या search से आते हैं।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	एपिक का अद्वितीय पहचानकर्ता

list_wiki_pathsPro · wikiread-only

किसी प्रोजेक्ट के पूरे विकी ट्री को प्रदर्शन क्रम में सूचीबद्ध करें — हर फ़ोल्डर और पेज उसके uid, नाम, प्रकार (पेज या फ़ोल्डर) और parent_id के साथ — ताकि एजेंट show_wiki_page द्वारा लिए गए पेज uid को हल कर सके और create_wiki_page के लिए parent_id चुन सके। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता

show_wiki_pagePro · wikiread-only

एक विकी पेज को AgileHero मार्कअप (AHM) के रूप में उसके document_version के साथ प्राप्त करें। सामग्री AHM है, मार्कडाउन नहीं — ब्लॉक आईडी, <discussion> एंकर, और <image/>/<attachment/> संदर्भ दस्तावेज़ का हिस्सा हैं; संपादन से पहले get_ahm_spec पढ़ें। यहाँ लौटाए गए ब्लॉक आईडी और document_version का उपयोग करके preview_wiki_page_update फिर update_wiki_page के माध्यम से संपादित करें। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	पेज पथ का अद्वितीय पहचानकर्ता

get_ahm_specread-only

AgileHero मार्कअप (AHM) v1.0 विनिर्देश — एकमात्र रिच-टेक्स्ट प्रारूप जिसे AgileHero स्वीकार करता है (मार्कडाउन और HTML अस्वीकार कर दिए जाते हैं)। किसी भी रिच टेक्स्ट (विकी पेज, कार्ड/एपिक विवरण, टिप्पणियाँ) को लिखने या संपादित करने से पहले इसे एक बार पढ़ें: शब्दावली, विशेषताएँ, एस्केपिंग नियम, और एक काम किया उदाहरण। वेब पर समान पाठ: https://agilehero.io/docs/mcp/agilehero-markup

create_wiki_pagePro · wiki

AgileHero मार्कअप (AHM) सामग्री के साथ एक विकी पेज बनाएं (वैकल्पिक रूप से एक फ़ोल्डर के अंदर)। सामग्री <agile-hero-markup version="1.0"> में लपेटी जानी चाहिए — मार्कडाउन और HTML अस्वीकार कर दिए जाते हैं; पहले get_ahm_spec पढ़ें। नए पेज का uid, url, document_version और सामग्री लौटाता है। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता (uid)
name	string	हाँ	पेज शीर्षक
parent_id	string		वैकल्पिक फ़ोल्डर uid (list_wiki_paths से)
content	string		पेज बॉडी AHM के रूप में; खाली पेज के लिए छोड़ दें

preview_wiki_page_updatePro · wikiread-only

हर विकी पेज अपडेट का आवश्यक पहला चरण: संचालन को मान्य करता है और सर्वर-गणना किए गए परिणाम लौटाता है (जोड़े/हटाए/बदले गए ब्लॉक, फ़ाइलें जो स्थायी रूप से हटा दी जाएंगी, टीम चर्चाएँ जो अपने एंकर खो देंगी, संभावित-मार्कडाउन चेतावनियाँ) साथ ही preview_token जो update_wiki_page को आवश्यक है। कुछ भी संशोधित नहीं होता है। संचालन ब्लॉक-संबोधित हैं (replace_block / insert_after / delete_block / move_block) AHM सामग्री के साथ — पहले get_ahm_spec पढ़ें, और show_wiki_page से ब्लॉक आईडी + document_version प्राप्त करें। सहेजने से पहले परिणामों की समीक्षा करें: एक सूचीबद्ध फ़ाइल विलोपन या चर्चा अनएंकरिंग केवल तभी स्वीकार्य है जब उपयोगकर्ता ने इसके लिए पूछा हो। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	पेज पथ uid
document_version	string	हाँ	show_wiki_page से — ताज़गी साबित करता है
operations	array of object	हाँ	विकसित दस्तावेज़ के विरुद्ध क्रम में लागू किया गया

update_wiki_pagePro · wikidestructive

पहले से पूर्वावलोकित अपडेट को विकी पेज पर लागू करें। preview_wiki_page_update से preview_token की आवश्यकता है EXACTLY इन संचालनों और इस document_version के लिए — पूर्वावलोकन के बिना सहेजना डिज़ाइन द्वारा असंभव है। हर सहेजना एक पेज संस्करण बनाता है जिसे मानव ऐप में पूर्ववत कर सकते हैं। अपडेट किया गया पेज (AHM + नया document_version) और लागू परिणाम लौटाता है। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	पेज पथ uid
document_version	string	हाँ	वह संस्करण जिसके विरुद्ध पूर्वावलोकन लिया गया था
operations	array of object	हाँ	वे सटीक संचालन जो पूर्वावलोकित किए गए थे
preview_token	string	हाँ	preview_wiki_page_update से

preview_description_updateread-only

हर कार्ड या एपिक विवरण संपादन का आवश्यक पहला चरण: ब्लॉक संचालन को मान्य करता है और सर्वर-गणना किए गए परिणाम साथ ही preview_token लौटाता है जो update_description को आवश्यक है। कुछ भी संशोधित नहीं होता है। सामग्री AgileHero मार्कअप (AHM, विवरण सतह: कोई तालिकाएँ, रंग, संरेखण, चर्चाएँ, या फ़ाइल अनुलग्नक नहीं) है — पहले get_ahm_spec पढ़ें; ब्लॉक आईडी और document_version get_card / get_epic से आते हैं।

पैरामीटर	प्रकार	आवश्यक	विवरण
resource_type	enum: card | epic	हाँ
id	string	हाँ	कार्ड या एपिक uid
document_version	string	हाँ	get_card / get_epic से
operations	array of object	हाँ	विकसित विवरण के विरुद्ध क्रम में लागू किया गया

update_descriptiondestructive

पहले से पूर्वावलोकित विवरण अपडेट को कार्ड या एपिक पर लागू करें। preview_description_update से preview_token की आवश्यकता है EXACTLY इन संचालनों और इस document_version के लिए — पूर्वावलोकन के बिना सहेजना डिज़ाइन द्वारा असंभव है। अपडेट किया गया विवरण (AHM + नया document_version) लौटाता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
resource_type	enum: card | epic	हाँ
id	string	हाँ	कार्ड या एपिक uid
document_version	string	हाँ	वह संस्करण जिसके विरुद्ध पूर्वावलोकन लिया गया था
operations	array of object	हाँ	वे सटीक संचालन जो पूर्वावलोकित किए गए थे
preview_token	string	हाँ	preview_description_update से

list_whiteboardsPro · whiteboardread-only

किसी प्रोजेक्ट के व्हाइटबोर्ड सूचीबद्ध करें (uid, नाम, तत्व गणना, url)। बोर्ड के तत्वों को पढ़ने के लिए get_whiteboard का उपयोग करें। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता

create_whiteboardPro · whiteboard

किसी प्रोजेक्ट पर एक खाली व्हाइटबोर्ड बनाएं। create_whiteboard_elements के साथ सामग्री जोड़ें। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता
name	string	हाँ	व्हाइटबोर्ड नाम

get_whiteboardPro · whiteboardread-only

एक व्हाइटबोर्ड को एक संक्षिप्त पाठ प्रतिनिधित्व के रूप में पढ़ें: बोर्ड सीमाएँ और प्रति तत्व एक पंक्ति — "<type> <uid> at <x>,<y> size <w>x<h> [color] [parent <frame-uid>] [linked <card|epic> <uid>] \"text\"", कनेक्टर के रूप में "connector <uid> <from> -> <to>"। यहाँ से तत्व uid वे हैंडल हैं जो हर व्हाइटबोर्ड लेखन उपकरण लेता है। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	व्हाइटबोर्ड का अद्वितीय पहचानकर्ता

create_whiteboard_elementsPro · whiteboard

एक लेन-देन कॉल में 100 तक व्हाइटबोर्ड तत्व बनाएं (सभी-या-कुछ नहीं, एक रीयलटाइम घटना)। मूल आकार, रंग, और पाठ स्थान सर्वर-साइड लागू किए जाते हैं — आमतौर पर केवल प्रकार + पाठ (+ रंग) दें; x/y छोड़ें और तत्व स्वचालित रूप से व्यवस्थित होते हैं (डिफ़ॉल्ट ग्रिड; arrange: row|column|grid, origin_x/origin_y/gap ट्यून करने के लिए); पूर्ण नियंत्रण के लिए x/y दें। फ़्रेम में तत्व parent_id (एक मौजूदा फ़्रेम uid) या parent_ref (इस कॉल में पहले के फ़्रेम का ref) के माध्यम से होते हैं। कनेक्टर तत्वों को uid (source_id/target_id) या बैच ref (source_ref/target_ref) द्वारा बाँधते हैं — कभी निर्देशांक नहीं; एंकर UI द्वारा गणना किए जाते हैं। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
whiteboard_id	string	हाँ	व्हाइटबोर्ड का अद्वितीय पहचानकर्ता
elements	array of object	हाँ	सरणी क्रम में बनाए गए — refs केवल पीछे की ओर हल होते हैं
arrange	enum: grid | row | column		स्पष्ट x/y के बिना तत्वों के लिए लेआउट (डिफ़ॉल्ट ग्रिड)
origin_x	number		स्वचालित-व्यवस्था प्रारंभ x (डिफ़ॉल्ट 100)
origin_y	number		स्वचालित-व्यवस्था प्रारंभ y (डिफ़ॉल्ट 100)
gap	number		स्वचालित-व्यवस्था स्पेसिंग px में (डिफ़ॉल्ट 20)

create_whiteboard_diagramPro · whiteboard

एक व्हाइटबोर्ड पर एक आरेख (फ़्लोचार्ट, प्रक्रिया, निर्भरता ग्राफ़) एक शब्दार्थ ग्राफ़ से बनाएं — नोड्स, किनारे, वैकल्पिक समूह, कोई निर्देशांक नहीं: सर्वर मूल आकारों के साथ स्तरित ऊपर-से-नीचे लेआउट करता है और आपके नोड आईडी द्वारा कुंजीबद्ध बनाए गए तत्व uid लौटाता है। मौजूदा बोर्ड सामग्री के नीचे रखा गया। लेन-देन (सभी-या-कुछ नहीं, एक रीयलटाइम घटना)। अधिकतम 20 नोड — बड़े प्रवाह को दो आरेखों में विभाजित करें। आकृतियों को सादा (आयत) रखें जब तक कि शब्दार्थ एक की मांग न करे (हीरा = निर्णय, स्टेडियम = प्रारंभ/समाप्ति, सिलेंडर = डेटा स्टोर)। परिणाम को update_whiteboard_elements के साथ संपादित करें — लेआउट फिर कभी नहीं चलता। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
whiteboard_id	string	हाँ	व्हाइटबोर्ड का अद्वितीय पहचानकर्ता
title	string		आरेख शीर्षक (फ़्रेम शीर्षक, या एक शीर्षक जब समूह उपयोग किए जाते हैं)
nodes	array of object	हाँ
edges	array of object
groups	array of object
origin_x	number		वैकल्पिक ऊपर-बाएँ x; डिफ़ॉल्ट मौजूदा सामग्री के नीचे
origin_y	number		वैकल्पिक ऊपर-बाएँ y; डिफ़ॉल्ट मौजूदा सामग्री के नीचे

update_whiteboard_elementsPro · whiteboard

एक ही ऑल-ऑर-नथिंग कॉल में 100 तक व्हाइटबोर्ड तत्व अपडेट करें: स्थानांतरित करें (x/y), आकार बदलें, पुनः स्टैक करें (z_index), पाठ बदलें, रंग बदलें, पुनः मूल तत्व निर्धारित करें (parent_id — एक फ्रेम uid, या डिटैच करने के लिए ""), और कनेक्टर तीर/पथ/लेबल। तत्व uid get_whiteboard से आते हैं; तत्व प्रकार बदले नहीं जा सकते। केवल दिए गए फ़ील्ड बदलते हैं — असंबंधित गुण संरक्षित रहते हैं। Pro या ट्रायल वर्कस्पेस आवश्यक है।

पैरामीटर	प्रकार	आवश्यक	विवरण
whiteboard_id	string	हाँ	व्हाइटबोर्ड का अद्वितीय पहचानकर्ता
updates	array of object	हाँ

delete_whiteboard_elementsPro · whiteboardविनाशकारी

एक ट्रांज़ैक्शनल कॉल में 100 तक व्हाइटबोर्ड तत्व हटाएं। किसी फ्रेम या माइंड-मैप नोड को हटाने से उसके चाइल्ड तत्व बोर्ड पर छूट जाते हैं (वे हटाए नहीं जाते — उन्हें भी हटाने के लिए उनके uid स्पष्ट रूप से शामिल करें)। हटाए गए तत्वों से जुड़े कनेक्टर हटाए नहीं जाते और लटके रहेंगे। तत्व uid get_whiteboard से आते हैं। Pro या ट्रायल वर्कस्पेस आवश्यक है।

पैरामीटर	प्रकार	आवश्यक	विवरण
whiteboard_id	string	हाँ	व्हाइटबोर्ड का अद्वितीय पहचानकर्ता
ids	array of string	हाँ	हटाने के लिए तत्व uid

review_whiteboardPro · whiteboardकेवल-पढ़ने

व्हाइटबोर्ड पर निर्धारित गुणवत्ता जाँच चलाएँ: पाठ जो संभवतः अपने तत्व से बाहर बह रहा है, दृश्य रूप से ओवरलैप होने वाले तत्व, अनबाउंड या लटकते एंडपॉइंट वाले कनेक्टर, UI पैलेट के बाहर के रंग, ऑफ-ग्रिड स्थितियाँ, और ऐसे तत्व जिनका मूल तत्व हटा दिया गया है। सलाहकारी — निष्कर्ष सुझाव हैं, त्रुटियाँ नहीं, और निष्कर्षों वाला बोर्ड वही हो सकता है जो उपयोगकर्ता चाहता है। ड्रॉइंग के बाद सैनिटी-चेक के लिए उपयोग करें, अधिकतम एक बार ठीक करें, और खाली रिपोर्ट का पीछा करते हुए लूप न करें। Pro या ट्रायल वर्कस्पेस आवश्यक है।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	व्हाइटबोर्ड का अद्वितीय पहचानकर्ता

convert_whiteboard_elementPro · whiteboard

व्हाइटबोर्ड तत्व को बैकलॉग आइटम में बदलें: एक स्टिकी नोट को कार्ड या एपिक में, या एक फ्रेम को एपिक में (फ्रेम के स्टिकी-नोट चाइल्ड उस एपिक पर कार्ड बन जाते हैं; पहले से बदले गए चाइल्ड पुनः असाइन किए जाते हैं, डुप्लिकेट नहीं)। तत्व बोर्ड पर रहता है, जो बना उससे लिंक होता है — get_whiteboard लिंक दिखाता है। एक तत्व केवल एक बार बदला जा सकता है। नोट/फ्रेम का पाठ शीर्षक बन जाता है जब तक आप एक नहीं देते। Pro या ट्रायल वर्कस्पेस आवश्यक है।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	तत्व uid (एक sticky_note या frame, get_whiteboard से)
to	enum: card | epic	हाँ	क्या बनाना है
title	string		कार्ड शीर्षक / एपिक नाम; तत्व के पाठ पर डिफ़ॉल्ट
list_id	string		केवल कार्ड: लक्ष्य सूची uid; बैकलॉग के लिए छोड़ें
color	string		केवल एपिक: हेक्स रंग; तत्व के रंग पर डिफ़ॉल्ट

convert_mind_mapPro · whiteboard

माइंड मैप को प्रति-नोड मैपिंग के साथ बैकलॉग आइटम में बदलें: रूट एक नया एपिक (भूमिका "epic") बन सकता है या मौजूदा एक से जुड़ सकता है (भूमिका "existing_epic" + target_epic_id); अन्य नोड उस एपिक पर कार्ड (भूमिका "card") या प्रोजेक्ट लेबल (भूमिका "label" — पेड़ में कार्ड नोड के ऊपर के लेबल नोड उस कार्ड पर लागू होते हैं) बन जाते हैं; भूमिका "skip" एक नोड को अनदेखा करती है। ROOT तत्व uid को id के रूप में और हर नोड को जिसे आप nodes में बदलना चाहते हैं, पास करें (असूचीबद्ध नोड अनदेखे हैं)। प्रति नोड एक रूपांतरण: पहले से बदले गए नोड शुरू में अस्वीकार कर दिए जाते हैं — उनके बिना पुनः सबमिट करें। Pro या ट्रायल वर्कस्पेस आवश्यक है।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	ROOT माइंड-मैप नोड uid (get_whiteboard से)
nodes	array of object	हाँ
target_epic_id	string		एपिक uid, रूट पर भूमिका "existing_epic" के साथ आवश्यक

list_retrospectivesPro · retrospectivesकेवल-पढ़ने

किसी प्रोजेक्ट के रेट्रोस्पेक्टिव सूचीबद्ध करें: नए-मॉडल रेट्रोस्पेक्टिव और स्वास्थ्य जाँच जहाँ वर्कस्पेस में वे हैं, अन्यथा क्लासिक रेट्रोस्पेक्टिव बोर्ड। एक नए-मॉडल प्रविष्टि में uid, name, kind (retro | health_check), status (open | live | closed), date (starts_on; स्वास्थ्य जाँच के लिए closes_on), वर्तमान चरण, टेम्पलेट, सुविधाकर्ता uid, इसके द्वारा बनाई गई क्रियाओं की गिनती, और url होता है; प्रतिक्रिया प्रोजेक्ट की open_actions_count जोड़ती है। पूरी तस्वीर के लिए get_retrospective उपयोग करें। Pro या ट्रायल वर्कस्पेस आवश्यक है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता

create_retrospectivePro · retrospectives

एक रेट्रोस्पेक्टिव बनाएँ: एक नया-मॉडल रेट्रोस्पेक्टिव जहाँ वर्कस्पेस में वे हैं, अन्यथा एक क्लासिक रेट्रोस्पेक्टिव बोर्ड; प्रतिक्रिया वह रेट्रोस्पेक्टिव है जैसा get_retrospective लौटाता है (कॉलम उनके uid के साथ), इसलिए add_retro_items तुरंत अनुसरण कर सकता है। एक नया-मॉडल रेट्रोस्पेक्टिव एक टेम्पलेट (डिफ़ॉल्ट went_well) से आता है, तुरंत नोट्स के लिए खुला होता है और आप सुविधाकर्ता होते हैं; वैकल्पिक: focus, anonymity (डिफ़ॉल्ट: टेम्पलेट का), participant_ids (एक चयनित-सदस्य रेट्रो; लेखन पहुँच वाले हर प्रोजेक्ट सदस्य के लिए छोड़ें), check_in और feedback प्रश्न प्रकार, और votes। सुविधाकर्ता इसे शुरू करता है और ऐप में इसके चरण चलाता है। क्लासिक बोर्ड केवल name, date और previous_retrospective_id लेते हैं और नए-मॉडल तर्कों को अस्वीकार करते हैं। Pro या ट्रायल वर्कस्पेस आवश्यक है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता
name	string	हाँ	रेट्रोस्पेक्टिव नाम
template	enum: went_well | start_stop_continue | four_ls | mad_sad_glad | kalm | daki | starfish | plus_delta | sailboat | rose_thorn_bud | wrap | hot_air_balloon | three_pigs | project_retro | postmortem | kudos_lessons		टेम्पलेट कुंजी; डिफ़ॉल्ट went_well
starts_on	string		दिनांक, ISO-8601 (YYYY-MM-DD); आज पर डिफ़ॉल्ट
starts_at	string		starts_on का पदावनत उपनाम
focus	string		यह रेट्रो किस बारे में है, इसके नाम के नीचे दिखाया गया
anonymity	enum: anonymous | optional | named		नोट्स पर कौन दिखाया गया है: anonymous, optional (लेखक अपना नाम जोड़ सकते हैं) या named
participant_ids	array of string		प्रतिभागियों के उपयोगकर्ता uid (list_project_users); आप हमेशा एक हैं
check_in	enum: safety | mood | esvp | one_word		चेक-इन प्रश्न (डिफ़ॉल्ट safety)
feedback	enum: roti | pulse | one_word		समापन प्रतिक्रिया प्रश्न (डिफ़ॉल्ट roti)
votes	object		वोट सेटिंग्स: budget (auto | fixed | unlimited), per_person (1-20), max_per_topic (1-10)
previous_retrospective_id	string		केवल क्लासिक बोर्ड: पहले के रेट्रोस्पेक्टिव का uid जिसका Actions कॉलम "Past actions" के रूप में दिखता है

get_retrospectivePro · retrospectivesकेवल-पढ़ने

एक रेट्रोस्पेक्टिव पढ़ें जैसा आप इसे देख सकते हैं: एक नया-मॉडल रेट्रोस्पेक्टिव या स्वास्थ्य जाँच जहाँ वर्कस्पेस में वे हैं, अन्यथा एक क्लासिक रेट्रोस्पेक्टिव बोर्ड। एक नया-मॉडल रेट्रोस्पेक्टिव सेटअप, चरण (वर्तमान, टाइमर, प्रगति), कॉलम (uid के साथ) जिसमें विषय (नोट्स के समूह, uid के साथ), चेक-इन और प्रतिक्रिया गणना, आपके बचे वोट, Discuss कतार और पार्क किए गए विषय, प्रस्ताव, क्रियाएँ (इसके द्वारा बनाई गई और प्रोजेक्ट की खुली) और, एक बार बंद होने पर, इसका सारांश लौटाता है। गोपनीयता कमरे का अनुसरण करती है: रिवील से पहले आपको केवल अपने नोट्स मिलते हैं (प्रत्येक कॉलम सभी की गिनती करता है), केवल नामित नोट्स पर लेखक, वोट कुल केवल एक बार वोट रिवील होने पर। एक स्वास्थ्य जाँच इसके आयाम और भागीदारी, खुले रहते हुए आपकी अपनी रेटिंग, और बंद होने पर प्रति-आयाम समुच्चय लौटाती है। Pro या ट्रायल वर्कस्पेस आवश्यक है।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	रेट्रोस्पेक्टिव uid (list_retrospectives से)

add_retro_itemsPro · retrospectives

एक रेट्रोस्पेक्टिव में अपने रूप में आइटम जोड़ें, एक साथ कई: नए-मॉडल रेट्रोस्पेक्टिव पर नोट्स जहाँ वर्कस्पेस में वे हैं, अन्यथा क्लासिक रेट्रोस्पेक्टिव बोर्ड पर कार्ड। प्रत्येक आइटम { column, text, recipient_id? } है: column एक कॉलम शीर्षक (केस-असंवेदनशील) या get_retrospective से uid है; text 1000 वर्णों तक है (क्लासिक बोर्ड पर 255); recipient_id, धन्यवादित सहकर्मी का उपयोगकर्ता uid, नए-मॉडल kudos कॉलम में आवश्यक है और क्लासिक बोर्ड पर अस्वीकृत है। एक नया-मॉडल नोट अपना स्वयं का विषय शुरू करता है और अन्य इसे एक बार नोट्स रिवील होने पर देखते हैं; नोट्स केवल तब लिए जाते हैं जब रेट्रोस्पेक्टिव नोट्स के लिए खुला हो या Write चरण में हो, अन्यथा कॉल को कोड wrong_stage और वर्तमान चरण के साथ अस्वीकार कर दिया जाता है। आंशिक विफलता: मान्य आइटम जोड़े जाते हैं, अमान्य प्रति-सूचकांक रिपोर्ट किए जाते हैं — "failed" सरणी जाँचें। Pro या ट्रायल वर्कस्पेस आवश्यक है।

पैरामीटर	प्रकार	आवश्यक	विवरण
retrospective_id	string	हाँ	रेट्रोस्पेक्टिव uid
items	array of object	हाँ

move_retro_itemPro · retrospectives

एक रेट्रोस्पेक्टिव आइटम स्थानांतरित करें: नए-मॉडल रेट्रोस्पेक्टिव पर एक नोट को पुनः समूहित करें जहाँ वर्कस्पेस में वे हैं, अन्यथा क्लासिक रेट्रोस्पेक्टिव बोर्ड के दूसरे कॉलम में एक कार्ड स्थानांतरित करें। नया मॉडल, केवल Group चरण: topic_id नोट को उस विषय में रखता है (नोट्स का समूह); column (शीर्षक या uid) इसे वहाँ अपना स्वयं का विषय बनाता है, कॉलम के विषयों के बीच position पर (अंतिम के लिए छोड़ें)। expected_updated_at पास करें, get_retrospective से नोट के विषय updated_at, कोड stale के साथ अस्वीकार किए जाने के लिए जब किसी ने इस बीच इसे पुनः समूहित किया। Group के बाहर कॉल को कोड wrong_stage और वर्तमान चरण के साथ अस्वीकार कर दिया जाता है; kudos और अन्य नोट कभी मिश्रित नहीं होते। क्लासिक बोर्ड केवल column और position लेते हैं (position छोड़ा गया = शीर्ष)। Pro या ट्रायल वर्कस्पेस आवश्यक है।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	नोट uid (क्लासिक बोर्ड: आइटम uid) get_retrospective से
topic_id	string		लक्ष्य विषय uid; column छोड़ें
column	string		लक्ष्य कॉलम शीर्षक या uid
position	integer		लक्ष्य कॉलम में सूचकांक (0 = पहला)
expected_updated_at	string		नोट के विषय updated_at जैसा अंतिम पढ़ा गया (संघर्ष जाँच)

list_project_usersकेवल-पढ़ने

किसी प्रोजेक्ट के सदस्यों को सूचीबद्ध करें — एक मानक प्रोजेक्ट के लिए हर वर्कस्पेस सदस्य; निर्माता, वर्कस्पेस स्वामी और व्यवस्थापक, और एक निजी के लिए स्पष्ट रूप से जोड़ा गया कोई भी — ताकि एजेंट नामों का अनुमान लगाने के बजाय असाइनी uid हल कर सके। प्रत्येक सदस्य का uid, पूरा नाम, ईमेल और वर्कस्पेस भूमिका (owner, admin, member या observer) लौटाता है। वे uid वही हैं जो create_card, update_card, create_epic, update_epic और create_roadmap_slot पर assigned_to लेता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता

list_board_listsकेवल-पढ़ने

किसी प्रोजेक्ट के कानबन बोर्ड की सूचियाँ सूचीबद्ध करें ताकि एजेंट एक मान्य move_card गंतव्य हल कर सके। प्रत्येक सक्रिय सूची को प्रदर्शन क्रम में उसके uid (move_card लक्ष्य के रूप में उपयोग योग्य) और प्रदर्शन नाम के साथ लौटाता है। बैकलॉग एक खाली-स्ट्रिंग id के साथ चयन योग्य प्रविष्टि के रूप में शामिल है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता (uid)

list_epicsकेवल-पढ़ने

किसी प्रोजेक्ट के एपिक सूचीबद्ध करें ताकि एजेंट get_epic और कार्ड असाइनमेंट के लिए एपिक uid हल कर सके। प्रत्येक एपिक को प्रदर्शन क्रम में (स्थिति आरोही) उसके uid, संख्या, नाम, विवरण (Markdown), रंग, प्रारंभ/समाप्ति दिनांक और कार्ड गणना के साथ लौटाता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता (uid)
updated_since	string		केवल वे एपिक जिनका रिकॉर्ड इस ISO-8601 दिनांक या डेटाटाइम पर या बाद में बदला। चेतावनी: संग्रह संपादन (चेकलिस्ट, लिंक) एपिक के परिवर्तन समय को नहीं बढ़ा सकते; नाम/दिनांक/विवरण संपादन हमेशा बढ़ाते हैं।

list_labelsकेवल-पढ़ने

किसी प्रोजेक्ट के लेबल सूचीबद्ध करें ताकि एजेंट कार्ड लेखन पर निकट-डुप्लिकेट बनाने के बजाय मौजूदा वर्गीकरण का पुनः उपयोग कर सके। प्रत्येक लेबल को प्रदर्शन क्रम में (स्थिति आरोही) उसके uid, नाम और स्थिति के साथ लौटाता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता (uid)

list_cardsकेवल-पढ़ने योग्य

एक कानबन सूची के कार्ड सूचीबद्ध करें, या जब list_id छोड़ा या खाली हो तो प्रोजेक्ट के बैकलॉग के कार्ड, बोर्ड प्रदर्शन क्रम में (कॉलम के शीर्ष पर पहले, यानी प्लेसमेंट स्थिति अवरोही — वही क्रम जो उत्पाद UI दिखाता है)। फ़िल्टर AND के साथ संयोजित होते हैं: epic_id, label_id, assigned_user_id और reporter_id uids लेते हैं (अज्ञात uid किसी से मेल नहीं खाता); due_date उन कार्डों को रखता है जो दी गई तिथि पर या उससे पहले देय हैं। कार्रवाई-पर्याप्त कार्ड सारांश (uid, शीर्षक, सूची + स्थिति, epic, लेबल, असाइनी, रिपोर्टर, देय तिथि) लौटाता है, जो get_card / move_card / update_card के लिए तैयार हैं, limit (डिफ़ॉल्ट 50, अधिकतम 100) और offset के साथ पृष्ठांकित; total_count पूर्ण फ़िल्टर की गई गिनती है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता (uid)
list_id	string		पढ़ने के लिए सूची uid; बैकलॉग के लिए छोड़ें या खाली स्ट्रिंग पास करें
epic_id	string		केवल इस epic (epic uid) में चुनी गई सूची या बैकलॉग के भीतर कार्ड; सभी सूचियों में एक epic के हर कार्ड को सूचीबद्ध करने के लिए get_epic का उपयोग करें
label_id	string		केवल इस लेबल (label uid) वाले कार्ड
assigned_user_id	string		केवल इस उपयोगकर्ता (user uid) को सौंपे गए कार्ड
reporter_id	string		केवल इस उपयोगकर्ता (user uid) द्वारा रिपोर्ट किए गए (बनाए गए) कार्ड
due_date	string		केवल इस तिथि पर या उससे पहले देय कार्ड (ISO-8601, जैसे 2026-06-10)
updated_since	string		केवल वे कार्ड जिनका रिकॉर्ड इस ISO-8601 तिथि या दिनांक-समय पर या बाद में बदला — "मेरे पिछले चलाने के बाद से क्या बदला" फ़िल्टर। चेतावनी: संलग्न संग्रहों (लेबल, चेकलिस्ट, लिंक) में संपादन कार्ड के परिवर्तन समय को नहीं बढ़ा सकते; शीर्षक/विवरण/स्केलर संपादन हमेशा करते हैं।
limit	integer		पृष्ठ आकार, 1-100 (डिफ़ॉल्ट 50)
offset	integer		छोड़ने के लिए कार्डों की संख्या (डिफ़ॉल्ट 0)

search_cardsकेवल-पढ़ने योग्य

एक प्रोजेक्ट (कानबन बोर्ड और बैकलॉग) के भीतर शीर्षक-उपस्ट्रिंग कार्ड खोज, उत्पाद के इन-प्रोजेक्ट लाइव कार्ड खोज से बिल्कुल मेल खाती है (डेटाबेस केस-असंवेदनशील उपस्ट्रिंग केवल कार्ड शीर्षक पर — विवरण और टिप्पणियाँ खोजी नहीं जातीं; सभी सामग्री प्रकारों में पूर्ण-पाठ खोज के लिए खोज टूल का उपयोग करें), नवीनतम-निर्मित पहले क्रम में। कार्रवाई-पर्याप्त कार्ड सारांश लौटाता है (uid, शीर्षक, सूची प्लेसमेंट + स्थिति, epic, लेबल, असाइनी, रिपोर्टर, देय तिथि); कोई मेल न होने वाली क्वेरी त्रुटि के बजाय खाली कार्ड सरणी लौटाती है। limit (डिफ़ॉल्ट 50, अधिकतम 100) और offset के साथ पृष्ठांकित करें; total_count पूर्ण मिलान गिनती है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता (uid)
query	string	हाँ	कार्ड शीर्षकों के विरुद्ध मिलान करने के लिए पाठ (केस-असंवेदनशील उपस्ट्रिंग)
limit	integer		पृष्ठ आकार, 1-100 (डिफ़ॉल्ट 50)
offset	integer		छोड़ने के लिए मिलान कार्डों की संख्या (डिफ़ॉल्ट 0)

list_attention_cardsPro · मेट्रिक्सकेवल-पढ़ने योग्य

किसी प्रोजेक्ट के कानबन बोर्ड पर ध्यान देने की आवश्यकता वाले कार्ड सूचीबद्ध करें — उत्पाद के मेट्रिक्स पृष्ठों के समान सूचियाँ। प्रकार: stuck (कॉलम में बैठे, बैकलॉग/Done नहीं, 7 दिनों से अधिक समय से स्थानांतरित नहीं; सबसे लंबे समय से अटके पहले), blocking (अधूरे कार्ड जिनसे अन्य कार्ड अवरुद्ध हैं), overdue (अगले 7 दिनों के भीतर देय या पहले से अतिदेय; सबसे जल्दी पहले)। kind एक सूची या 'all' (डिफ़ॉल्ट) चुनता है। वैकल्पिक रूप से एक असाइनी uid या शाब्दिक 'unassigned' द्वारा फ़िल्टर करें। प्रत्येक अनुरोधित अनुभाग get_card / move_card / update_card के लिए तैयार कार्ड सारांश लौटाता है, limit पर सीमित और पूर्ण total_count के साथ। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता (uid)
kind	enum: stuck | blocking | overdue | all		कौन सी ध्यान सूची लौटानी है (डिफ़ॉल्ट 'all' = प्रत्येक सूची अपने अनुभाग के रूप में)
assignee_id	string		केवल इस उपयोगकर्ता uid को सौंपे गए कार्ड, या बिना असाइनी वाले कार्डों के लिए 'unassigned'
limit	integer		प्रति अनुभाग अधिकतम कार्ड, 1-100 (डिफ़ॉल्ट 50)

get_metrics_summaryPro · मेट्रिक्सकेवल-पढ़ने योग्य

किसी प्रोजेक्ट के कानबन बोर्ड पर ध्यान देने की आवश्यकता वाले कार्डों की एक-कॉल गिनती: overdue_cards_count, blocking_cards_count और stuck_cards_count — list_attention_cards के समान परिभाषाएँ, जो प्रत्येक गिनती के पीछे के कार्ड लौटाता है। सस्ता; गहराई से देखने लायक है या नहीं यह तय करने के लिए पहले इसे कॉल करें। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता (uid)

list_roadmap_slotsPro · रोडमैपकेवल-पढ़ने योग्य

किसी प्रोजेक्ट के रोडमैप स्लॉट सूचीबद्ध करें जो एक तिथि विंडो को ओवरलैप करते हैं (डिफ़ॉल्ट: इस महीने से पाँच महीने आगे)। एक स्लॉट दो तिथियों के बीच एक epic निर्धारित करता है और असाइनी ले जा सकता है; एक epic कई स्लॉट रख सकता है, ओवरलैप सहित — यह डिज़ाइन द्वारा है। अधिकतम 200 स्लॉट लौटाता है — यदि सीमित हो तो विंडो को संकीर्ण करें। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता
start_date	string		विंडो प्रारंभ, ISO-8601 (YYYY-MM-DD); डिफ़ॉल्ट: इस महीने की शुरुआत
end_date	string		विंडो समाप्ति, ISO-8601; डिफ़ॉल्ट: start_date + 6 महीने

create_roadmap_slotPro · रोडमैप

प्रोजेक्ट रोडमैप पर एक epic निर्धारित करें: start_date से end_date तक एक स्लॉट, वैकल्पिक रूप से असाइनी के साथ। एक epic कई स्लॉट रख सकता है और ओवरलैप डिज़ाइन द्वारा अनुमत हैं — यदि आप मौजूदा स्लॉट को बढ़ाना चाहते हैं बजाय नया जोड़ने के, तो पहले list_roadmap_slots जाँचें। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट का अद्वितीय पहचानकर्ता
epic_id	string	हाँ	Epic uid (list_epics से); इस प्रोजेक्ट से संबंधित होना चाहिए
start_date	string	हाँ	ISO-8601 (YYYY-MM-DD)
end_date	string	हाँ	ISO-8601; start_date के समान दिन अनुमत है
assigned_to	array of string		असाइन करने के लिए उपयोगकर्ता uids (प्रोजेक्ट सदस्य — list_project_users देखें)

update_roadmap_slotPro · रोडमैप

एक रोडमैप स्लॉट अपडेट करें: पुनर्निर्धारित या आकार बदलें (start_date/end_date), इसे उसी प्रोजेक्ट के दूसरे epic में ले जाएँ (epic_id), या इसके असाइनी सेट करें। केवल आपूर्ति किए गए फ़ील्ड बदलते हैं, EXCEPT assigned_to जो पूर्ण असाइनी सेट को REPLACE करता है — पहले स्लॉट पढ़ें और उन सभी को भेजें जिन्हें बने रहना चाहिए। स्लॉट uids list_roadmap_slots से आते हैं। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	रोडमैप स्लॉट uid
epic_id	string		नया epic uid (समान प्रोजेक्ट)
start_date	string		ISO-8601 (YYYY-MM-DD)
end_date	string		ISO-8601
assigned_to	array of string		सभी असाइनी को REPLACE करता है (उपयोगकर्ता uids, प्रोजेक्ट सदस्य); [] साफ़ करता है

delete_roadmap_slotPro · रोडमैपविनाशकारी

एक रोडमैप स्लॉट (और इसके असाइनी लिंक) को स्थायी रूप से हटाएँ। इसे पूर्ववत नहीं किया जा सकता — रोडमैप स्लॉट के लिए कोई ट्रैश नहीं है। epic स्वयं स्पर्श नहीं किया जाता; पुनर्निर्धारित करने के लिए, update_roadmap_slot को प्राथमिकता दें। Pro या परीक्षण कार्यक्षेत्र की आवश्यकता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	रोडमैप स्लॉट uid (list_roadmap_slots से)

create_label

किसी प्रोजेक्ट पर नाम से एक नया लेबल बनाएँ। यदि समान नाम वाला लेबल पहले से मौजूद है (केस-असंवेदनशील), तो नया लगभग-डुप्लिकेट बनाने के बजाय मौजूदा लेबल अपरिवर्तित लौटाया जाता है। नया लेबल प्रदर्शन क्रम के अंत में जोड़ा जाता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट uid जिससे लेबल संबंधित है
name	string	हाँ

create_card

किसी प्रोजेक्ट के कानबन बोर्ड पर एक कार्ड बनाएँ। केवल project_id और title आवश्यक हैं। कार्ड को बैकलॉग में रखने के लिए list_id छोड़ें; कतार के अंत में शामिल होने के लिए position छोड़ें (move_card स्थिति अनुबंध का दस्तावेजीकरण करता है)। description AgileHero Markup है — कभी markdown या HTML नहीं; पहले get_ahm_spec पढ़ें। epic_id और असाइनी uids पहले से मौजूद होने चाहिए (list_epics, list_project_users), जबकि लेबल नाम जो अभी मौजूद नहीं हैं, प्रोजेक्ट पर बनाए जाते हैं। estimation फाइबोनैचि जटिलता है (0/1/2/3/5/8/13), समय अनुमान नहीं। चेकलिस्ट, लिंक, अनुलग्नक और कार्ड संबंध सभी इसी कॉल में आपूर्ति किए जा सकते हैं।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट uid जिससे कार्ड संबंधित है (कार्ड प्रोजेक्ट के कानबन बोर्ड पर बनाया गया है)
list_id	string		सूची uid; बैकलॉग में रखने के लिए छोड़ें
position	integer
type	enum: story | bug | chore | research
title	string	हाँ
description	string		AgileHero Markup (AHM) — कभी markdown या HTML नहीं; पहले get_ahm_spec पढ़ें। विवरण सतह: कोई तालिकाएँ, रंग, संरेखण या चर्चाएँ नहीं।
epic_id	string		Epic uid; प्रोजेक्ट पर पहले से मौजूद होना चाहिए
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		कहानी बिंदुओं में जटिलता अनुमान (फाइबोनैचि पैमाना), समय अनुमान नहीं
due_date	string		ISO-8601 तिथि
assigned_to	array of string		असाइनी उपयोगकर्ता uids, list_project_users के माध्यम से खोजने योग्य
labels	array of string		लेबल नाम; अज्ञात नाम प्रोजेक्ट पर बनाए जाते हैं
checklists	array of object		प्रत्येक { name, items: [{ description, checked }] }; items आपूर्ति किए गए क्रम को बनाए रखते हैं
cards_relations	array of object		प्रत्येक { type, target_card_id (उसी बोर्ड पर एक कार्ड uid) }
links	array of object		प्रत्येक { url, description }
attachments	array of object		प्रत्येक { url, name }; फ़ाइल url से लाई जाती है

update_cardविनाशकारी

किसी मौजूदा कार्ड को उसके uid द्वारा अपडेट करें। संग्रहों के लिए, add_*/remove_* डेल्टा फ़ील्ड को प्राथमिकता दें (सुरक्षित वृद्धिशील संपादन: add_labels, remove_assignees, add_checklist_items, check_items, …); सादे संग्रह फ़ील्ड (labels, assigned_to, checklists, cards_relations, links, attachments) पिछली स्थिति को विनाशकारी रूप से REPLACE करते हैं और उनके डेल्टा के साथ संयोजित नहीं किए जा सकते। सूची या स्थिति बदलने के लिए move_card का उपयोग करें, और विवरण संपादित करने के लिए preview_description_update / update_description का उपयोग करें।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	कार्ड uid
type	enum: story | bug | chore | research
title	string
epic_id	string
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		स्टोरी पॉइंट्स में जटिलता का अनुमान (फिबोनाची स्केल), समय का अनुमान नहीं
due_date	string		ISO-8601 तिथि
assigned_to	array of string		असाइनी उपयोगकर्ता uid, list_project_users के माध्यम से खोजे जा सकते हैं; कार्ड के असाइनी को प्रतिस्थापित करता है
labels	array of string		लेबल नाम; अज्ञात नाम प्रोजेक्ट पर बनाए जाते हैं; कार्ड के लेबल को प्रतिस्थापित करता है
checklists	array of object		प्रत्येक { name, items: [{ description, checked }] }; आइटम दिए गए क्रम को बनाए रखते हैं; कार्ड की चेकलिस्ट को प्रतिस्थापित करता है
cards_relations	array of object		प्रत्येक { type, target_card_id (उसी बोर्ड पर एक कार्ड uid) }; कार्ड के संबंधों को प्रतिस्थापित करता है
links	array of object		प्रत्येक { url, description }; कार्ड के लिंक को प्रतिस्थापित करता है
attachments	array of object		प्रत्येक { url, name }; फ़ाइल url से लाई जाती है; कार्ड के अनुलग्नकों को प्रतिस्थापित करता है
add_labels	array of string		नाम से लेबल जोड़ें (अज्ञात नाम बनाए जाते हैं); मौजूदा लेबल रखता है
remove_labels	array of string		नाम से लेबल हटाएँ (केस-असंवेदनशील); अनुपस्थित नाम कोई प्रभाव नहीं डालते
add_assignees	array of string		उपयोगकर्ता uid द्वारा असाइनी जोड़ें; मौजूदा असाइनी रखता है
remove_assignees	array of string		उपयोगकर्ता uid द्वारा असाइनी हटाएँ; अनुपस्थित uid कोई प्रभाव नहीं डालते
add_checklist_items	array of object		आइटम जोड़ें: प्रत्येक { checklist, description, checked? } — नामित चेकलिस्ट बनाई जाती है यदि वह मौजूद नहीं है
check_items	array of object		आइटम को पूर्ण के रूप में चिह्नित करें, नामित चेकलिस्ट के भीतर सटीक विवरण से मिलान करके
uncheck_items	array of object		आइटम को अपूर्ण के रूप में चिह्नित करें (check_items के समान मिलान)
remove_checklist_items	array of object		आइटम हटाएँ; अनुपस्थित आइटम कोई प्रभाव नहीं डालते
add_relations	array of object		संबंध जोड़ें; मौजूदा संबंध रखता है
remove_relations	array of object		मिलान वाले संबंध हटाएँ; अनुपस्थित संबंध कोई प्रभाव नहीं डालते
add_links	array of object		लिंक जोड़ें: प्रत्येक { url, description? }; मौजूदा लिंक रखता है
remove_links	array of string		सटीक url द्वारा लिंक हटाएँ; अनुपस्थित url कोई प्रभाव नहीं डालते

delete_carddestructive

किसी कार्ड को उसके uid द्वारा सॉफ्ट-डिलीट करें: यह बोर्ड और हर सूची से हट जाता है, अन्य कार्डों से इसके संबंध हटा दिए जाते हैं, इस पर कोई भी अनुमान सत्र निष्क्रिय हो जाता है, और इससे जुड़े व्हाइटबोर्ड तत्व अनलिंक हो जाते हैं। जिस epic से यह संबंधित था वह हटाया नहीं जाता। MCP के माध्यम से अनडिलीट नहीं किया जा सकता।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	कार्ड uid

move_card

किसी कार्ड को किसी भिन्न सूची में ले जाएँ (या उसी सूची के भीतर उसकी स्थिति बदलें)। केवल कानबन बोर्ड पर कार्ड ही ले जाए जा सकते हैं; रेट्रोस्पेक्टिव बोर्ड पर कार्ड अस्वीकार कर दिए जाते हैं। कार्ड को कानबन बैकलॉग में ले जाने के लिए list_id के लिए खाली स्ट्रिंग पास करें। एक सूची अपनी उच्चतम स्थिति से ऊपर से नीचे प्रदर्शित होती है, इसलिए स्थिति 0 सूची के नीचे (BOTTOM) होती है। position को छोड़ दें तो बैकलॉग और to_do और in_progress सूचियों में कतार के अंत (नीचे, स्थिति 0) में शामिल हों, या done सूची के शीर्ष पर।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	कार्ड uid
list_id	string	हाँ	लक्ष्य सूची uid; खाली स्ट्रिंग बैकलॉग में ले जाती है (केवल कानबन)
position	integer		लक्ष्य के भीतर स्थान: 0 नीचे है और उच्चतम स्थिति शीर्ष है। 0 और लक्ष्य में पहले से मौजूद अन्य कार्डों की संख्या के बीच होना चाहिए। इसे छोड़ दें तो बैकलॉग और to_do और in_progress सूचियों में कतार के अंत (स्थिति 0) में शामिल हों, या done सूची के शीर्ष पर।

create_epic

किसी प्रोजेक्ट पर एक epic बनाएँ। केवल project_id और name आवश्यक हैं। description AgileHero Markup है — कभी markdown या HTML नहीं; पहले get_ahm_spec पढ़ें। असाइनी uid list_project_users से आते हैं। चेकलिस्ट, लिंक और अनुलग्नक इसी कॉल में दिए जा सकते हैं। नया epic uid लौटाता है — जिसे create_card / update_card epic_id के रूप में लेते हैं, और जिसे create_roadmap_slot शेड्यूल करता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
project_id	string	हाँ	प्रोजेक्ट uid जिससे epic संबंधित है
name	string	हाँ
description	string		AgileHero Markup (AHM) — कभी markdown या HTML नहीं; पहले get_ahm_spec पढ़ें। विवरण सतह: कोई तालिकाएँ, रंग, संरेखण या चर्चाएँ नहीं।
color	string		हेक्स रंग जैसे #0060F0
start_date	string		ISO-8601 तिथि
end_date	string		ISO-8601 तिथि
assigned_to	array of string		असाइनी उपयोगकर्ता uid, list_project_users के माध्यम से खोजे जा सकते हैं
checklists	array of object		प्रत्येक { name, items: [{ description, checked }] }; आइटम दिए गए क्रम को बनाए रखते हैं
links	array of object		प्रत्येक { url, description }
attachments	array of object		प्रत्येक { url, name }; फ़ाइल url से लाई जाती है

update_epicdestructive

किसी मौजूदा epic को उसके uid द्वारा अपडेट करें; केवल दिए गए फ़ील्ड बदले जाते हैं। संग्रहों के लिए, add_*/remove_* डेल्टा फ़ील्ड पसंद करें (सुरक्षित वृद्धिशील संपादन); सादे संग्रह फ़ील्ड (assigned_to, checklists, links, attachments) पिछली स्थिति को विनाशकारी रूप से प्रतिस्थापित करते हैं और उनके डेल्टा के साथ संयोजित नहीं किए जा सकते। विवरण संपादित करने के लिए preview_description_update / update_description का उपयोग करें।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	Epic uid
name	string
color	string		हेक्स रंग जैसे #0060F0
start_date	string		ISO-8601 तिथि
end_date	string		ISO-8601 तिथि
assigned_to	array of string		असाइनी उपयोगकर्ता uid, list_project_users के माध्यम से खोजे जा सकते हैं; epic के असाइनी को प्रतिस्थापित करता है
checklists	array of object		प्रत्येक { name, items: [{ description, checked }] }; epic की चेकलिस्ट को प्रतिस्थापित करता है
links	array of object		प्रत्येक { url, description }; epic के लिंक को प्रतिस्थापित करता है
attachments	array of object		प्रत्येक { url, name }; फ़ाइल url से लाई जाती है; epic के अनुलग्नकों को प्रतिस्थापित करता है
add_assignees	array of string		उपयोगकर्ता uid द्वारा असाइनी जोड़ें; मौजूदा असाइनी रखता है
remove_assignees	array of string		उपयोगकर्ता uid द्वारा असाइनी हटाएँ; अनुपस्थित uid कोई प्रभाव नहीं डालते
add_checklist_items	array of object		आइटम जोड़ें: प्रत्येक { checklist, description, checked? } — नामित चेकलिस्ट बनाई जाती है यदि वह मौजूद नहीं है
check_items	array of object		आइटम को पूर्ण के रूप में चिह्नित करें, नामित चेकलिस्ट के भीतर सटीक विवरण से मिलान करके
uncheck_items	array of object		आइटम को अपूर्ण के रूप में चिह्नित करें (check_items के समान मिलान)
remove_checklist_items	array of object		आइटम हटाएँ; अनुपस्थित आइटम कोई प्रभाव नहीं डालते
add_links	array of object		लिंक जोड़ें: प्रत्येक { url, description? }; मौजूदा लिंक रखता है
remove_links	array of string		सटीक url द्वारा लिंक हटाएँ; अनुपस्थित url कोई प्रभाव नहीं डालते

delete_epicdestructive

किसी epic को उसके uid द्वारा सॉफ्ट-डिलीट करें। इसके कार्ड हटाए नहीं जाते — वे बोर्ड पर रहते हैं, epic से अलग। epic के रोडमैप स्लॉट स्थायी रूप से हटा दिए जाते हैं (एक स्लॉट एक epic को शेड्यूल करता है, इसलिए इसके बिना यह अर्थहीन है), और epic से जुड़े व्हाइटबोर्ड तत्व अनलिंक हो जाते हैं।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	Epic uid

create_comment

किसी कार्ड या epic पर टिप्पणी जोड़ें। card_id या epic_id में से ठीक एक प्रदान करें। सामग्री AgileHero Markup है (AHM, टिप्पणी सतह: कोई तालिकाएँ, मीडिया, रंग, संरेखण या चर्चाएँ नहीं) — कभी markdown या HTML नहीं; पहले get_ahm_spec पढ़ें। टिप्पणी उस साइन-इन उपयोगकर्ता को आरोपित की जाती है जिसके रूप में यह क्लाइंट कार्य करता है और बाद के get_card / get_epic प्रतिक्रियाओं में दिखाई देती है। टिप्पणियाँ MCP के माध्यम से संपादित नहीं की जा सकतीं; delete_comment आपकी अपनी टिप्पणियाँ हटाता है (गलतियों को हटाकर + पुनः पोस्ट करके सुधारें)। मौजूदा टिप्पणी का उत्तर देने के लिए parent_comment_id पास करें। थ्रेड एक स्तर गहरे होते हैं: किसी उत्तर का उत्तर देने पर नई टिप्पणी उस उत्तर के थ्रेड रूट से जुड़ जाती है, इसलिए उत्तरों को नेस्ट करने का प्रयास न करें। मूल टिप्पणी उसी कार्ड या epic पर होनी चाहिए — कहीं और से एक uid अस्वीकार कर दिया जाता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
card_id	string		टिप्पणी करने के लिए कार्ड uid (epic_id के साथ परस्पर अनन्य)
epic_id	string		टिप्पणी करने के लिए Epic uid (card_id के साथ परस्पर अनन्य)
content	string	हाँ	टिप्पणी का मुख्य भाग AgileHero Markup (AHM) के रूप में
parent_comment_id	string		उसी कार्ड या epic पर एक टिप्पणी का वैकल्पिक uid जिसका उत्तर देना है। शीर्ष-स्तरीय टिप्पणी के लिए छोड़ दें। किसी उत्तर का उत्तर देने पर वह उस उत्तर के थ्रेड रूट पर सामान्यीकृत हो जाता है (थ्रेड एक स्तर गहरे होते हैं)।

delete_commentdestructive

आपके द्वारा पोस्ट की गई टिप्पणी हटाएँ (टिप्पणियाँ उस साइन-इन उपयोगकर्ता को आरोपित होती हैं जिसके रूप में यह क्लाइंट कार्य करता है — अन्य लोगों की टिप्पणियाँ हटाई नहीं जा सकतीं)। सुधार पैटर्न हटाना + create_comment के साथ सुधारित टिप्पणी पोस्ट करना है। एक हटाई गई टिप्पणी जिसके उत्तर हैं, अपने थ्रेड में एक टॉम्बस्टोन के रूप में दिखाई देती है। टिप्पणी uid get_card / get_epic से आते हैं।

पैरामीटर	प्रकार	आवश्यक	विवरण
id	string	हाँ	टिप्पणी uid