OAUTH2_TOKEN='...'
USERNAME_PASSWORD_BASE64='...'

npx @open-mcp/config add jira \
  ~/Library/Application\ Support/Claude/claude_desktop_config.json \
  --OAUTH2_TOKEN=$OAUTH2_TOKEN \
  --USERNAME_PASSWORD_BASE64=$USERNAME_PASSWORD_BASE64

npx @open-mcp/config add jira \
  .cursor/mcp.json \
  --OAUTH2_TOKEN=$OAUTH2_TOKEN \
  --USERNAME_PASSWORD_BASE64=$USERNAME_PASSWORD_BASE64

npx @open-mcp/config add jira \
  /path/to/client/config.json \
  --OAUTH2_TOKEN=$OAUTH2_TOKEN \
  --USERNAME_PASSWORD_BASE64=$USERNAME_PASSWORD_BASE64

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@open-mcp/jira"],
      "env": {"OAUTH2_TOKEN":"...","USERNAME_PASSWORD_BASE64":"..."}
    }
  }
}

npx -y @modelcontextprotocol/inspector npx -y @open-mcp/jira

{
  toolName: z.string(),
  jsonPointers: z.array(z.string().startsWith("/").describe("The pointer to the JSON schema object which needs expanding")).describe("A list of JSON pointers"),
}

{}

{
  "isDismissible": z.boolean().describe("Flag indicating if the announcement banner can be dismissed by the user.").optional(),
  "isEnabled": z.boolean().describe("Flag indicating if the announcement banner is enabled or not.").optional(),
  "message": z.string().describe("The text on the announcement banner.").optional(),
  "visibility": z.string().describe("Visibility of the announcement banner. Can be public or private.").optional()
}

{
  "id": z.array(z.number().int()).describe("The list of configuration IDs. To include multiple configurations, separate IDs with an ampersand: \`id=10000&id=10001\`. Can't be provided with \`fieldContextId\`, \`issueId\`, \`projectKeyOrId\`, or \`issueTypeId\`.").optional(),
  "fieldContextId": z.array(z.number().int()).describe("The list of field context IDs. To include multiple field contexts, separate IDs with an ampersand: \`fieldContextId=10000&fieldContextId=10001\`. Can't be provided with \`id\`, \`issueId\`, \`projectKeyOrId\`, or \`issueTypeId\`.").optional(),
  "issueId": z.number().int().describe("The ID of the issue to filter results by. If the issue doesn't exist, an empty list is returned. Can't be provided with \`projectKeyOrId\`, or \`issueTypeId\`.").optional(),
  "projectKeyOrId": z.string().describe("The ID or key of the project to filter results by. Must be provided with \`issueTypeId\`. Can't be provided with \`issueId\`.").optional(),
  "issueTypeId": z.string().describe("The ID of the issue type to filter results by. Must be provided with \`projectKeyOrId\`. Can't be provided with \`issueId\`.").optional(),
  "startAt": z.number().int().describe("The index of the first item to return in a page of results (page offset).").optional(),
  "maxResults": z.number().int().describe("The maximum number of items to return per page.").optional(),
  "fieldIdsOrKeys": z.array(z.string()).min(1).describe("List of IDs or keys of the custom fields. It can be a mix of IDs and keys in the same query.")
}

{
  "generateChangelog": z.boolean().describe("Whether to generate a changelog for this update.").optional(),
  "updates": z.array(z.object({ "customField": z.string().describe("The ID or key of the custom field. For example, \`customfield_10010\`."), "issueIds": z.array(z.number().int()).describe("The list of issue IDs."), "value": z.any().describe("The value for the custom field. The value must be compatible with the [custom field type](https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field/#data-types) as follows:\n\n *  \`string\` the value must be a string.\n *  \`number\` the value must be a number.\n *  \`datetime\` the value must be a string that represents a date in the ISO format or the simplified extended ISO format. For example, \`\"2023-01-18T12:00:00-03:00\"\` or \`\"2023-01-18T12:00:00.000Z\"\`. However, the milliseconds part is ignored.\n *  \`user\` the value must be an object that contains the \`accountId\` field.\n *  \`group\` the value must be an object that contains the group \`name\` or \`groupId\` field. Because group names can change, we recommend using \`groupId\`.\n\nA list of appropriate values must be provided if the field is of the \`list\` [collection type](https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field/#collection-types).") }).strict().describe("A custom field and its new value with a list of issue to update.")).optional()
}

{
  "fieldIdOrKey": z.string().describe("The ID or key of the custom field, for example \`customfield_10000\`."),
  "id": z.array(z.number().int()).describe("The list of configuration IDs. To include multiple configurations, separate IDs with an ampersand: \`id=10000&id=10001\`. Can't be provided with \`fieldContextId\`, \`issueId\`, \`projectKeyOrId\`, or \`issueTypeId\`.").optional(),
  "fieldContextId": z.array(z.number().int()).describe("The list of field context IDs. To include multiple field contexts, separate IDs with an ampersand: \`fieldContextId=10000&fieldContextId=10001\`. Can't be provided with \`id\`, \`issueId\`, \`projectKeyOrId\`, or \`issueTypeId\`.").optional(),
  "issueId": z.number().int().describe("The ID of the issue to filter results by. If the issue doesn't exist, an empty list is returned. Can't be provided with \`projectKeyOrId\`, or \`issueTypeId\`.").optional(),
  "projectKeyOrId": z.string().describe("The ID or key of the project to filter results by. Must be provided with \`issueTypeId\`. Can't be provided with \`issueId\`.").optional(),
  "issueTypeId": z.string().describe("The ID of the issue type to filter results by. Must be provided with \`projectKeyOrId\`. Can't be provided with \`issueId\`.").optional(),
  "startAt": z.number().int().describe("The index of the first item to return in a page of results (page offset).").optional(),
  "maxResults": z.number().int().describe("The maximum number of items to return per page.").optional()
}

{
  "fieldIdOrKey": z.string().describe("The ID or key of the custom field, for example \`customfield_10000\`."),
  "configurations": z.array(z.object({ "configuration": z.any().describe("The field configuration.").optional(), "fieldContextId": z.string().describe("The ID of the field context the configuration is associated with.").readonly(), "id": z.string().describe("The ID of the configuration."), "schema": z.any().describe("The field value schema.").optional() }).strict().describe("Details of the contextual configuration for a custom field.")).min(1).max(1000).describe("The list of custom field configuration details.")
}

