### YouTrack MCP Server API Tools Reference

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This section provides a comprehensive reference for the YouTrack MCP server's available tools. It details methods for managing issues, projects, users, and performing various search operations within YouTrack, including parameter formats and usage examples.

```APIDOC
YouTrack MCP Server Tools:

Issues:
  - get_issue(issue_id: str)
    - Description: Get details of a specific issue by ID.
    - Parameters:
      - issue_id (str): The issue ID, which can be the readable ID (e.g., "DEMO-123") or the internal ID (e.g., "3-14").
    - Usage Example: get_issue(issue_id="DEMO-123")

  - search_issues
    - Description: Search for issues using YouTrack query language.

  - create_issue(project: str, summary: str, description: Optional[str] = None)
    - Description: Create a new issue in a specific project.
    - Parameters:
      - project (str): The project's short name (e.g., "DEMO") or its internal ID.
      - summary (str): The issue's summary.
      - description (Optional[str]): An optional detailed description for the issue.
    - Usage Examples:
      create_issue(project="DEMO", summary="Bug: Login page not working")
      create_issue(project="DEMO", summary="Bug: Login page not working", description="Users cannot log in after the latest update")

  - add_comment(issue_id: str, text: str)
    - Description: Add a comment to an existing issue.
    - Parameters:
      - issue_id (str): The ID of the issue.
      - text (str): The comment text.
    - Usage Example: add_comment(issue_id="DEMO-123", text="This is a test comment")

Projects:
  - get_projects
    - Description: Get a list of all projects.

  - get_project
    - Description: Get details of a specific project.

  - get_project_issues
    - Description: Get issues for a specific project.

  - create_project
    - Description: Create a new project.

Users:
  - get_current_user
    - Description: Get information about the currently authenticated user.

  - get_user
    - Description: Get information about a specific user.

  - search_users
    - Description: Search for users.

  - get_user_by_login
    - Description: Find a user by login name.

  - get_user_groups
    - Description: Get groups for a user.

Search:
  - advanced_search
    - Description: Advanced search with sorting options.

  - filter_issues
    - Description: Search with structured filtering.

  - search_with_custom_fields
    - Description: Search using custom field values.
```

--------------------------------

### Configure Cursor IDE for YouTrack MCP Server (Quick Start)

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This JSON snippet configures Cursor IDE to use the YouTrack MCP server via a Docker container. It defines the server type as stdio and provides the Docker run command with YouTrack Cloud instance details.

```json
{
    "mcpServers": {
        "YouTrack": {
            "type": "stdio",
            "command": "docker",
            "args": ["run", "-i", "--rm",
            "-e", "YOUTRACK_URL=https://your-instance.youtrack.cloud",
            "-e", "YOUTRACK_API_TOKEN=perm:your-api-token", 
            "-e", "YOUTRACK_CLOUD=true",
            "tonyzorin/youtrack-mcp:latest"
            ]
        }
    }
}
```

--------------------------------

### Initialize Docker BuildX for Multi-Platform Builds

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This command creates and uses a new Docker BuildX builder instance, which is necessary for building multi-architecture Docker images.

```bash
docker buildx create --use
```

--------------------------------

### Run Docker Container with Debug Logging Enabled

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

Shows how to launch the `tonyzorin/youtrack-mcp` Docker container with debug logging enabled. This helps in troubleshooting issues by providing more verbose output from the server.

```bash
docker run -i --rm \
  -e YOUTRACK_URL=https://your-instance.youtrack.cloud \
  -e YOUTRACK_API_TOKEN=perm:your-permanent-token \
  -e MCP_DEBUG=true \
  tonyzorin/youtrack-mcp:latest
```

--------------------------------

### YouTrack MCP Server Environment Variables Reference

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

Defines the environment variables used to configure the `tonyzorin/youtrack-mcp` server. This includes parameters for YouTrack instance connection, SSL certificate verification, and server identification/logging settings.

