Initial commit

skills/mxcp-expert/assets/project-templates/jira-oauth/tools/jql.yml

@@ -0,0 +1,50 @@
+mxcp: 1
+
+tool:
+  name: jql
+  description: |
+    Execute a JQL (Jira Query Language) query to search for issues in your Jira instance using OAuth authentication.
+    Returns a JSON string containing the matching issues with their details.
+    Use the start and limit parameters to paginate through large result sets.
+  type: tool
+  annotations:
+    title: JQL Query (OAuth)
+    readOnlyHint: true
+    destructiveHint: false
+    idempotentHint: true
+    openWorldHint: true
+  parameters:
+    - name: query
+      type: string
+      description: |
+        The JQL query string to execute. Examples:
+        - "project = TEST" to find all issues in the TEST project
+        - "assignee = currentUser()" to find issues assigned to you
+        - "status = 'In Progress'" to find issues in progress
+      examples: [
+        "project = TEST",
+        "status = 'In Progress'",
+        "project = TEST AND status = 'Done'",
+        "created >= -30d ORDER BY created DESC"
+      ]
+    - name: start
+      type: integer
+      description: |
+        The index of the first result to return (0-based).
+        Use this for pagination: start=0 for first page, start=50 for second page, etc.
+        Defaults to 0 if not specified.
+      examples: [0, 50, 100]
+    - name: limit
+      type: integer
+      description: |
+        Maximum number of results to return.
+        If not specified, returns all matching results.
+        Recommended to use with start parameter for pagination.
+      examples: [50, 100, 200]
+  return:
+    type: string
+    description: |
+      A JSON string containing an array of Jira issues.
+  language: "sql"
+  source:
+    file: "../sql/jql.sql"