{
  "fieldIdOrKey": z.string().describe("The ID or key of the custom field. For example, \`customfield_10010\`."),
  "generateChangelog": z.boolean().describe("Whether to generate a changelog for this update.").optional(),
  "updates": z.array(z.object({ "issueIds": z.array(z.number().int()).describe("The list of issue IDs."), "value": z.any().describe("The value for the custom field. The value must be compatible with the [custom field type](https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field/#data-types) as follows:\n\n *  \`string\` the value must be a string.\n *  \`number\` the value must be a number.\n *  \`datetime\` the value must be a string that represents a date in the ISO format or the simplified extended ISO format. For example, \`\"2023-01-18T12:00:00-03:00\"\` or \`\"2023-01-18T12:00:00.000Z\"\`. However, the milliseconds part is ignored.\n *  \`user\` the value must be an object that contains the \`accountId\` field.\n *  \`group\` the value must be an object that contains the group \`name\` or \`groupId\` field. Because group names can change, we recommend using \`groupId\`.\n\nA list of appropriate values must be provided if the field is of the \`list\` [collection type](https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field/#collection-types).") }).strict().describe("A list of issue IDs and the value to update a custom field to.")).describe("The list of custom field update details.").optional()
}

{
  "key": z.string().describe("The key of the application property.").optional(),
  "permissionLevel": z.string().describe("The permission level of all items being returned in the list.").optional(),
  "keyFilter": z.string().describe("When a \`key\` isn't provided, this filters the list of results by the application property \`key\` using a regular expression. For example, using \`jira.lf.*\` will return all application properties with keys that start with *jira.lf.*.").optional()
}

{}

{
  "id": z.string().describe("The key of the application property to update."),
  "b_id": z.string().describe("The ID of the application property.").optional(),
  "value": z.string().describe("The new value.").optional()
}

{}

{
  "key": z.string().describe("The key of the application role. Use the [Get all application roles](#api-rest-api-3-applicationrole-get) operation to get the key for each application role.")
}

{
  "id": z.string().describe("The ID of the attachment."),
  "redirect": z.boolean().describe("Whether a redirect is provided for the attachment download. Clients that do not automatically follow redirects can set this to \`false\` to avoid making multiple requests to download the attachment.").optional()
}

{}

{
  "id": z.string().describe("The ID of the attachment."),
  "redirect": z.boolean().describe("Whether a redirect is provided for the attachment download. Clients that do not automatically follow redirects can set this to \`false\` to avoid making multiple requests to download the attachment.").optional(),
  "fallbackToDefault": z.boolean().describe("Whether a default thumbnail is returned when the requested thumbnail is not found.").optional(),
  "width": z.number().int().describe("The maximum width to scale the thumbnail to.").optional(),
  "height": z.number().int().describe("The maximum height to scale the thumbnail to.").optional()
}

{
  "id": z.string().describe("The ID of the attachment.")
}

{
  "id": z.string().describe("The ID of the attachment.")
}

{
  "id": z.string().describe("The ID of the attachment.")
}

{
  "id": z.string().describe("The ID of the attachment.")
}

{
  "offset": z.number().int().describe("The number of records to skip before returning the first result.").optional(),
  "limit": z.number().int().describe("The maximum number of results to return.").optional(),
  "filter": z.string().describe("The strings to match with audit field content, space separated.").optional(),
  "from": z.string().describe("The date and time on or after which returned audit records must have been created. If \`to\` is provided \`from\` must be before \`to\` or no audit records are returned.").optional(),
  "to": z.string().describe("The date and time on or before which returned audit results must have been created. If \`from\` is provided \`to\` must be after \`from\` or no audit records are returned.").optional()
}

{
  "type": z.enum(["issuetype","project","user","priority"]).describe("The avatar type.")
}

{
  "selectedIssueIdsOrKeys": z.array(z.string()).describe("List of issue IDs or keys which are to be bulk deleted. These IDs or keys can be from different projects and issue types."),
  "sendBulkNotification": z.boolean().nullable().describe("A boolean value that indicates whether to send a bulk change notification when the issues are being deleted.\n\nIf \`true\`, dispatches a bulk notification email to users about the updates.").optional()
}

{
  "issueIdsOrKeys": z.string().describe("The IDs or keys of the issues to get editable fields from."),
  "searchText": z.string().describe("(Optional)The text to search for in the editable fields.").optional(),
  "endingBefore": z.string().describe("(Optional)The end cursor for use in pagination.").optional(),
  "startingAfter": z.string().describe("(Optional)The start cursor for use in pagination.").optional()
}

{
  "editedFieldsInput": z.string(),
  "selectedActions": z.array(z.string()).describe("List of all the field IDs that are to be bulk edited. Each field ID in this list corresponds to a specific attribute of an issue that is set to be modified in the bulk edit operation. The relevant field ID can be obtained by calling the Bulk Edit Get Fields REST API (documentation available on this page itself)."),
  "selectedIssueIdsOrKeys": z.array(z.string()).describe("List of issue IDs or keys which are to be bulk edited. These IDs or keys can be from different projects and issue types."),
  "sendBulkNotification": z.boolean().nullable().describe("A boolean value that indicates whether to send a bulk change notification when the issues are being edited.\n\nIf \`true\`, dispatches a bulk notification email to users about the updates.").optional()
}

{
  "sendBulkNotification": z.boolean().nullable().describe("A boolean value that indicates whether to send a bulk change notification when the issues are being moved.\n\nIf \`true\`, dispatches a bulk notification email to users about the updates.").optional(),
  "targetToSourcesMapping": z.record(z.any()).describe("[EXPANDABLE PARAMETER]:\nAn object representing the mapping of issues and data related to destination entities, like fields and statuses, that are required during a bulk move.\n\nThe key is a string that is created by concatenating the following three entities in order, separated by commas. The format is \`<project ID or key>,<issueType ID>,<parent ID or key>\`. It should be unique across mappings provided in the payload. If you provide multiple mappings for the same key, only one will be processed. However, the operation won't fail, so the error may be hard to track down.\n\n *  ***Destination project*** (Required): ID or key of the project to which the issues are being moved.\n *  ***Destination issueType*** (Required): ID of the issueType to which the issues are being moved.\n *  ***Destination parent ID or key*** (Optional): ID or key of the issue which will become the parent of the issues being moved. Only required when the destination issueType is a subtask.").optional()
}

{
  "issueIdsOrKeys": z.string().describe("Comma (,) separated Ids or keys of the issues to get transitions available for them."),
  "endingBefore": z.string().describe("(Optional)The end cursor for use in pagination.").optional(),
  "startingAfter": z.string().describe("(Optional)The start cursor for use in pagination.").optional()
}

{
  "bulkTransitionInputs": z.array(z.object({ "selectedIssueIdsOrKeys": z.array(z.string()).describe("List of all the issue IDs or keys that are to be bulk transitioned."), "transitionId": z.string().describe("The ID of the transition that is to be performed on the issues.") }).strict()).describe("List of objects and each object has two properties:\n\n *  Issues that will be bulk transitioned.\n *  TransitionId that corresponds to a specific transition of issues that share the same workflow."),
  "sendBulkNotification": z.boolean().nullable().describe("A boolean value that indicates whether to send a bulk change notification when the issues are being transitioned.\n\nIf \`true\`, dispatches a bulk notification email to users about the updates.").optional()
}