```APIDOC
YOUTRACK_URL:
  Description: YouTrack instance URL
  Required: true
YOUTRACK_API_TOKEN:
  Description: YouTrack permanent API token
  Required: true
YOUTRACK_VERIFY_SSL:
  Description: Verify SSL certificates
  Default: true
MCP_SERVER_NAME:
  Description: Name of the MCP server
  Default: youtrack-mcp
MCP_SERVER_DESCRIPTION:
  Description: Description of the MCP server
  Default: YouTrack MCP Server
MCP_DEBUG:
  Description: Enable debug logging
  Default: false
```

--------------------------------

### Build and Push Multi-Platform YouTrack MCP Docker Images

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This command builds Docker images for both AMD64 and ARM64 architectures, tags them with a specific version and 'latest', and pushes them to a Docker registry. This enables broader compatibility.

```bash
docker buildx build --platform linux/amd64,linux/arm64 \
     -t tonyzorin/youtrack-mcp:0.3.7 \
     -t tonyzorin/youtrack-mcp:latest \
     --push .
```

--------------------------------

### Configure Claude Desktop for YouTrack MCP Server

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This Docker command runs the YouTrack MCP server for use with Claude Desktop. It sets the API token and specifies it's a cloud instance.

```bash
docker run -i --rm -e YOUTRACK_API_TOKEN=perm:your-api-token -e YOUTRACK_CLOUD=true tonyzorin/youtrack-mcp:latest
```

--------------------------------

### Run YouTrack MCP Docker Container for Cloud Instances

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This command runs the YouTrack MCP server as a Docker container, configured for YouTrack Cloud instances. It requires setting the YouTrack URL, API token, and specifying that it's a cloud instance.

```bash
docker run -i --rm \
     -e YOUTRACK_URL=https://your-instance.youtrack.cloud \
     -e YOUTRACK_API_TOKEN=perm:your-api-token \
     -e YOUTRACK_CLOUD=true \
     tonyzorin/youtrack-mcp:latest
```

--------------------------------

### Detailed Cursor IDE Configuration for YouTrack MCP Server

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This JSON configuration block for `.cursor/mcp.json` sets up Cursor IDE to connect to the YouTrack MCP server running in a Docker container. It specifies the server type, command, and arguments including YouTrack URL, API token, and cloud instance flag.

```json
{
        "mcpServers": {
            "YouTrack": {
                "type": "stdio",
                "command": "docker",
                "args": ["run", "-i", "--rm", 
                "-e", "YOUTRACK_API_TOKEN=perm:your-api-token",
                "-e", "YOUTRACK_URL=https://your-instance.youtrack.cloud",
                "-e", "YOUTRACK_CLOUD=true",
                "tonyzorin/youtrack-mcp:latest"
                ]
            }
        }
    }
```

--------------------------------

### Configure YouTrack MCP Server for Claude Desktop

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This JSON configuration snippet is used to integrate the YouTrack MCP server with Claude Desktop. It defines a new MCP server named 'YouTrack' of type 'stdio' and specifies the Docker command to run the server, including environment variables for YouTrack API token, URL, and cloud status. Users must replace placeholder values with their actual YouTrack instance details.

```json
{
    "mcpServers": {
        "YouTrack": {
            "type": "stdio",
            "command": "docker",
            "args": ["run", "-i", "--rm", 
            "-e", "YOUTRACK_API_TOKEN=perm:your-api-token",
            "-e", "YOUTRACK_URL=https://your-instance.youtrack.cloud",
            "-e", "YOUTRACK_CLOUD=true",
            "tonyzorin/youtrack-mcp:latest"
            ]
        }
    }
}
```

--------------------------------

### Build YouTrack MCP Docker Image from Source

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This command builds a Docker image named 'youtrack-mcp' from the local source code in the current directory. This is useful for custom modifications or offline builds.

```bash
docker build -t youtrack-mcp .
```

--------------------------------

