agentek-youtrack-mcp 1.0.1 → 1.1.0

package/dist/python/main.py

@@ -11,7 +11,7 @@ from mcp.server.fastmcp import FastMCP
 
 from youtrack_mcp.version import __version__ as APP_VERSION
 from youtrack_mcp.config import config
-from youtrack_mcp.tools.loader import load_all_tools
+from youtrack_mcp.tools.loader import load_all_tools, tool_description
 
 # Set up logging
 logging.basicConfig(
@@ -34,7 +34,7 @@ def create_server(host: str = "0.0.0.0", port: int = 8000) -> FastMCP:
     # Load and register all tools
     tools = load_all_tools()
     for name, func in tools.items():
-        mcp.add_tool(func, name=name)
+        mcp.add_tool(func, name=name, description=tool_description(func))
 
     logger.info(f"Registered {len(tools)} tools with FastMCP")
     return mcp

package/dist/python/youtrack_mcp/api/issues.py

@@ -183,6 +183,7 @@ class IssuesClient:
         summary: str,
         description: Optional[str] = None,
         additional_fields: Optional[Dict[str, Any]] = None,
+        custom_fields: Optional[Dict[str, Any]] = None,
     ) -> Issue:
         """
         Create a new issue.
@@ -192,6 +193,9 @@ class IssuesClient:
             summary: The issue summary
             description: The issue description
             additional_fields: Additional fields to set on the issue
+            custom_fields: Custom field names/values sent in the same POST as
+                the issue itself — projects whose required fields have no
+                default value reject a create without them
 
         Returns:
             The created issue data
@@ -209,6 +213,11 @@ class IssuesClient:
         if description:
             data["description"] = description
 
+        if custom_fields:
+            data.update(
+                self._build_custom_fields_payload(custom_fields, project_id)
+            )
+
         if additional_fields:
             data.update(additional_fields)
 
@@ -266,6 +275,7 @@ class IssuesClient:
         issue_id: str,
         summary: Optional[str] = None,
         description: Optional[str] = None,
+        uses_markdown: Optional[bool] = None,
         additional_fields: Optional[Dict[str, Any]] = None,
     ) -> Issue:
         """
@@ -275,6 +285,9 @@ class IssuesClient:
             issue_id: The issue ID or readable ID
             summary: The new issue summary
             description: The new issue description
+            uses_markdown: Whether the description is rendered as Markdown
+                (True) or YouTrack Wiki markup (False). Leave as None to keep
+                the issue's current setting.
             additional_fields: Additional fields to update
 
         Returns:
@@ -288,6 +301,9 @@ class IssuesClient:
         if description is not None:
             data["description"] = description
 
+        if uses_markdown is not None:
+            data["usesMarkdown"] = uses_markdown
+
         if additional_fields:
             data.update(additional_fields)
 

package/dist/python/youtrack_mcp/tools/issues/__init__.py

@@ -129,9 +129,25 @@ class IssueTools:
         """Search for issues using YouTrack query syntax."""
         return self.basic_operations.search_issues(query, limit)
     
-    def create_issue(self, project: str, summary: str, description: Optional[str] = None) -> str:
-        """Create a new issue in the specified project."""
-        return self.basic_operations.create_issue(project, summary, description)
+    def create_issue(
+        self,
+        project: str,
+        summary: str,
+        description: Optional[str] = None,
+        custom_fields: Optional[Dict[str, Any]] = None,
+    ) -> str:
+        """Create a new issue in the specified project, optionally setting custom fields in the same request.
+
+        custom_fields maps field names to values and is sent together with the issue itself.
+        Projects whose mandatory fields have no default value reject a create without them,
+        so pass those fields here instead of updating the issue afterwards.
+        Use get_custom_fields / get_available_custom_field_values to discover names and allowed values.
+
+        Example: create_issue(project="DEMO", summary="Bug in login",
+                              description="Users cannot log in",
+                              custom_fields={"Priority": "Critical", "Type": "Bug", "Assignee": "john.doe"})
+        """
+        return self.basic_operations.create_issue(project, summary, description, custom_fields)
     
     def update_issue(self, issue_id: str, summary: Optional[str] = None, description: Optional[str] = None, uses_markdown: Optional[bool] = None, additional_fields: Optional[Dict[str, Any]] = None) -> str:
         """Update basic issue fields."""

package/dist/python/youtrack_mcp/tools/issues/basic_operations.py

@@ -107,7 +107,8 @@ class BasicOperations:
             project: The project identifier (e.g., "DEMO", "PROJECT")
             summary: The issue title/summary
             description: Optional detailed description of the issue
-            custom_fields: Optional dictionary of custom field names and values to set on creation (e.g., {"Assignee": "john.doe", "Priority": "Critical"})
+            custom_fields: Optional dictionary of custom field names and values, sent in the same API call as the issue
+                (required for projects where mandatory fields have no default value)
 
         Returns:
             JSON string with the created issue information
@@ -161,7 +162,7 @@ class BasicOperations:
             # Call the API client to create the issue
             try:
                 issue = self.issues_api.create_issue(
-                    project_id, summary, description
+                    project_id, summary, description, custom_fields=custom_fields
                 )
 
                 # Check if we got an issue with an ID