{
  "selectedIssueIdsOrKeys": z.array(z.string()).describe("List of issue IDs or keys which are to be bulk watched or unwatched. These IDs or keys can be from different projects and issue types.")
}

{
  "selectedIssueIdsOrKeys": z.array(z.string()).describe("List of issue IDs or keys which are to be bulk watched or unwatched. These IDs or keys can be from different projects and issue types.")
}

{
  "taskId": z.string().describe("The ID of the task.")
}

{
  "fieldIds": z.array(z.string().describe("List of field IDs to filter changelogs")).min(0).max(10).describe("List of field IDs to filter changelogs").optional(),
  "issueIdsOrKeys": z.array(z.string().describe("List of issue IDs/keys to fetch changelogs for")).min(1).max(1000).describe("List of issue IDs/keys to fetch changelogs for"),
  "maxResults": z.number().int().gte(1).lte(10000).describe("The maximum number of items to return per page").optional(),
  "nextPageToken": z.string().describe("The cursor for pagination").optional()
}

{
  "status": z.array(z.enum(["PUBLISHED","ARCHIVED","DRAFT"]).describe("The status of the project classification.")).describe("Optional set of statuses to filter by.").optional(),
  "orderBy": z.enum(["rank","-rank","+rank"]).describe("Ordering of the results by a given field. If not provided, values will not be sorted.").optional()
}

{
  "expand": z.string().describe("Use [expand](#expansion) to include additional information about comments in the response. This parameter accepts a comma-separated list. Expand options include:\n\n *  \`renderedBody\` Returns the comment body rendered in HTML.\n *  \`properties\` Returns the comment's properties.").optional(),
  "ids": z.array(z.number().int()).describe("The list of comment IDs. A maximum of 1000 IDs can be specified.")
}

{
  "commentId": z.string().describe("The ID of the comment.")
}

{
  "commentId": z.string().describe("The ID of the comment."),
  "propertyKey": z.string().describe("The key of the property.")
}

{
  "commentId": z.string().describe("The ID of the comment."),
  "propertyKey": z.string().describe("The key of the property.")
}

{
  "commentId": z.string().describe("The ID of the comment."),
  "propertyKey": z.string().describe("The key of the property. The maximum length is 255 characters.")
}

{
  "projectIdsOrKeys": z.array(z.string()).describe("The project IDs and/or project keys (case sensitive).").optional(),
  "startAt": z.number().int().describe("The index of the first item to return in a page of results (page offset).").optional(),
  "maxResults": z.number().int().describe("The maximum number of items to return per page.").optional(),
  "orderBy": z.enum(["description","-description","+description","name","-name","+name"]).describe("[Order](#ordering) the results by a field:\n\n *  \`description\` Sorts by the component description.\n *  \`name\` Sorts by component name.").optional(),
  "query": z.string().describe("Filter the results using a literal string. Components with a matching \`name\` or \`description\` are returned (case insensitive).").optional()
}

{
  "ari": z.string().describe("Compass component's ID. Can't be updated. Not required for creating a Project Component.").readonly().optional(),
  "assignee": z.string().optional(),
  "assigneeType": z.enum(["PROJECT_DEFAULT","COMPONENT_LEAD","PROJECT_LEAD","UNASSIGNED"]).describe("The nominal user type used to determine the assignee for issues created with this component. See \`realAssigneeType\` for details on how the type of the user, and hence the user, assigned to issues is determined. Can take the following values:\n\n *  \`PROJECT_LEAD\` the assignee to any issues created with this component is nominally the lead for the project the component is in.\n *  \`COMPONENT_LEAD\` the assignee to any issues created with this component is nominally the lead for the component.\n *  \`UNASSIGNED\` an assignee is not set for issues created with this component.\n *  \`PROJECT_DEFAULT\` the assignee to any issues created with this component is nominally the default assignee for the project that the component is in.\n\nDefault value: \`PROJECT_DEFAULT\`.  \nOptional when creating or updating a component.").optional(),
  "description": z.string().describe("The description for the component. Optional when creating or updating a component.").optional(),
  "id": z.string().describe("The unique identifier for the component.").readonly().optional(),
  "isAssigneeTypeValid": z.boolean().describe("Whether a user is associated with \`assigneeType\`. For example, if the \`assigneeType\` is set to \`COMPONENT_LEAD\` but the component lead is not set, then \`false\` is returned.").readonly().optional(),
  "lead": z.string().optional(),
  "leadAccountId": z.string().max(128).describe("The accountId of the component's lead user. The accountId uniquely identifies the user across all Atlassian products. For example, *5b10ac8d82e05b22cc7d4ef5*.").optional(),
  "leadUserName": z.string().describe("This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details.").optional(),
  "metadata": z.record(z.any()).describe("[EXPANDABLE PARAMETER]:\nCompass component's metadata. Can't be updated. Not required for creating a Project Component.").optional(),
  "name": z.string().describe("The unique name for the component in the project. Required when creating a component. Optional when updating a component. The maximum length is 255 characters.").optional(),
  "project": z.string().describe("The key of the project the component is assigned to. Required when creating a component. Can't be updated.").optional(),
  "projectId": z.number().int().describe("The ID of the project the component is assigned to.").readonly().optional(),
  "realAssignee": z.string().optional(),
  "realAssigneeType": z.enum(["PROJECT_DEFAULT","COMPONENT_LEAD","PROJECT_LEAD","UNASSIGNED"]).describe("The type of the assignee that is assigned to issues created with this component, when an assignee cannot be set from the \`assigneeType\`. For example, \`assigneeType\` is set to \`COMPONENT_LEAD\` but no component lead is set. This property is set to one of the following values:\n\n *  \`PROJECT_LEAD\` when \`assigneeType\` is \`PROJECT_LEAD\` and the project lead has permission to be assigned issues in the project that the component is in.\n *  \`COMPONENT_LEAD\` when \`assignee\`Type is \`COMPONENT_LEAD\` and the component lead has permission to be assigned issues in the project that the component is in.\n *  \`UNASSIGNED\` when \`assigneeType\` is \`UNASSIGNED\` and Jira is configured to allow unassigned issues.\n *  \`PROJECT_DEFAULT\` when none of the preceding cases are true.").readonly().optional(),
  "self": z.string().url().describe("The URL of the component.").readonly().optional()
}

{
  "id": z.string().describe("The ID of the component."),
  "moveIssuesTo": z.string().describe("The ID of the component to replace the deleted component. If this value is null no replacement is made.").optional()
}

{
  "id": z.string().describe("The ID of the component.")
}