### Configure YouTrack MCP Server for VS Code

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This JSON configuration snippet is used to integrate the YouTrack MCP server with VS Code. It defines a new MCP server named 'YouTrack' of type 'stdio' within a `.vscode/mcp.json` file. The configuration specifies the Docker command to run the server, including environment variables for YouTrack API token, URL, and cloud status. Users must replace placeholder values with their actual YouTrack instance details.

```json
{
  "servers": {
    "YouTrack": {
      "type": "stdio",
      "command": "docker",
      "args": ["run", "-i", "--rm", 
        "-e", "YOUTRACK_API_TOKEN=perm:your-api-token",
        "-e", "YOUTRACK_URL=https://your-instance.youtrack.cloud",
        "-e", "YOUTRACK_CLOUD=true",
        "tonyzorin/youtrack-mcp:latest"
      ]
    }
  }
}
```

--------------------------------

### Run Locally Built YouTrack MCP Docker Container

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This command runs a Docker container using the image built from local source. It requires YouTrack URL and API token environment variables.

```bash
docker run -i --rm \
     -e YOUTRACK_URL=https://your-instance.youtrack.cloud \
     -e YOUTRACK_API_TOKEN=your-api-token \
     youtrack-mcp
```

--------------------------------

### Python Project Dependency List

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/requirements.txt

This snippet specifies the Python packages necessary for the project's operation and development. It lists production dependencies like 'httpx' and 'pydantic', along with development tools such as 'pytest' and 'black', including version constraints and a direct Git repository reference for 'mcp'.

```Python requirements
httpx>=0.24.0
pydantic>=2.0.0
python-dotenv>=1.0.0
git+https://github.com/modelcontextprotocol/python-sdk.git@main#egg=mcp
nest_asyncio>=1.5.6

# Development dependencies
pytest>=7.0.0
black>=22.1.0
flake8>=4.0.1
mypy>=0.931
isort>=5.10.1
pytest-cov>=3.0.0 
fastapi>=0.115.12
requests>=2.32.3
```

--------------------------------

### Run YouTrack MCP Docker Container from Pulled Image

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This command runs the YouTrack MCP server from a previously pulled Docker image. It requires setting the YouTrack URL and API token as environment variables.

```bash
docker run -i --rm \
     -e YOUTRACK_URL=https://your-instance.youtrack.cloud \
     -e YOUTRACK_API_TOKEN=your-api-token \
     tonyzorin/youtrack-mcp:latest
```

--------------------------------

### Run YouTrack MCP Docker Container for Self-Hosted Instances

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This command runs the YouTrack MCP server as a Docker container, configured for self-hosted YouTrack instances. It requires setting the YouTrack URL, API token, and specifying that it's not a cloud instance.

```bash
docker run -i --rm \
     -e YOUTRACK_URL=https://your-instance.youtrack.cloud \
     -e YOUTRACK_API_TOKEN=your-api-token \
     -e YOUTRACK_CLOUD=false \
     tonyzorin/youtrack-mcp:latest
```

--------------------------------

### Clone YouTrack MCP Git Repository

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This command clones the YouTrack MCP source code repository from GitHub, allowing for local development or custom image building.

```bash
git clone https://github.com/tonyzorin/youtrack-mcp.git
cd youtrack-mcp
```

--------------------------------

### Run Docker Container with SSL Verification Disabled

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

Demonstrates how to run the `tonyzorin/youtrack-mcp` Docker container, disabling SSL certificate verification for the YouTrack instance. This is useful for self-hosted instances with self-signed certificates but is not recommended for production environments.

```bash
docker run -i --rm \
  -e YOUTRACK_URL=https://youtrack.internal.company.com \
  -e YOUTRACK_API_TOKEN=perm:your-permanent-token \
  -e YOUTRACK_VERIFY_SSL=false \
  tonyzorin/youtrack-mcp:latest
```

--------------------------------

### Pull YouTrack MCP Docker Image

Source: https://github.com/tonyzorin/youtrack-mcp/blob/main/README.md

This command pulls the latest YouTrack MCP Docker image from Docker Hub, preparing it for local execution.

```bash
docker pull tonyzorin/youtrack-mcp:latest
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.