Initial commit

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

@@ -0,0 +1,25 @@
+mxcp: 1
+
+tool:
+  name: get_current_user
+  description: |
+    Get the username of the currently authenticated user in MXCP.
+    This tool returns the username of the person who is authenticated via OAuth with Jira.
+    It's useful for understanding whose credentials are being used for Jira API calls,
+    and can help verify that the OAuth authentication flow completed successfully.
+    The username typically corresponds to the Atlassian account email address.
+  type: tool
+  annotations:
+    title: Get Current Authenticated User
+    readOnlyHint: true
+    destructiveHint: false
+    idempotentHint: true
+    openWorldHint: false
+  return:
+    type: string
+    description: |
+      The username (typically email address) of the currently authenticated user.
+      Returns NULL if no user is authenticated.
+  language: "sql"
+  source:
+    file: "../sql/get_current_user.sql" 

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

@@ -0,0 +1,32 @@
+mxcp: 1
+
+tool:
+  name: get_project
+  description: |
+    Get details for a specific project in your Jira instance by its project key using OAuth authentication.
+    Returns a JSON string containing the project's details.
+  type: tool
+  annotations:
+    title: Get Project Details (OAuth)
+    readOnlyHint: true
+    destructiveHint: false
+    idempotentHint: true
+    openWorldHint: true
+  parameters:
+    - name: project_key
+      type: string
+      description: |
+        The project key to search for. This is the short identifier for the project (e.g., 'TEST' for project TEST).
+        Project keys are typically uppercase and contain only letters and numbers.
+      examples: [
+        "TEST",
+        "PROJ",
+        "DEV"
+      ]
+  return:
+    type: string
+    description: |
+      A JSON string containing the project's details.
+  language: "sql"
+  source:
+    file: "../sql/get_project.sql" 

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

@@ -0,0 +1,30 @@
+mxcp: 1
+
+tool:
+  name: get_user
+  description: |
+    Get details for a specific user in your Jira instance by their username using OAuth authentication.
+    Returns a JSON string containing the user's details.
+  type: tool
+  annotations:
+    title: Get User Details (OAuth)
+    readOnlyHint: true
+    destructiveHint: false
+    idempotentHint: true
+    openWorldHint: true
+  parameters:
+    - name: username
+      type: string
+      description: |
+        The username to search for. This is typically the user's email address or username in Jira.
+      examples: [
+        "john.doe@example.com",
+        "jane.smith"
+      ]
+  return:
+    type: string
+    description: |
+      A JSON string containing the user's details.
+  language: "sql"
+  source:
+    file: "../sql/get_user.sql" 

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" 

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

@@ -0,0 +1,21 @@
+mxcp: 1
+
+tool:
+  name: list_projects
+  description: |
+    List all projects in your Jira instance using OAuth authentication.
+    Returns a JSON string containing an array of projects with their details.
+  type: tool
+  annotations:
+    title: List Projects (OAuth)
+    readOnlyHint: true
+    destructiveHint: false
+    idempotentHint: true
+    openWorldHint: true
+  return:
+    type: string
+    description: |
+      A JSON string containing an array of Jira projects.
+  language: "sql"
+  source:
+    file: "../sql/list_projects.sql"