{
  "id": z.string().describe("The ID of the component."),
  "ari": z.string().describe("Compass component's ID. Can't be updated. Not required for creating a Project Component.").readonly().optional(),
  "assignee": z.string().optional(),
  "assigneeType": z.enum(["PROJECT_DEFAULT","COMPONENT_LEAD","PROJECT_LEAD","UNASSIGNED"]).describe("The nominal user type used to determine the assignee for issues created with this component. See \`realAssigneeType\` for details on how the type of the user, and hence the user, assigned to issues is determined. Can take the following values:\n\n *  \`PROJECT_LEAD\` the assignee to any issues created with this component is nominally the lead for the project the component is in.\n *  \`COMPONENT_LEAD\` the assignee to any issues created with this component is nominally the lead for the component.\n *  \`UNASSIGNED\` an assignee is not set for issues created with this component.\n *  \`PROJECT_DEFAULT\` the assignee to any issues created with this component is nominally the default assignee for the project that the component is in.\n\nDefault value: \`PROJECT_DEFAULT\`.  \nOptional when creating or updating a component.").optional(),
  "description": z.string().describe("The description for the component. Optional when creating or updating a component.").optional(),
  "b_id": z.string().describe("The unique identifier for the component.").readonly().optional(),
  "isAssigneeTypeValid": z.boolean().describe("Whether a user is associated with \`assigneeType\`. For example, if the \`assigneeType\` is set to \`COMPONENT_LEAD\` but the component lead is not set, then \`false\` is returned.").readonly().optional(),
  "lead": z.string().optional(),
  "leadAccountId": z.string().max(128).describe("The accountId of the component's lead user. The accountId uniquely identifies the user across all Atlassian products. For example, *5b10ac8d82e05b22cc7d4ef5*.").optional(),
  "leadUserName": z.string().describe("This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details.").optional(),
  "metadata": z.record(z.any()).describe("[EXPANDABLE PARAMETER]:\nCompass component's metadata. Can't be updated. Not required for creating a Project Component.").optional(),
  "name": z.string().describe("The unique name for the component in the project. Required when creating a component. Optional when updating a component. The maximum length is 255 characters.").optional(),
  "project": z.string().describe("The key of the project the component is assigned to. Required when creating a component. Can't be updated.").optional(),
  "projectId": z.number().int().describe("The ID of the project the component is assigned to.").readonly().optional(),
  "realAssignee": z.string().optional(),
  "realAssigneeType": z.enum(["PROJECT_DEFAULT","COMPONENT_LEAD","PROJECT_LEAD","UNASSIGNED"]).describe("The type of the assignee that is assigned to issues created with this component, when an assignee cannot be set from the \`assigneeType\`. For example, \`assigneeType\` is set to \`COMPONENT_LEAD\` but no component lead is set. This property is set to one of the following values:\n\n *  \`PROJECT_LEAD\` when \`assigneeType\` is \`PROJECT_LEAD\` and the project lead has permission to be assigned issues in the project that the component is in.\n *  \`COMPONENT_LEAD\` when \`assignee\`Type is \`COMPONENT_LEAD\` and the component lead has permission to be assigned issues in the project that the component is in.\n *  \`UNASSIGNED\` when \`assigneeType\` is \`UNASSIGNED\` and Jira is configured to allow unassigned issues.\n *  \`PROJECT_DEFAULT\` when none of the preceding cases are true.").readonly().optional(),
  "self": z.string().url().describe("The URL of the component.").readonly().optional()
}

{
  "id": z.string().describe("The ID of the component.")
}

{}

{}

{
  "key": z.string().describe("The key for the time tracking provider. For example, *JIRA*."),
  "name": z.string().describe("The name of the time tracking provider. For example, *JIRA provided time tracking*.").optional(),
  "url": z.string().describe("The URL of the configuration page for the time tracking provider app. For example, */example/config/url*. This property is only returned if the \`adminPageKey\` property is set in the module descriptor of the time tracking provider app.").readonly().optional()
}

{}

{}

{
  "defaultUnit": z.enum(["minute","hour","day","week"]).describe("The default unit of time applied to logged time."),
  "timeFormat": z.enum(["pretty","days","hours"]).describe("The format that will appear on an issue's *Time Spent* field."),
  "workingDaysPerWeek": z.number().describe("The number of days in a working week."),
  "workingHoursPerDay": z.number().describe("The number of hours in a working day.")
}

{
  "id": z.string().describe("The ID of the custom field option.")
}

{
  "filter": z.enum(["my","favourite"]).describe("The filter applied to the list of dashboards. Valid values are:\n\n *  \`favourite\` Returns dashboards the user has marked as favorite.\n *  \`my\` Returns dashboards owned by the user.").optional(),
  "startAt": z.number().int().describe("The index of the first item to return in a page of results (page offset).").optional(),
  "maxResults": z.number().int().describe("The maximum number of items to return per page.").optional()
}

{
  "extendAdminPermissions": z.boolean().describe("Whether admin level permissions are used. It should only be true if the user has *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg)").optional(),
  "description": z.string().describe("The description of the dashboard.").optional(),
  "editPermissions": z.array(z.object({ "group": z.string().optional(), "id": z.number().int().describe("The unique identifier of the share permission.").readonly().optional(), "project": z.string().optional(), "role": z.string().optional(), "type": z.enum(["user","group","project","projectRole","global","loggedin","authenticated","project-unknown"]).describe("The type of share permission:\n\n *  \`user\` Shared with a user.\n *  \`group\` Shared with a group. If set in a request, then specify \`sharePermission.group\` as well.\n *  \`project\` Shared with a project. If set in a request, then specify \`sharePermission.project\` as well.\n *  \`projectRole\` Share with a project role in a project. This value is not returned in responses. It is used in requests, where it needs to be specify with \`projectId\` and \`projectRoleId\`.\n *  \`global\` Shared globally. If set in a request, no other \`sharePermission\` properties need to be specified.\n *  \`loggedin\` Shared with all logged-in users. Note: This value is set in a request by specifying \`authenticated\` as the \`type\`.\n *  \`project-unknown\` Shared with a project that the user does not have access to. Cannot be set in a request."), "user": z.string().optional() }).strict().describe("Details of a share permission for the filter.")).describe("The edit permissions for the dashboard."),
  "name": z.string().describe("The name of the dashboard."),
  "sharePermissions": z.array(z.object({ "group": z.string().optional(), "id": z.number().int().describe("The unique identifier of the share permission.").readonly().optional(), "project": z.string().optional(), "role": z.string().optional(), "type": z.enum(["user","group","project","projectRole","global","loggedin","authenticated","project-unknown"]).describe("The type of share permission:\n\n *  \`user\` Shared with a user.\n *  \`group\` Shared with a group. If set in a request, then specify \`sharePermission.group\` as well.\n *  \`project\` Shared with a project. If set in a request, then specify \`sharePermission.project\` as well.\n *  \`projectRole\` Share with a project role in a project. This value is not returned in responses. It is used in requests, where it needs to be specify with \`projectId\` and \`projectRoleId\`.\n *  \`global\` Shared globally. If set in a request, no other \`sharePermission\` properties need to be specified.\n *  \`loggedin\` Shared with all logged-in users. Note: This value is set in a request by specifying \`authenticated\` as the \`type\`.\n *  \`project-unknown\` Shared with a project that the user does not have access to. Cannot be set in a request."), "user": z.string().optional() }).strict().describe("Details of a share permission for the filter.")).describe("The share permissions for the dashboard.")
}

