---
schema: rendered-html/v1
title: "MCP Tools | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/ai-tools.html
generated_at: 2026-06-11T14:38:37.706511+00:00
---

Feedback

Thanks for your feedback!

Was this page helpful?

YesNo

Developer Portal for YouTrack and Hub

- [Developer Portal](jetbrains__com__help__youtrack__devportal__youtrack-dev-portal.md)
- [Apps](jetbrains__com__help__youtrack__devportal__apps-documentation.md)
- [MCP Tools](ai-tools.html)
- Predefined MCP Tools
- Custom MCP Tools
- [YouTrack Workflows](jetbrains__com__help__youtrack__devportal__youtrack-workflow-reference.md)
- [YouTrack Import Scripts](jetbrains__com__help__youtrack__devportal__youtrack-import-scripts.md)
- YouTrack Form API
- YouTrack REST API
- Hub REST API

# MCP Tools﻿

Last modified: 07 May 2026
> ### note
>
> Available since YouTrack version 2025.3

Model Context Protocol (MCP) is a new standard that enables apps like chatbots and other AI tools talk to other services, like YouTrack, in a consistent and safe way. The YouTrack MCP server gives these tools real-time access to read and update issues in YouTrack, using your own account permissions. It includes a set of built-in tools you can use to find, create, and update things like issues and comments.

For the instructions on how to configure the connection between your AI client and YouTrack, see YouTrack documentation.

Our predefined MCP tools let you view, create, and update issues, projects, and users. For more information about predefined MCP tools in YouTrack, see Predefined MCP Tools.

You can also create custom MCP tools and include them in your custom YouTrack app. For instructions on how to create your own MCP tools, see Custom MCP Tools.

## Security﻿

When using the YouTrack MCP server, you're letting your AI agent perform various tasks, such as creating and updating issues on your behalf. The YouTrack team has thoroughly considered possible security concerns when developing our predefined MCP tools. For this reason, predefined MCP tools are read-only.

If you want to modify any of the predefined MCP tools, copy them into a separate app package and update the code. For details on how to write custom MCP tools, see Custom MCP Tools.

## Monitoring Changes Made by AI Tools﻿

For additional security, YouTrack admins may want to monitor changes made by AI tools. They can implement such monitoring using workflow rules. On-change workflow rules can determine whether a change is made by an MCP request and run custom logic for such cases.

You can check whether an LLM performed a change through an MCP request by using `isMcpRequest` method of the context object in a workflow rule that gets triggered on changes.

Here is an example of a simple on-change workflow rule that implements additional monitoring and tags all issues updated by an LLM with a special tag:

```
const entities = require('@jetbrains/youtrack-scripting-api/entities');

exports.rule = entities.Issue.onChange({
    title: 'Mark issues touched by an LLM via MCP with a tag',
    guard: (ctx) => ctx.isMcpRequest, // triggers only on MCP change requests
    action: (ctx) => ctx.issue.addTag('by-ai')
});
```

- [MCP Tools](/help/youtrack/devportal/ai-tools.html)
- [Security](/help/youtrack/devportal/ai-tools.html#security)
- [Monitoring Changes Made by AI Tools](/help/youtrack/devportal/ai-tools.html#monitoring-changes-by-ai-tools)

Custom MCP ToolsPredefined MCP Tools

- Privacy & Security
- Terms Of Use
- Trademarks
- Legal

Copyright © 2000–2026 JetBrains s.r.o.
