Files
gh-raw-labs-claude-code-mar…/skills/mxcp-expert/assets/project-templates/jira-oauth/tools/jql.yml
2025-11-30 08:49:50 +08:00

51 lines
1.6 KiB
YAML

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"