{
  "action": z.enum(["changeOwner","changePermission","addPermission","removePermission"]).describe("Allowed action for bulk edit shareable entity"),
  "changeOwnerDetails": z.string().optional(),
  "entityIds": z.array(z.number().int()).describe("The id list of shareable entities to be changed."),
  "extendAdminPermissions": z.boolean().describe("Whether the actions are executed by users with Administer Jira global permission.").optional(),
  "permissionDetails": z.string().optional()
}

{}

{
  "dashboardName": z.string().describe("String used to perform a case-insensitive partial match with \`name\`.").optional(),
  "accountId": z.string().max(128).describe("User account ID used to return dashboards with the matching \`owner.accountId\`. This parameter cannot be used with the \`owner\` parameter.").optional(),
  "owner": z.string().describe("This parameter is deprecated because of privacy changes. Use \`accountId\` instead. See the [migration guide](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details. User name used to return dashboards with the matching \`owner.name\`. This parameter cannot be used with the \`accountId\` parameter.").optional(),
  "groupname": z.string().describe("As a group's name can change, use of \`groupId\` is recommended. Group name used to return dashboards that are shared with a group that matches \`sharePermissions.group.name\`. This parameter cannot be used with the \`groupId\` parameter.").optional(),
  "groupId": z.string().describe("Group ID used to return dashboards that are shared with a group that matches \`sharePermissions.group.groupId\`. This parameter cannot be used with the \`groupname\` parameter.").optional(),
  "projectId": z.number().int().describe("Project ID used to returns dashboards that are shared with a project that matches \`sharePermissions.project.id\`.").optional(),
  "orderBy": z.enum(["description","-description","+description","favorite_count","-favorite_count","+favorite_count","id","-id","+id","is_favorite","-is_favorite","+is_favorite","name","-name","+name","owner","-owner","+owner"]).describe("[Order](#ordering) the results by a field:\n\n *  \`description\` Sorts by dashboard description. Note that this sort works independently of whether the expand to display the description field is in use.\n *  \`favourite_count\` Sorts by dashboard popularity.\n *  \`id\` Sorts by dashboard ID.\n *  \`is_favourite\` Sorts by whether the dashboard is marked as a favorite.\n *  \`name\` Sorts by dashboard name.\n *  \`owner\` Sorts by dashboard owner name.").optional(),
  "startAt": z.number().int().describe("The index of the first item to return in a page of results (page offset).").optional(),
  "maxResults": z.number().int().describe("The maximum number of items to return per page.").optional(),
  "status": z.enum(["active","archived","deleted"]).describe("The status to filter by. It may be active, archived or deleted.").optional(),
  "expand": z.string().describe("Use [expand](#expansion) to include additional information about dashboard in the response. This parameter accepts a comma-separated list. Expand options include:\n\n *  \`description\` Returns the description of the dashboard.\n *  \`owner\` Returns the owner of the dashboard.\n *  \`viewUrl\` Returns the URL that is used to view the dashboard.\n *  \`favourite\` Returns \`isFavourite\`, an indicator of whether the user has set the dashboard as a favorite.\n *  \`favouritedCount\` Returns \`popularity\`, a count of how many users have set this dashboard as a favorite.\n *  \`sharePermissions\` Returns details of the share permissions defined for the dashboard.\n *  \`editPermissions\` Returns details of the edit permissions defined for the dashboard.\n *  \`isWritable\` Returns whether the current user has permission to edit the dashboard.").optional()
}

{
  "dashboardId": z.number().int().describe("The ID of the dashboard."),
  "moduleKey": z.array(z.string()).describe("The list of gadgets module keys. To include multiple module keys, separate module keys with ampersand: \`moduleKey=key:one&moduleKey=key:two\`.").optional(),
  "uri": z.array(z.string()).describe("The list of gadgets URIs. To include multiple URIs, separate URIs with ampersand: \`uri=/rest/example/uri/1&uri=/rest/example/uri/2\`.").optional(),
  "gadgetId": z.array(z.number().int()).describe("The list of gadgets IDs. To include multiple IDs, separate IDs with ampersand: \`gadgetId=10000&gadgetId=10001\`.").optional()
}

{
  "dashboardId": z.number().int().describe("The ID of the dashboard."),
  "color": z.string().describe("The color of the gadget. Should be one of \`blue\`, \`red\`, \`yellow\`, \`green\`, \`cyan\`, \`purple\`, \`gray\`, or \`white\`.").optional(),
  "ignoreUriAndModuleKeyValidation": z.boolean().describe("Whether to ignore the validation of module key and URI. For example, when a gadget is created that is a part of an application that isn't installed.").optional(),
  "moduleKey": z.string().describe("The module key of the gadget type. Can't be provided with \`uri\`.").optional(),
  "position": z.string().optional(),
  "title": z.string().describe("The title of the gadget.").optional(),
  "uri": z.string().describe("The URI of the gadget type. Can't be provided with \`moduleKey\`.").optional()
}

{
  "dashboardId": z.number().int().describe("The ID of the dashboard."),
  "gadgetId": z.number().int().describe("The ID of the gadget.")
}

{
  "dashboardId": z.number().int().describe("The ID of the dashboard."),
  "gadgetId": z.number().int().describe("The ID of the gadget."),
  "color": z.string().describe("The color of the gadget. Should be one of \`blue\`, \`red\`, \`yellow\`, \`green\`, \`cyan\`, \`purple\`, \`gray\`, or \`white\`.").optional(),
  "position": z.string().optional(),
  "title": z.string().describe("The title of the gadget.").optional()
}

{
  "dashboardId": z.string().describe("The ID of the dashboard."),
  "itemId": z.string().describe("The ID of the dashboard item.")
}

{
  "dashboardId": z.string().describe("The ID of the dashboard."),
  "itemId": z.string().describe("The ID of the dashboard item."),
  "propertyKey": z.string().describe("The key of the dashboard item property.")
}

{
  "dashboardId": z.string().describe("The ID of the dashboard."),
  "itemId": z.string().describe("The ID of the dashboard item."),
  "propertyKey": z.string().describe("The key of the dashboard item property.")
}

{
  "dashboardId": z.string().describe("The ID of the dashboard."),
  "itemId": z.string().describe("The ID of the dashboard item."),
  "propertyKey": z.string().describe("The key of the dashboard item property. The maximum length is 255 characters. For dashboard items with a spec URI and no complete module key, if the provided propertyKey is equal to \"config\", the request body's JSON must be an object with all keys and values as strings.")
}

{
  "id": z.string().describe("The ID of the dashboard.")
}

