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"