Predefined MCP Tools

search_issues

Searches for issues using YouTrack’s query language. The query can combine attribute filters, keywords, and free text.

Returns basic information for matching issues, including the issue ID, summary, project, resolved, reporter, created, updated. For full details, use get_issue. The response is paginated using the specified offset and limit.

Find all open bugs assigned to me in the Mobile App project.

get_issue_fields_schema

Returns the JSON schema for custom fields in the specified project. Must be used to provide relevant custom fields and values for create_issue and update_issue actions.

Which fields are required to create issues in the Website Redesign project?

create_issue

Creates a new issue in the specified project. Use get_issue_fields_schema to discover customFields and their possible values for the target project. Important: some fields may be required for issue creation. Returns the ID of the created issue and URL that opens the issue in a web browser. Use get_issue to get the full issue details.

Create a new issue in the Backend API project with the summary "Fix authentication timeout" with a priority of High and assign it to @alex.

create_draft_issue

Creates a new issue draft in the specified project. Draft issues are only visible to the current user and can be edited using update_issue. Returns the ID assigned to the issue draft and a URL that opens the draft in a web browser.

Start a draft issue in the Marketing Site project with the summary "Revise homepage hero section".

update_issue

Updates an existing issue and its fields. Can also be used to star issues and add votes.

Update issue WEB-132 by changing its state to In Progress and adding the label "frontend".

get_issue

Returns detailed information for an issue or issue draft, including the summary, description, URL, project, reporter (username), tags, votes, and custom fields. The customFields output property provides more important issue details, including Type, State, Assignee, Priority, Subsystem, and so on. Use get_issue_fields_schema for the full list of custom fields and their possible values.

Show me all details for issue ID BACK-249.

change_issue_assignee

Sets the value for the Assignee field in an issue to the specified user.

Reassign issue DEV-102 to @julia.

add_issue_comment

Adds a new comment to the specified issue. Supports Markdown.

Add a comment to issue APP-56: "Great progress. Please include the API documentation before closing."

get_issue_comments

Returns a list of issue comments with detailed information for each. The response is paginated using the specified offset and/or limit.

List all comments for issue UX-87.

get_saved_issue_searches

Returns saved searches marked as favorites by the current user. The output search queries can be used in search_issues. The response is paginated using the specified offset and/or limit.

Show me my saved searches.

manage_issue_tags

Adds a tag to or removes a tag from an issue. If a name is used, the first tag that matches the provided name is added. If no matching tags are found, an error message with suggestions for similar tags is returned. When successful, it returns the ID of the updated issue and the updated list of issue tags.

Add the tag "urgent" to issue API-144.

link_issues

Links two issues with the specified link type. Returns updated link counts for all target issue link types.

Link issue DOCS-12 to issue DEV-99 as "relates to".

find_projects

Finds projects whose names contain the specified substring (case-insensitive). Returns minimal information (ID and name) to help pick a project for get_project. The response is paginated using the specified offset and/or limit.

Find all projects with "CRM" in the name.

get_project

Retrieves full details for a specific project.

Get full details for the "Customer Portal" project.

find_user_groups

Finds user groups or project teams whose names contain the specified substring (case-insensitive). The response is paginated using the specified offset and/or limit.

List all groups that include the word "Design".

get_user_group_members

Lists users who are members of a specified group or project team. Project teams are essentially groups that are always associated with a specific project. The response is paginated using the specified offset and/or limit.

Show me the list of members in the QA Engineers group.

find_user

Finds users by username or email. Returns profile data for the matching user. This includes the username, full name, email, and local time zone.

Find the user with email alex.rocha@company.com.

get_current_user

Returns details about the currently authenticated user (me): username, email, full name, time zone.

Show my account details.

log_work

Adds a work item (spent time) to the specified issue. You can specify the duration in minutes, optional date, work type, description, and optional work item attributes. Use get_project to retrieve the workTypes and workItemAttributesSchema for the target project.

Log 90 minutes of work on issue DEV-203 with the description "Refactored payment module".