Jira Insights MCP

{ "properties": { "aql": { "description": "AQL query string. Required for query operation. \n\nIMPORTANT: For comprehensive AQL documentation, refer to the \"jira-insights://aql-syntax\" resource using the access_mcp_resource tool. This resource contains detailed syntax guides, examples, and best practices.\n\nGuide to Constructing Better Jira Insight AQL Queries:\n\nUnderstanding AQL Fundamentals:\n- Object Type Case Sensitivity: Use exact case matching for object type names (e.g., ObjectType = \"Supported laptops\" not objectType = \"Supported laptops\").\n- String Values in Quotes: Always enclose string values in double quotes, especially values containing spaces (e.g., Name = \"MacBook Pro\" not Name = MacBook Pro).\n- Attribute References: Reference attributes directly by their name, not by a derived field name (e.g., use Name not name).\n- LIKE Operator Usage: Use the LIKE operator for partial string matching, but be aware it may be case-sensitive.\n\nEffective Query Construction:\n- Start Simple: Begin with the most basic query to validate object existence before adding complex filters:\n ObjectType = \"Supported laptops\"\n- Examine Response Objects: Study the first responses to understand available attribute names and formats before using them in filters.\n- Keyword Strategy: When searching for specific items, try multiple potential keywords (e.g., \"ThinkPad\", \"Lenovo\", \"Carbon\") rather than just exclusion logic.\n- Incremental Complexity: Add filter conditions incrementally, testing after each addition rather than constructing complex queries in one step.\n\nManaging Complex Queries:\n- AND/OR Operators: Structure complex conditions carefully with proper parentheses:\n ObjectType = \"Supported laptops\" AND (Name LIKE \"ThinkPad\" OR Name LIKE \"Lenovo\")\n- NOT Operators: Use NOT sparingly and with proper syntax:\n ObjectType = \"Supported laptops\" AND NOT Name LIKE \"MacBook\"\n- Reference Object Queries: For filtering on related objects, use their object key as a reference:\n ObjectType = \"Supported laptops\" AND Manufacturer = \"PPL-231\"\n- Pagination Awareness: For large result sets, utilize the startAt and maxResults parameters to get complete data.", "type": "string" }, "attributes": { "description": "Attributes of the object as key-value pairs. Optional for create/update.", "type": "object" }, "expand": { "description": "Optional fields to include in the response", "items": { "enum": [ "attributes", "objectType", "schema", "history" ], "type": "string" }, "type": "array" }, "includeAttributes": { "default": true, "description": "Should the objects attributes be included in the response. If this parameter is false only the information on the object will be returned and the object attributes will not be present.", "type": "boolean" }, "includeAttributesDeep": { "default": 1, "description": "How many levels of attributes should be included. E.g. consider an object A that has a reference to object B that has a reference to object C. If object A is included in the response and includeAttributesDeep=1 object A's reference to object B will be included in the attributes of object A but object B's reference to object C will not be included. However if the includeAttributesDeep=2 then object B's reference to object C will be included in object B's attributes.", "type": "integer" }, "includeExtendedInfo": { "default": false, "description": "Include information about open Jira issues. Should each object have information if open tickets are connected to the object?", "type": "boolean" }, "includeTypeAttributes": { "default": false, "description": "Should the response include the object type attribute definition for each attribute that is returned with the objects.", "type": "boolean" }, "maxResults": { "default": 50, "description": "Maximum number of objects to return. Used for list and query operations. Can also use snake_case \"max_results\".", "type": "integer" }, "name": { "description": "Name of the object. Required for create operation, optional for update.", "type": "string" }, "objectId": { "description": "The ID of the object. Required for get, update, and delete operations. Can also use snake_case \"object_id\".", "type": "string" }, "objectTypeId": { "description": "The ID of the object type. Required for create operation. Can also use snake_case \"object_type_id\".", "type": "string" }, "operation": { "description": "Operation to perform on the object", "enum": [ "get", "list", "create", "update", "delete", "query" ], "type": "string" }, "resolveAttributeNames": { "default": true, "description": "Replace attribute IDs (attr_xxx) with actual attribute names in the response. This provides more meaningful attribute names for better readability.", "type": "boolean" }, "schemaId": { "description": "The ID of the schema to use for enhanced validation. When provided, the query will be validated against the schema structure, providing better error messages and suggestions.", "type": "string" }, "simplifiedResponse": { "default": true, "description": "Return a simplified response with only essential key-value pairs, excluding detailed metadata, references, and type definitions. Useful for reducing response size and improving readability.", "type": "boolean" }, "startAt": { "default": 0, "description": "Index of the first object to return (0-based). Used for list and query operations. Can also use snake_case \"start_at\".", "type": "integer" } }, "required": [ "operation" ], "type": "object" }