{
  "id": z.string().describe("The ID of the dashboard.")
}

{
  "id": z.string().describe("The ID of the dashboard to update."),
  "extendAdminPermissions": z.boolean().describe("Whether admin level permissions are used. It should only be true if the user has *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg)").optional(),
  "description": z.string().describe("The description of the dashboard.").optional(),
  "editPermissions": z.array(z.object({ "group": z.string().optional(), "id": z.number().int().describe("The unique identifier of the share permission.").readonly().optional(), "project": z.string().optional(), "role": z.string().optional(), "type": z.enum(["user","group","project","projectRole","global","loggedin","authenticated","project-unknown"]).describe("The type of share permission:\n\n *  \`user\` Shared with a user.\n *  \`group\` Shared with a group. If set in a request, then specify \`sharePermission.group\` as well.\n *  \`project\` Shared with a project. If set in a request, then specify \`sharePermission.project\` as well.\n *  \`projectRole\` Share with a project role in a project. This value is not returned in responses. It is used in requests, where it needs to be specify with \`projectId\` and \`projectRoleId\`.\n *  \`global\` Shared globally. If set in a request, no other \`sharePermission\` properties need to be specified.\n *  \`loggedin\` Shared with all logged-in users. Note: This value is set in a request by specifying \`authenticated\` as the \`type\`.\n *  \`project-unknown\` Shared with a project that the user does not have access to. Cannot be set in a request."), "user": z.string().optional() }).strict().describe("Details of a share permission for the filter.")).describe("The edit permissions for the dashboard."),
  "name": z.string().describe("The name of the dashboard."),
  "sharePermissions": z.array(z.object({ "group": z.string().optional(), "id": z.number().int().describe("The unique identifier of the share permission.").readonly().optional(), "project": z.string().optional(), "role": z.string().optional(), "type": z.enum(["user","group","project","projectRole","global","loggedin","authenticated","project-unknown"]).describe("The type of share permission:\n\n *  \`user\` Shared with a user.\n *  \`group\` Shared with a group. If set in a request, then specify \`sharePermission.group\` as well.\n *  \`project\` Shared with a project. If set in a request, then specify \`sharePermission.project\` as well.\n *  \`projectRole\` Share with a project role in a project. This value is not returned in responses. It is used in requests, where it needs to be specify with \`projectId\` and \`projectRoleId\`.\n *  \`global\` Shared globally. If set in a request, no other \`sharePermission\` properties need to be specified.\n *  \`loggedin\` Shared with all logged-in users. Note: This value is set in a request by specifying \`authenticated\` as the \`type\`.\n *  \`project-unknown\` Shared with a project that the user does not have access to. Cannot be set in a request."), "user": z.string().optional() }).strict().describe("Details of a share permission for the filter.")).describe("The share permissions for the dashboard.")
}

{
  "id": z.string(),
  "extendAdminPermissions": z.boolean().describe("Whether admin level permissions are used. It should only be true if the user has *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg)").optional(),
  "description": z.string().describe("The description of the dashboard.").optional(),
  "editPermissions": z.array(z.object({ "group": z.string().optional(), "id": z.number().int().describe("The unique identifier of the share permission.").readonly().optional(), "project": z.string().optional(), "role": z.string().optional(), "type": z.enum(["user","group","project","projectRole","global","loggedin","authenticated","project-unknown"]).describe("The type of share permission:\n\n *  \`user\` Shared with a user.\n *  \`group\` Shared with a group. If set in a request, then specify \`sharePermission.group\` as well.\n *  \`project\` Shared with a project. If set in a request, then specify \`sharePermission.project\` as well.\n *  \`projectRole\` Share with a project role in a project. This value is not returned in responses. It is used in requests, where it needs to be specify with \`projectId\` and \`projectRoleId\`.\n *  \`global\` Shared globally. If set in a request, no other \`sharePermission\` properties need to be specified.\n *  \`loggedin\` Shared with all logged-in users. Note: This value is set in a request by specifying \`authenticated\` as the \`type\`.\n *  \`project-unknown\` Shared with a project that the user does not have access to. Cannot be set in a request."), "user": z.string().optional() }).strict().describe("Details of a share permission for the filter.")).describe("The edit permissions for the dashboard."),
  "name": z.string().describe("The name of the dashboard."),
  "sharePermissions": z.array(z.object({ "group": z.string().optional(), "id": z.number().int().describe("The unique identifier of the share permission.").readonly().optional(), "project": z.string().optional(), "role": z.string().optional(), "type": z.enum(["user","group","project","projectRole","global","loggedin","authenticated","project-unknown"]).describe("The type of share permission:\n\n *  \`user\` Shared with a user.\n *  \`group\` Shared with a group. If set in a request, then specify \`sharePermission.group\` as well.\n *  \`project\` Shared with a project. If set in a request, then specify \`sharePermission.project\` as well.\n *  \`projectRole\` Share with a project role in a project. This value is not returned in responses. It is used in requests, where it needs to be specify with \`projectId\` and \`projectRoleId\`.\n *  \`global\` Shared globally. If set in a request, no other \`sharePermission\` properties need to be specified.\n *  \`loggedin\` Shared with all logged-in users. Note: This value is set in a request by specifying \`authenticated\` as the \`type\`.\n *  \`project-unknown\` Shared with a project that the user does not have access to. Cannot be set in a request."), "user": z.string().optional() }).strict().describe("Details of a share permission for the filter.")).describe("The share permissions for the dashboard.")
}

{}

{
  "ids": z.string().describe("A list of up to 50 project identifiers. This parameter accepts a comma-separated list.").optional()
}

{}

{
  "check": z.enum(["syntax","type","complexity"]).describe("The check to perform:\n\n *  \`syntax\` Each expression's syntax is checked to ensure the expression can be parsed. Also, syntactic limits are validated. For example, the expression's length.\n *  \`type\` EXPERIMENTAL. Each expression is type checked and the final type of the expression inferred. Any type errors that would result in the expression failure at runtime are reported. For example, accessing properties that don't exist or passing the wrong number of arguments to functions. Also performs the syntax check.\n *  \`complexity\` EXPERIMENTAL. Determines the formulae for how many [expensive operations](https://developer.atlassian.com/cloud/jira/platform/jira-expressions/#expensive-operations) each expression may execute.").optional(),
  "contextVariables": z.record(z.any()).describe("[EXPANDABLE PARAMETER]:\nContext variables and their types. The type checker assumes that [common context variables](https://developer.atlassian.com/cloud/jira/platform/jira-expressions/#context-variables), such as \`issue\` or \`project\`, are available in context and sets their type. Use this property to override the default types or provide details of new variables.").optional(),
  "expressions": z.array(z.string().describe("The list of Jira expressions to analyse.")).describe("The list of Jira expressions to analyse.")
}

