{ "$schema": "../../profile-schema.json", "profile_name": "youtrack-optimized", "profile_id": "youtrack", "profile_aliases": ["youtrack-optimized"], "openapi_spec_path": "./openapi.json", "description": "Minimal tool set grouped by read/write actions.", "parameter_aliases": { "id": ["issue_id", "project_id", "article_id", "agile_id", "user_id", "tag_id"], "issueCommentId": ["comment_id"], "issueAttachmentId": ["attachment_id"], "issueWorkItemId": ["workitem_id"], "issueLinkId": ["link_id"], "projectCustomFieldId": ["project_custom_field_id", "custom_field_id"], "sprintId": ["sprint_id"], "articleCommentId": ["article_comment_id"], "articleAttachmentId": ["article_attachment_id"], "tagId": ["tag_id"], "$skip": ["skip"], "$top": ["top"] }, "interceptors": { "base_url": { "value_from_env": "YOUTRACK_API_BASE_URL" }, "auth": { "type": "bearer", "value_from_env": "YOUTRACK_TOKEN" } }, "tools": [ { "name": "retrieve_content", "description": "Read-only access to YouTrack entities (issues, projects, users, tags, articles, agiles, sprints, etc.). Actions: 'list_issues', 'list_issues_detailed', 'get_issue', 'list_issue_comments', 'get_issue_comment', 'list_issue_attachments', 'get_issue_attachment', 'download_issue_attachment', 'list_issue_tags', 'list_issue_links', 'get_issue_link', 'list_linked_issues', 'list_projects', 'get_project', 'list_project_custom_fields', 'get_project_custom_field', 'list_workitems', 'list_articles', 'get_article', 'list_article_comments', 'list_article_attachments', 'get_article_attachment', 'download_article_attachment', 'list_tags', 'get_tag', 'list_saved_queries', 'list_agiles', 'get_agile', 'list_sprints', 'list_users', 'get_user', 'list_groups'.", "metadata_params": ["action", "id", "projectCustomFieldId", "issueCommentId", "issueAttachmentId", "agile_id", "sprintId", "articleCommentId", "articleAttachmentId", "tagId", "fields"], "send_response_fields_as_param": true, "operations": { "list_issues": "get_/issues", "list_issues_detailed": "get_/issues", "get_issue": "get_/issues/{id}", "list_issue_comments": "get_/issues/{id}/comments", "get_issue_comment": "get_/issues/{id}/comments/{issueCommentId}", "list_issue_attachments": "get_/issues/{id}/attachments", "get_issue_attachment": "get_/issues/{id}/attachments/{issueAttachmentId}", "download_issue_attachment": { "type": "proxy_download", "metadata_endpoint": "get_/issues/{id}/attachments/{issueAttachmentId}", "url_field": "url", "skip_auth": true }, "list_issue_tags": "get_/issues/{id}/tags", "list_issue_links": "get_/issues/{id}/links", "get_issue_link": "get_/issues/{id}/links/{issueLinkId}", "list_linked_issues": "get_/issues/{id}/links/{issueLinkId}/issues", "list_projects": "get_/admin/projects", "get_project": "get_/admin/projects/{id}", "list_project_custom_fields": "get_/admin/projects/{id}/customFields", "get_project_custom_field": "get_/admin/projects/{id}/customFields/{projectCustomFieldId}", "list_workitems": "get_/workItems", "list_articles": "get_/articles", "get_article": "get_/articles/{id}", "list_article_comments": "get_/articles/{id}/comments", "list_article_attachments": "get_/articles/{id}/attachments", "get_article_attachment": "get_/articles/{id}/attachments/{articleAttachmentId}", "download_article_attachment": { "type": "proxy_download", "metadata_endpoint": "get_/articles/{id}/attachments/{articleAttachmentId}", "url_field": "url", "skip_auth": true }, "list_tags": "get_/tags", "get_tag": "get_/tags/{id}", "list_saved_queries": "get_/savedQueries", "list_agiles": "get_/agiles", "get_agile": "get_/agiles/{id}", "list_sprints": "get_/agiles/{id}/sprints", "list_users": "get_/users", "get_user": "get_/users/{id}", "list_groups": "get_/groups" }, "response_fields": { "list_issues": ["id", "idReadable", "summary", "resolved"], "list_issues_detailed": ["id", "idReadable", "summary", "description", "resolved", "customFields(id,name,value(id,name))", "created", "updated", "reporter(id,login)"], "get_issue": ["id", "idReadable", "summary", "description", "resolved", "customFields(id,name,value(id,name))", "comments(id,text,author(id,login),created,attachments(id,name,url))", "attachments(id,name,mimeType,size,url)"], "list_issue_comments": ["id", "text", "author(login)", "created", "attachments(id,name,url)"], "get_issue_comment": ["id", "text", "author(id,login)", "created", "updated", "attachments(id,name,mimeType,size,url)"], "list_issue_attachments": ["id", "name", "mimeType", "size"], "get_issue_attachment": ["id", "name", "mimeType", "size", "url", "base64Content"], "list_projects": ["id", "shortName", "name", "description"], "get_project": ["id", "shortName", "name", "description", "customFields(id,$type,field(id,name,fieldType(id,$type)),canBeEmpty,emptyFieldText,ordinal,isPublic)"], "list_project_custom_fields": ["id", "$type", "field(id,name,fieldType(id,$type))", "bundle($type,id)", "defaultValues($type,id,name)", "canBeEmpty", "emptyFieldText", "ordinal", "isPublic"], "get_project_custom_field": ["id", "$type", "field(id,name,fieldType(id,$type))", "bundle($type,id)", "defaultValues($type,id,name)", "canBeEmpty", "emptyFieldText", "ordinal", "isPublic"], "list_articles": ["id", "title", "summary", "resolved"], "get_article": ["id", "title", "summary", "content", "attachments(id,name,mimeType,size,url)", "comments(id,text,author(id,login),created,attachments(id,name,url))"], "list_article_comments": ["id", "text", "author(login)", "created", "attachments(id,name,url)"], "list_article_attachments": ["id", "name", "mimeType", "size"], "get_article_attachment": ["id", "name", "mimeType", "size", "url", "base64Content"], "list_issue_tags": ["id", "name", "owner"], "list_issue_links": ["id", "direction", "linkType"], "get_issue_link": ["id", "direction", "linkType"], "list_linked_issues": ["id", "idReadable", "summary"], "list_workitems": ["id", "duration", "date", "author", "text"], "list_saved_queries": ["id", "name", "query", "owner"], "list_tags": ["id", "name", "color"], "get_tag": ["id", "name", "color", "usages"], "list_agiles": ["id", "name", "status"], "get_agile": ["id", "name", "status", "sprints"], "list_sprints": ["id", "name", "goal", "state"], "list_users": ["id", "login", "fullName", "email"], "get_user": ["id", "login", "fullName", "email", "isReporter"], "list_groups": ["id", "name", "allUsersGroup"] }, "parameters": { "action": { "type": "string", "enum": ["list_issues", "list_issues_detailed", "get_issue", "list_issue_comments", "get_issue_comment", "list_issue_attachments", "get_issue_attachment", "download_issue_attachment", "list_issue_tags", "list_issue_links", "get_issue_link", "list_linked_issues", "list_projects", "get_project", "list_project_custom_fields", "get_project_custom_field", "list_workitems", "list_articles", "get_article", "list_article_comments", "list_article_attachments", "get_article_attachment", "download_article_attachment", "list_tags", "get_tag", "list_saved_queries", "list_agiles", "get_agile", "list_sprints", "list_users", "get_user", "list_groups"], "description": "Action to perform", "required": true }, "id": { "type": "string", "description": "Entity ID (issue ID like 'PROJ-123', project shortName, article ID, agile ID, user login, tag ID, etc.)", "required_for": ["get_issue", "list_issue_comments", "get_issue_comment", "list_issue_attachments", "get_issue_attachment", "download_issue_attachment", "list_issue_tags", "list_issue_links", "get_issue_link", "list_linked_issues", "get_project", "list_project_custom_fields", "get_project_custom_field", "get_article", "list_article_comments", "list_article_attachments", "get_article_attachment", "download_article_attachment", "get_tag", "get_agile", "list_sprints", "get_user"] }, "projectCustomFieldId": { "type": "string", "description": "Custom field ID within a project", "required_for": ["get_project_custom_field"] }, "issueCommentId": { "type": "string", "description": "Comment ID within an issue", "required_for": ["get_issue_comment"] }, "issueAttachmentId": { "type": "string", "description": "Attachment ID within an issue", "required_for": ["get_issue_attachment", "download_issue_attachment"] }, "issueLinkId": { "type": "string", "description": "Link ID within an issue", "required_for": ["get_issue_link", "list_linked_issues"] }, "agile_id": { "type": "string", "description": "Agile board ID", "required_for": ["list_sprints"] }, "sprintId": { "type": "string", "description": "Sprint ID", "required_for": [] }, "articleCommentId": { "type": "string", "description": "Comment ID within an article", "required_for": [] }, "articleAttachmentId": { "type": "string", "description": "Attachment ID within an article", "required_for": ["get_article_attachment", "download_article_attachment"] }, "fields": { "type": "string", "description": "YouTrack fields query (e.g., 'id,summary,description,customFields'). Specify exact fields to return for better performance. For project-specific fields (e.g., 'state', 'State', 'assignee', 'Assignees'), use the exact field name as configured in project." }, "query": { "type": "string", "description": "YouTrack search query (e.g., 'project: PROJ state: Open', 'text ~ bug'). For details, see YouTrack documentation on search and command attributes." }, "skip": { "type": "integer", "description": "Number of items to skip (pagination)" }, "top": { "type": "integer", "description": "Maximum items to return (pagination, max 100)" } } }, { "name": "retrieve_history", "description": "Read-only access to activity logs and audit trails. Actions: 'list_activities', 'get_activity', 'list_activities_page', 'list_issue_activities'. Separated from content retrieval for granular permission control.", "metadata_params": ["action", "id"], "operations": { "list_activities": "get_/activities", "get_activity": "get_/activities/{id}", "list_activities_page": "get_/activitiesPage", "list_issue_activities": "get_/issues/{id}/activities" }, "response_fields": { "list_activities": ["id", "timestamp", "author", "category", "target"], "get_activity": ["id", "timestamp", "author", "category", "field", "target", "added", "removed"], "list_activities_page": ["id", "timestamp", "author", "category"], "list_issue_activities": ["id", "timestamp", "author", "category", "field", "added", "removed"] }, "parameters": { "action": { "type": "string", "enum": ["list_activities", "get_activity", "list_activities_page", "list_issue_activities"], "description": "Action to perform", "required": true }, "id": { "type": "string", "description": "Activity or issue ID", "required_for": ["get_activity", "list_issue_activities"] }, "categories": { "type": "string", "description": "Filter by activity categories (comma-separated)" }, "reverse": { "type": "boolean", "description": "Sort newest to oldest (default: false for oldest first)" }, "start": { "type": "string", "description": "Start timestamp in milliseconds (unix timestamp UTC)" }, "end": { "type": "string", "description": "End timestamp in milliseconds (unix timestamp UTC)" }, "author": { "type": "string", "description": "Filter by author (database ID, login, Hub ID, or 'me')" }, "issueQuery": { "type": "string", "description": "Issue search query to filter activities" }, "fields": { "type": "string", "description": "YouTrack fields query" }, "skip": { "type": "integer", "description": "Number of items to skip (pagination)" }, "top": { "type": "integer", "description": "Maximum items to return (pagination)" } } }, { "name": "create_content", "description": "Create new entities in YouTrack. Actions: 'create_issue', 'create_issue_comment', 'create_article_comment', 'log_time', 'add_issue_tag', 'add_article_tag', 'create_tag', 'add_issue_link', 'upload_issue_attachment', 'upload_article_attachment'. Use for creating issues, adding comments, logging time, tagging, and uploading files.", "metadata_params": ["action", "id", "issueCommentId", "issueAttachmentId", "articleCommentId", "articleAttachmentId"], "operations": { "create_issue": "post_/issues", "create_issue_comment": "post_/issues/{id}/comments", "create_article_comment": "post_/articles/{id}/comments", "log_time": "post_/issues/{id}/timeTracking/workItems", "add_issue_tag": "post_/issues/{id}/tags", "add_article_tag": "post_/articles/{id}/tags", "create_tag": "post_/tags", "add_issue_link": "post_/issues/{id}/links/{issueLinkId}/issues", "upload_issue_attachment": "post_/issues/{id}/attachments", "upload_article_attachment": "post_/articles/{id}/attachments" }, "response_fields": { "create_issue": ["id", "idReadable", "summary"], "create_issue_comment": ["id", "text", "author", "created"], "create_article_comment": ["id", "text", "author", "created"], "log_time": ["id", "duration"], "add_issue_tag": ["id", "name"], "add_article_tag": ["id", "name"], "create_tag": ["id", "name", "color"], "add_issue_link": ["id"], "upload_issue_attachment": ["id", "name"], "upload_article_attachment": ["id", "name"] }, "parameters": { "action": { "type": "string", "enum": ["create_issue", "create_issue_comment", "create_article_comment", "log_time", "add_issue_tag", "add_article_tag", "create_tag", "add_issue_link", "upload_issue_attachment", "upload_article_attachment"], "description": "Action to perform", "required": true }, "id": { "type": "string", "description": "Issue or article ID", "required_for": ["create_issue_comment", "create_article_comment", "log_time", "add_issue_tag", "add_article_tag", "add_issue_link", "upload_issue_attachment", "upload_article_attachment"] }, "issueLinkId": { "type": "string", "description": "Link type ID (for add_issue_link)", "required_for": ["add_issue_link"] }, "summary": { "type": "string", "description": "Issue summary/title (for create_issue)", "required_for": ["create_issue"] }, "description": { "type": "string", "description": "Issue description (for create_issue)" }, "project": { "type": "object", "description": "Project reference object with 'id' or 'shortName' (for create_issue). Example: {\"shortName\": \"PROJ\"}", "required_for": ["create_issue"], "properties": {} }, "text": { "type": "string", "description": "Comment text", "required_for": ["create_issue_comment", "create_article_comment"] }, "duration": { "type": "object", "description": "Duration object (minutes or presentation) for work item", "required_for": ["log_time"], "properties": {} }, "date": { "type": "integer", "description": "Work item date as unix timestamp in milliseconds", "required_for": ["log_time"] }, "tag": { "type": "object", "description": "Tag reference object with 'id'. Example: {\"id\": \"tag-123\"}", "required_for": ["add_issue_tag", "add_article_tag"], "properties": {} }, "name": { "type": "string", "description": "Tag name (for create_tag)", "required_for": ["create_tag"] }, "color": { "type": "string", "description": "Tag color in hex format (e.g., '#FF0000')", "required_for": [] }, "issues": { "type": "array", "description": "Array of issue IDs to link (for add_issue_link)", "required_for": ["add_issue_link"], "items": { "type": "string" } }, "fileName": { "type": "string", "description": "Attachment filename (for upload_issue_attachment, upload_article_attachment)", "required_for": ["upload_issue_attachment", "upload_article_attachment"] }, "base64Content": { "type": "string", "description": "Base64-encoded file content (for upload_issue_attachment, upload_article_attachment)", "required_for": ["upload_issue_attachment", "upload_article_attachment"] }, "mimeType": { "type": "string", "description": "MIME type of the file", "required_for": [] }, "customFields": { "type": ["object", "array"], "description": "Custom fields array or object (for create_issue). Example: [{\"name\": \"Priority\", \"value\": {\"name\": \"High\"}}]", "properties": {}, "items": { "type": "object" }, "object_entries_to_array": { "key_field": "name", "value_field": "value", "wrap_value_field": "name" } } } }, { "name": "update_content", "description": "Modify existing entities in YouTrack. Actions: 'update_issue', 'update_issue_comment', 'update_article_comment', 'update_work_item', 'update_issue_attachment', 'update_tag'. Use for editing issues, comments, time tracking entries, and tags.", "metadata_params": ["action", "id", "issueCommentId", "issueAttachmentId", "issueWorkItemId", "articleCommentId"], "operations": { "update_issue": "post_/issues/{id}", "update_issue_comment": "post_/issues/{id}/comments/{issueCommentId}", "update_article_comment": "post_/articles/{id}/comments/{articleCommentId}", "update_work_item": "post_/issues/{id}/timeTracking/workItems/{issueWorkItemId}", "update_issue_attachment": "post_/issues/{id}/attachments/{issueAttachmentId}", "update_tag": "post_/tags/{id}" }, "response_fields": { "update_issue": ["id", "idReadable", "summary", "updated"], "update_issue_comment": ["id", "text", "updated"], "update_article_comment": ["id", "text", "updated"], "update_work_item": ["id", "duration", "updated"], "update_issue_attachment": ["id", "name", "updated"], "update_tag": ["id", "name", "updated"] }, "parameters": { "action": { "type": "string", "enum": ["update_issue", "update_issue_comment", "update_article_comment", "update_work_item", "update_issue_attachment", "update_tag"], "description": "Action to perform", "required": true }, "id": { "type": "string", "description": "Entity ID to update (issue, article, or tag ID)", "required_for": ["update_issue", "update_issue_comment", "update_article_comment", "update_work_item", "update_issue_attachment", "update_tag"] }, "issueCommentId": { "type": "string", "description": "Comment ID to update", "required_for": ["update_issue_comment"] }, "articleCommentId": { "type": "string", "description": "Article comment ID to update", "required_for": ["update_article_comment"] }, "issueAttachmentId": { "type": "string", "description": "Attachment ID to update", "required_for": ["update_issue_attachment"] }, "issueWorkItemId": { "type": "string", "description": "Work item ID to update", "required_for": ["update_work_item"] }, "summary": { "type": "string", "description": "Issue summary (for update_issue)" }, "description": { "type": "string", "description": "Issue description (for update_issue)" }, "text": { "type": "string", "description": "Comment text", "required_for": ["update_issue_comment", "update_article_comment"] }, "duration": { "type": "object", "description": "Duration object for update_work_item", "required_for": ["update_work_item"], "properties": {} }, "date": { "type": "integer", "description": "Work item date as unix timestamp in milliseconds (for update_work_item)" }, "name": { "type": "string", "description": "Tag name or attachment name", "required_for": ["update_tag", "update_issue_attachment"] }, "color": { "type": "string", "description": "Tag color in hex format (for update_tag)" }, "customFields": { "type": ["object", "array"], "description": "Custom fields to update (for update_issue)", "properties": {}, "items": { "type": "object" }, "object_entries_to_array": { "key_field": "name", "value_field": "value", "wrap_value_field": "name" } } } }, { "name": "delete_content", "description": "Remove entities from YouTrack. Actions: 'delete_issue', 'delete_issue_comment', 'delete_article_comment', 'delete_work_item', 'delete_issue_attachment', 'delete_article_attachment', 'remove_issue_tag', 'remove_article_tag', 'delete_tag', 'remove_issue_link'. Use with caution as deletions may be irreversible.", "metadata_params": ["action", "id", "issueCommentId", "issueAttachmentId", "issueWorkItemId", "issueLinkId", "articleCommentId", "articleAttachmentId", "tagId"], "operations": { "delete_issue": "delete_/issues/{id}", "delete_issue_comment": "delete_/issues/{id}/comments/{issueCommentId}", "delete_article_comment": "delete_/articles/{id}/comments/{articleCommentId}", "delete_work_item": "delete_/issues/{id}/timeTracking/workItems/{issueWorkItemId}", "delete_issue_attachment": "delete_/issues/{id}/attachments/{issueAttachmentId}", "delete_article_attachment": "delete_/articles/{id}/attachments/{articleAttachmentId}", "remove_issue_tag": "delete_/issues/{id}/tags/{tagId}", "remove_article_tag": "delete_/articles/{id}/tags/{tagId}", "delete_tag": "delete_/tags/{id}", "remove_issue_link": "delete_/issues/{id}/links/{issueLinkId}/issues/{issueId}" }, "response_fields": {}, "parameters": { "action": { "type": "string", "enum": ["delete_issue", "delete_issue_comment", "delete_article_comment", "delete_work_item", "delete_issue_attachment", "delete_article_attachment", "remove_issue_tag", "remove_article_tag", "delete_tag", "remove_issue_link"], "description": "Action to perform", "required": true }, "id": { "type": "string", "description": "Primary entity ID (issue, article, or tag)", "required_for": ["delete_issue", "delete_issue_comment", "delete_article_comment", "delete_work_item", "delete_issue_attachment", "delete_article_attachment", "remove_issue_tag", "remove_article_tag", "delete_tag", "remove_issue_link"] }, "issueCommentId": { "type": "string", "description": "Comment ID to delete", "required_for": ["delete_issue_comment"] }, "articleCommentId": { "type": "string", "description": "Article comment ID to delete", "required_for": ["delete_article_comment"] }, "issueAttachmentId": { "type": "string", "description": "Attachment ID to delete", "required_for": ["delete_issue_attachment"] }, "articleAttachmentId": { "type": "string", "description": "Article attachment ID to delete", "required_for": ["delete_article_attachment"] }, "issueWorkItemId": { "type": "string", "description": "Work item ID to delete", "required_for": ["delete_work_item"] }, "tagId": { "type": "string", "description": "Tag ID to remove/delete", "required_for": ["remove_issue_tag", "remove_article_tag", "delete_tag"] }, "issueLinkId": { "type": "string", "description": "Link type ID", "required_for": ["remove_issue_link"] }, "issueId": { "type": "string", "description": "Issue ID to unlink (for remove_issue_link)", "required_for": ["remove_issue_link"] } } }, { "name": "run_commands", "description": "Execute YouTrack command language for bulk/batch operations on issues. Actions: 'execute_command', 'assist_command'. Commands allow modifying multiple issues at once using YouTrack's powerful command syntax. Use with caution for bulk updates.", "metadata_params": ["action"], "operations": { "execute_command": "post_/commands", "assist_command": "post_/commands/assist" }, "response_fields": { "execute_command": ["id", "error"], "assist_command": ["commands", "error"] }, "parameters": { "action": { "type": "string", "enum": ["execute_command", "assist_command"], "description": "Action to perform", "required": true }, "query": { "type": "string", "description": "Issue query to select issues (e.g., 'project: PROJ state: Open'). Required for execute_command.", "required_for": ["execute_command"] }, "command": { "type": "string", "description": "YouTrack command to execute (e.g., 'state: Open', 'priority: Critical'). For details on command syntax, see YouTrack documentation.", "required_for": ["execute_command"] }, "issues": { "type": "array", "description": "Issue IDs to apply the command to (for execute_command).", "items": { "type": "string" }, "array_item_to_object": { "key_field": "id" } }, "text": { "type": "string", "description": "Text to analyze for command suggestions (for assist_command)", "required_for": ["assist_command"] }, "fields": { "type": "string", "description": "YouTrack fields query for response" } } } ] }