@@ -169,14 +170,6 @@ class BasicOperations:
                     # Handle error returned as a dict
                     return format_json_response(issue)
 
-                # Apply custom fields if provided
-                if custom_fields and hasattr(issue, "id") and issue.id:
-                    try:
-                        logger.info(f"Setting custom fields on new issue {issue.id}: {custom_fields}")
-                        self.issues_api.update_issue_custom_fields(issue.id, custom_fields, validate=False)
-                    except Exception as cf_err:
-                        logger.warning(f"Issue created but failed to set custom fields: {cf_err}")
-
                 # Try to get full issue details right after creation
                 if hasattr(issue, "id"):
                     try:
@@ -224,6 +217,7 @@ class BasicOperations:
         issue_id: str,
         summary: Optional[str] = None,
         description: Optional[str] = None,
+        uses_markdown: Optional[bool] = None,
         additional_fields: Optional[Dict[str, Any]] = None,
     ) -> str:
         """
@@ -235,6 +229,9 @@ class BasicOperations:
             issue_id: The issue identifier (e.g., "DEMO-123", "PROJECT-456")
             summary: The new issue summary/title (optional)
             description: The new issue description (optional)
+            uses_markdown: Whether the description is rendered as Markdown
+                (True) or YouTrack Wiki markup (False); leave as None to keep
+                the current setting (optional)
             additional_fields: Additional fields to update as dict (optional)
 
         Returns:
@@ -245,6 +242,7 @@ class BasicOperations:
                 issue_id=issue_id,
                 summary=summary,
                 description=description,
+                uses_markdown=uses_markdown,
                 additional_fields=additional_fields,
             )
             # Convert Issue object to dict if needed
@@ -295,12 +293,12 @@ class BasicOperations:
                 }
             },
             "create_issue": {
-                "description": "Create a new issue in YouTrack with automatic project validation. Accepts both project short names (DEMO) and project IDs (0-1). Supports setting custom fields at creation time. Example: create_issue(project='DEMO', summary='Bug in login', description='Users cannot log in', custom_fields={'Assignee': 'john.doe', 'Priority': 'Critical'})",
+                "description": "Create a new issue in YouTrack with automatic project validation. Accepts both project short names (DEMO) and project IDs (0-1). Custom fields are sent in the same API call as the issue, so projects with mandatory fields (no default value) can be created in one step. Example: create_issue(project='DEMO', summary='Bug in login', description='Users cannot log in', custom_fields={'Assignee': 'john.doe', 'Priority': 'Critical'})",
                 "parameter_descriptions": {
                     "project": "Project identifier (short name like 'DEMO' or ID like '0-1')",
                     "summary": "Issue title/summary (required)",
                     "description": "Detailed description of the issue (optional)",
-                    "custom_fields": "Optional dictionary of custom field names to values to set on creation (e.g., {'Assignee': 'john.doe', 'Priority': 'Critical', 'Fix versions': ['1.0', '1.1']})"
+                    "custom_fields": "Optional dictionary of custom field names to values, applied atomically with issue creation (e.g., {'Assignee': 'john.doe', 'Priority': 'Critical', 'Fix versions': ['1.0', '1.1']})"
                 }
             },
             "update_issue": {
@@ -309,6 +307,7 @@ class BasicOperations:
                     "issue_id": "Issue identifier like 'DEMO-123' or 'PROJECT-456'",
                     "summary": "New issue summary/title (optional)",
                     "description": "New issue description (optional)",
+                    "uses_markdown": "Set True to render the description as Markdown, False for YouTrack Wiki markup; omit to keep the current setting (optional)",
                     "additional_fields": "Additional fields to update as dictionary (optional)"
                 }
             },

package/dist/python/youtrack_mcp/tools/loader.py

@@ -325,6 +325,27 @@ def load_all_tools() -> Dict[str, Callable]:
     return tools
 
 
+def tool_description(func: Callable) -> Any:
+    """
+    Build the description an MCP client sees for a tool.
+
+    Renders the tool's `tool_definition` (description + parameter_descriptions) into text.
+    Returns None when the tool has no definition, so FastMCP falls back to the docstring.
+    """
+    definition = getattr(func, "tool_definition", None)
+    if not definition or not definition.get("description"):
+        return None
+
+    lines = [definition["description"]]
+    parameters = definition.get("parameter_descriptions") or {}
+    if parameters:
+        lines.append("")
+        lines.append("Parameters:")
+        lines.extend(f"- {name}: {text}" for name, text in parameters.items())
+
+    return "\n".join(lines)
+
+
 def _get_tools_from_class(tool_class: Any) -> Dict[str, Callable]:
     """
     Get all tools from a tool class.

package/dist/python/youtrack_mcp/version.py

@@ -2,4 +2,4 @@
 YouTrack MCP Server version information.
 """
 
-__version__ = "1.0.1"
+__version__ = "1.1.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentek-youtrack-mcp",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "A Model Context Protocol (MCP) server for JetBrains YouTrack integration",
   "keywords": [
     "mcp",