{
  "expand": z.string().describe("Use [expand](#expansion) to include additional information in the response. This parameter accepts \`meta.complexity\` that returns information about the expression complexity. For example, the number of expensive operations used by the expression and how close the expression is to reaching the [complexity limit](https://developer.atlassian.com/cloud/jira/platform/jira-expressions/#restrictions). Useful when designing and debugging your expressions.").optional(),
  "context": z.string().optional(),
  "expression": z.string().describe("The Jira expression to evaluate.")
}

{
  "expand": z.string().describe("Use [expand](#expansion) to include additional information in the response. This parameter accepts \`meta.complexity\` that returns information about the expression complexity. For example, the number of expensive operations used by the expression and how close the expression is to reaching the [complexity limit](https://developer.atlassian.com/cloud/jira/platform/jira-expressions/#restrictions). Useful when designing and debugging your expressions.").optional(),
  "context": z.string().optional(),
  "expression": z.string().describe("The Jira expression to evaluate.")
}

{}

{
  "description": z.string().describe("The description of the custom field, which is displayed in Jira.").optional(),
  "name": z.string().describe("The name of the custom field, which is displayed in Jira. This is not the unique identifier."),
  "searcherKey": z.enum(["com.atlassian.jira.plugin.system.customfieldtypes:cascadingselectsearcher","com.atlassian.jira.plugin.system.customfieldtypes:daterange","com.atlassian.jira.plugin.system.customfieldtypes:datetimerange","com.atlassian.jira.plugin.system.customfieldtypes:exactnumber","com.atlassian.jira.plugin.system.customfieldtypes:exacttextsearcher","com.atlassian.jira.plugin.system.customfieldtypes:grouppickersearcher","com.atlassian.jira.plugin.system.customfieldtypes:labelsearcher","com.atlassian.jira.plugin.system.customfieldtypes:multiselectsearcher","com.atlassian.jira.plugin.system.customfieldtypes:numberrange","com.atlassian.jira.plugin.system.customfieldtypes:projectsearcher","com.atlassian.jira.plugin.system.customfieldtypes:textsearcher","com.atlassian.jira.plugin.system.customfieldtypes:userpickergroupsearcher","com.atlassian.jira.plugin.system.customfieldtypes:versionsearcher"]).describe("The searcher defines the way the field is searched in Jira. For example, *com.atlassian.jira.plugin.system.customfieldtypes:grouppickersearcher*.  \nThe search UI (basic search and JQL search) will display different operations and values for the field, based on the field searcher. You must specify a searcher that is valid for the field type, as listed below (abbreviated values shown):\n\n *  \`cascadingselect\`: \`cascadingselectsearcher\`\n *  \`datepicker\`: \`daterange\`\n *  \`datetime\`: \`datetimerange\`\n *  \`float\`: \`exactnumber\` or \`numberrange\`\n *  \`grouppicker\`: \`grouppickersearcher\`\n *  \`importid\`: \`exactnumber\` or \`numberrange\`\n *  \`labels\`: \`labelsearcher\`\n *  \`multicheckboxes\`: \`multiselectsearcher\`\n *  \`multigrouppicker\`: \`multiselectsearcher\`\n *  \`multiselect\`: \`multiselectsearcher\`\n *  \`multiuserpicker\`: \`userpickergroupsearcher\`\n *  \`multiversion\`: \`versionsearcher\`\n *  \`project\`: \`projectsearcher\`\n *  \`radiobuttons\`: \`multiselectsearcher\`\n *  \`readonlyfield\`: \`textsearcher\`\n *  \`select\`: \`multiselectsearcher\`\n *  \`textarea\`: \`textsearcher\`\n *  \`textfield\`: \`textsearcher\`\n *  \`url\`: \`exacttextsearcher\`\n *  \`userpicker\`: \`userpickergroupsearcher\`\n *  \`version\`: \`versionsearcher\`\n\nIf no searcher is provided, the field isn't searchable. However, [Forge custom fields](https://developer.atlassian.com/platform/forge/manifest-reference/modules/#jira-custom-field-type--beta-) have a searcher set automatically, so are always searchable.").optional(),
  "type": z.string().describe("The type of the custom field. These built-in custom field types are available:\n\n *  \`cascadingselect\`: Enables values to be selected from two levels of select lists (value: \`com.atlassian.jira.plugin.system.customfieldtypes:cascadingselect\`)\n *  \`datepicker\`: Stores a date using a picker control (value: \`com.atlassian.jira.plugin.system.customfieldtypes:datepicker\`)\n *  \`datetime\`: Stores a date with a time component (value: \`com.atlassian.jira.plugin.system.customfieldtypes:datetime\`)\n *  \`float\`: Stores and validates a numeric (floating point) input (value: \`com.atlassian.jira.plugin.system.customfieldtypes:float\`)\n *  \`grouppicker\`: Stores a user group using a picker control (value: \`com.atlassian.jira.plugin.system.customfieldtypes:grouppicker\`)\n *  \`importid\`: A read-only field that stores the ID the issue had in the system it was imported from (value: \`com.atlassian.jira.plugin.system.customfieldtypes:importid\`)\n *  \`labels\`: Stores labels (value: \`com.atlassian.jira.plugin.system.customfieldtypes:labels\`)\n *  \`multicheckboxes\`: Stores multiple values using checkboxes (value: \`\`)\n *  \`multigrouppicker\`: Stores multiple user groups using a picker control (value: \`\`)\n *  \`multiselect\`: Stores multiple values using a select list (value: \`com.atlassian.jira.plugin.system.customfieldtypes:multicheckboxes\`)\n *  \`multiuserpicker\`: Stores multiple users using a picker control (value: \`com.atlassian.jira.plugin.system.customfieldtypes:multigrouppicker\`)\n *  \`multiversion\`: Stores multiple versions from the versions available in a project using a picker control (value: \`com.atlassian.jira.plugin.system.customfieldtypes:multiversion\`)\n *  \`project\`: Stores a project from a list of projects that the user is permitted to view (value: \`com.atlassian.jira.plugin.system.customfieldtypes:project\`)\n *  \`radiobuttons\`: Stores a value using radio buttons (value: \`com.atlassian.jira.plugin.system.customfieldtypes:radiobuttons\`)\n *  \`readonlyfield\`: Stores a read-only text value, which can only be populated via the API (value: \`com.atlassian.jira.plugin.system.customfieldtypes:readonlyfield\`)\n *  \`select\`: Stores a value from a configurable list of options (value: \`com.atlassian.jira.plugin.system.customfieldtypes:select\`)\n *  \`textarea\`: Stores a long text string using a multiline text area (value: \`com.atlassian.jira.plugin.system.customfieldtypes:textarea\`)\n *  \`textfield\`: Stores a text string using a single-line text box (value: \`com.atlassian.jira.plugin.system.customfieldtypes:textfield\`)\n *  \`url\`: Stores a URL (value: \`com.atlassian.jira.plugin.system.customfieldtypes:url\`)\n *  \`userpicker\`: Stores a user using a picker control (value: \`com.atlassian.jira.plugin.system.customfieldtypes:userpicker\`)\n *  \`version\`: Stores a version using a picker control (value: \`com.atlassian.jira.plugin.system.customfieldtypes:version\`)\n\nTo create a field based on a [Forge custom field type](https://developer.atlassian.com/platform/forge/manifest-reference/modules/#jira-custom-field-type--beta-), use the ID of the Forge custom field type as the value. For example, \`ari:cloud:ecosystem::extension/e62f20a2-4b61-4dbe-bfb9-9a88b5e3ac84/548c5df1-24aa-4f7c-bbbb-3038d947cb05/static/my-cf-type-key\`.")
}

