> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # YouTrack **Authentication:** API key. See [Magic Link](/merge-agent-handler/build/authentication/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/administer/application-credentials) to bring your own OAuth app. ## Available Tools #### list_issue_activities List an issue's change history, field changes, comments, links, and work items, with who changed what and when.... #### list_agiles List agile boards, including the projects each covers and its current sprint. Returns board IDs needed by... #### get_agile Get one agile board by ID (e.g. '204-0'). Use list_agiles to find board IDs. #### list_sprints List sprints on an agile board, with start and finish dates. Use list_agiles to find the board ID. To move an issue... #### get_sprint Get one sprint by board ID and sprint ID. Use list_sprints to find sprint IDs. #### create_sprint Create a sprint on an agile board. Requires the board ID (from list_agiles) and a name. Start and finish accept ISO... #### delete_sprint Delete a sprint from an agile board. Issues on the sprint are not deleted, only unassigned from it. Use list_sprints... #### list_articles List knowledge base articles, optionally filtered with a search query such as 'project: DEMO onboarding'. Omits... #### get_article Get one article including its full Markdown content. Accepts an internal ID ('186-0') or readable ID ('DEMO-A-1').... #### create_article Create a knowledge base article in a project. Requires project_id (from list_projects) and summary. Pass... #### update_article Update an article's title or Markdown content. Accepts an internal ID ('186-0') or readable ID ('DEMO-A-1'). Use... #### delete_article Permanently delete an article and all of its sub-articles. Use list_articles to find article IDs. This cannot be undone. #### list_article_comments List comments on a knowledge base article. Accepts an internal ID ('186-0') or readable ID ('DEMO-A-1'). For issue... #### create_article_comment Add a comment to a knowledge base article. Accepts an internal ID ('186-0') or readable ID ('DEMO-A-1'). For issue... #### list_attachments List files attached to an issue, including name, size, MIME type, and a download path relative to the instance URL.... #### delete_attachment Permanently delete a file attached to an issue. Use list_attachments to find attachment IDs. This cannot be undone. #### list_comments List comments on an issue, oldest first. Accepts an internal issue ID ('3-0') or readable ID ('DEMO-1'). Returns... #### create_comment Add a comment to an issue. Accepts an internal issue ID ('3-0') or readable ID ('DEMO-1'). Set silent=true to skip... #### update_comment Edit a comment's text or pin it. Use list_comments to find comment IDs. Only the comment's author, or a user with... #### delete_comment Permanently delete a comment from an issue. Use list_comments to find comment IDs. This cannot be undone. #### discover_project_fields List every custom field available on issues in a project, with the exact '\$type' and allowed values each one needs.... #### list_custom_fields List custom fields defined across the whole instance. Use discover_project_fields instead when building an issue... #### list_issues Search issues using YouTrack query syntax, e.g. 'project: DEMO State: Open assignee: me' or '#Unresolved'. Sort by... #### get_issue Get one issue with its description and custom field values. Accepts an internal ID ('3-0') or a readable ID... #### create_issue Create an issue. Requires project_id (from list_projects) and summary. To set Priority, State, Assignee, or any... #### update_issue Update an issue's summary, description, or custom fields. Accepts an internal ID ('3-0') or readable ID ('DEMO-1').... #### delete_issue Permanently delete an issue and its comments, attachments, and work items. Accepts an internal ID ('3-0') or... #### count_issues Count issues matching a YouTrack query without fetching them, e.g. 'project: DEMO #Unresolved'. Cheaper than... #### apply_command Apply a YouTrack command to one or more issues, e.g. 'State Fixed', 'Priority Critical', 'for jane.doe', 'tag... #### list_issue_links List an issue's links, grouped by link type and direction. Returns the directed link IDs (e.g. '173-1s' outward,... #### list_issue_link_types List the link types configured on the instance, such as Relates, Depend, Duplicate, and Subtask, with their outward... #### link_issues Link one issue to another. link_id is a directed link type ID such as '173-1s' (outward) or '173-1t' (inward), call... #### unlink_issues Remove a link between two issues. link_id is the directed link type ID (e.g. '173-1s'), use list_issue_links to find... #### list_projects List projects on the instance. Returns the internal project IDs (e.g. '0-0') that create_issue, create_article, and... #### get_project Get one project by its internal ID (e.g. '0-0'). Use list_projects to find IDs. #### create_project Create a project. Requires name, short_name (the issue ID prefix, must be unique), and leader_id, use list_users or... #### update_project Update a project's name, short name, description, owner, or archived state. Use list_projects to find the project... #### delete_project Permanently delete a project and every issue and article in it. Use list_projects to find the project ID. This... #### list_project_team List the users on a project's team, the people assignable to its issues. Use list_projects to find the project ID. #### list_saved_queries List saved searches visible to the current user. Each returns a query string that can be passed straight to... #### get_search_suggestions Get valid completions for a partial issue search query, e.g. 'stat' suggests 'State:'. Use this to build a correct... #### get_command_suggestions Get valid completions for a partial YouTrack command against specific issues, e.g. 'stat' suggests the State values... #### list_tags List issue tags visible to the current user. Returns the tag IDs that add_issue_tag and remove_issue_tag require. To... #### create_tag Create an issue tag. Set untag_on_resolve=true to have YouTrack remove it automatically when an issue is resolved.... #### delete_tag Permanently delete a tag and remove it from every issue carrying it. Use list_tags to find tag IDs. This cannot be... #### add_issue_tag Apply an existing tag to an issue. Use list_tags for tag IDs, or create_tag first. Accepts an internal issue ID... #### remove_issue_tag Remove a tag from an issue. The tag itself is not deleted. Use list_tags or read the issue to find the tag ID. #### get_current_user Get the user the permanent token belongs to. Useful for resolving 'me' in queries and for supplying leader_id to... #### list_users List user accounts, optionally filtering server-side with query (matches login, full name, or email). Returns the... #### get_user Get one user by internal ID (e.g. '2-1'). Use list_users to find user IDs, or get_current_user for the authenticated... #### list_groups List user groups on the instance. Group names are used when restricting comment visibility or setting group-typed... #### list_work_items List time-tracking entries across issues, for timesheet and reporting use. Filter server-side by query (e.g.... #### list_issue_work_items List the time logged against one issue. Accepts an internal ID ('3-0') or readable ID ('DEMO-1'). Returns work item... #### create_work_item Log time against an issue. Requires the issue ID and minutes. Pass type_id from list_work_item_types to categorize... #### delete_work_item Permanently delete a time-tracking entry from an issue. Use list_issue_work_items to find work item IDs. This cannot... #### list_work_item_types List the work item types configured on the instance, such as Development or Testing. Call this before...