{
  "associationContexts": z.array(z.object({ "identifier": z.record(z.any()).optional(), "type": z.string() }).strict().describe("Field association for example PROJECT\\_ID.")).describe("Contexts to associate/unassociate the fields with."),
  "fields": z.array(z.object({ "identifier": z.record(z.any()).optional(), "type": z.string() }).strict().describe("Identifier for a field for example FIELD\\_ID.")).describe("Fields to associate/unassociate with projects.")
}

{
  "associationContexts": z.array(z.object({ "identifier": z.record(z.any()).optional(), "type": z.string() }).strict().describe("Field association for example PROJECT\\_ID.")).describe("Contexts to associate/unassociate the fields with."),
  "fields": z.array(z.object({ "identifier": z.record(z.any()).optional(), "type": z.string() }).strict().describe("Identifier for a field for example FIELD\\_ID.")).describe("Fields to associate/unassociate with projects.")
}

{
  "startAt": z.number().int().describe("The index of the first item to return in a page of results (page offset).").optional(),
  "maxResults": z.number().int().describe("The maximum number of items to return per page.").optional(),
  "type": z.array(z.enum(["custom","system"])).describe("The type of fields to search.").optional(),
  "id": z.array(z.string()).describe("The IDs of the custom fields to return or, where \`query\` is specified, filter.").optional(),
  "query": z.string().describe("String used to perform a case-insensitive partial match with field names or descriptions.").optional(),
  "orderBy": z.enum(["contextsCount","-contextsCount","+contextsCount","lastUsed","-lastUsed","+lastUsed","name","-name","+name","screensCount","-screensCount","+screensCount","projectsCount","-projectsCount","+projectsCount"]).describe("[Order](#ordering) the results by:\n\n *  \`contextsCount\` sorts by the number of contexts related to a field\n *  \`lastUsed\` sorts by the date when the value of the field last changed\n *  \`name\` sorts by the field name\n *  \`screensCount\` sorts by the number of screens related to a field").optional(),
  "expand": z.string().describe("Use [expand](#expansion) to include additional information in the response. This parameter accepts a comma-separated list. Expand options include:\n\n *  \`key\` returns the key for each field\n *  \`stableId\` returns the stableId for each field\n *  \`lastUsed\` returns the date when the value of the field last changed\n *  \`screensCount\` returns the number of screens related to a field\n *  \`contextsCount\` returns the number of contexts related to a field\n *  \`isLocked\` returns information about whether the field is locked\n *  \`searcherKey\` returns the searcher key for each custom field").optional(),
  "projectIds": z.array(z.number().int()).optional()
}

{
  "startAt": z.number().int().describe("The index of the first item to return in a page of results (page offset).").optional(),
  "maxResults": z.number().int().describe("The maximum number of items to return per page.").optional(),
  "id": z.array(z.string()).optional(),
  "query": z.string().describe("String used to perform a case-insensitive partial match with field names or descriptions.").optional(),
  "expand": z.enum(["name","-name","+name","trashDate","-trashDate","+trashDate","plannedDeletionDate","-plannedDeletionDate","+plannedDeletionDate","projectsCount","-projectsCount","+projectsCount"]).optional(),
  "orderBy": z.string().describe("[Order](#ordering) the results by a field:\n\n *  \`name\` sorts by the field name\n *  \`trashDate\` sorts by the date the field was moved to the trash\n *  \`plannedDeletionDate\` sorts by the planned deletion date").optional()
}

{
  "fieldId": z.string().describe("The ID of the custom field."),
  "description": z.string().describe("The description of the custom field. The maximum length is 40000 characters.").optional(),
  "name": z.string().describe("The name of the custom field. It doesn't have to be unique. The maximum length is 255 characters.").optional(),
  "searcherKey": z.enum(["com.atlassian.jira.plugin.system.customfieldtypes:cascadingselectsearcher","com.atlassian.jira.plugin.system.customfieldtypes:daterange","com.atlassian.jira.plugin.system.customfieldtypes:datetimerange","com.atlassian.jira.plugin.system.customfieldtypes:exactnumber","com.atlassian.jira.plugin.system.customfieldtypes:exacttextsearcher","com.atlassian.jira.plugin.system.customfieldtypes:grouppickersearcher","com.atlassian.jira.plugin.system.customfieldtypes:labelsearcher","com.atlassian.jira.plugin.system.customfieldtypes:multiselectsearcher","com.atlassian.jira.plugin.system.customfieldtypes:numberrange","com.atlassian.jira.plugin.system.customfieldtypes:projectsearcher","com.atlassian.jira.plugin.system.customfieldtypes:textsearcher","com.atlassian.jira.plugin.system.customfieldtypes:userpickergroupsearcher","com.atlassian.jira.plugin.system.customfieldtypes:versionsearcher"]).describe("The searcher that defines the way the field is searched in Jira. It can be set to \`null\`, otherwise you must specify the valid searcher for the field type, as listed below (abbreviated values shown):\n\n *  \`cascadingselect\`: \`cascadingselectsearcher\`\n *  \`datepicker\`: \`daterange\`\n *  \`datetime\`: \`datetimerange\`\n *  \`float\`: \`exactnumber\` or \`numberrange\`\n *  \`grouppicker\`: \`grouppickersearcher\`\n *  \`importid\`: \`exactnumber\` or \`numberrange\`\n *  \`labels\`: \`labelsearcher\`\n *  \`multicheckboxes\`: \`multiselectsearcher\`\n *  \`multigrouppicker\`: \`multiselectsearcher\`\n *  \`multiselect\`: \`multiselectsearcher\`\n *  \`multiuserpicker\`: \`userpickergroupsearcher\`\n *  \`multiversion\`: \`versionsearcher\`\n *  \`project\`: \`projectsearcher\`\n *  \`radiobuttons\`: \`multiselectsearcher\`\n *  \`readonlyfield\`: \`textsearcher\`\n *  \`select\`: \`multiselectsearcher\`\n *  \`textarea\`: \`textsearcher\`\n *  \`textfield\`: \`textsearcher\`\n *  \`url\`: \`exacttextsearcher\`\n *  \`userpicker\`: \`userpickergroupsearcher\`\n *  \`version\`: \`versionsearcher\`").optional()
}