mcp-instana 0.2.1__py3-none-any.whl → 0.3.1__py3-none-any.whl

{mcp_instana-0.2.1.dist-info → mcp_instana-0.3.1.dist-info}/METADATA

@@ -1,13 +1,14 @@
 Metadata-Version: 2.4
 Name: mcp-instana
-Version: 0.2.1
+Version: 0.3.1
 Summary: MCP server for Instana
 Author-email: Elina Priyadarshinee <Elina.priyadarshinee1@ibm.com>, Guangya Liu <gyliu@ibm.com>, Isabell Sippli <ischwert@de.ibm.com>, Jay Sharma <Jay.Sharma3@ibm.com>, Madhu Tadiparthi <madhu.tadiparthi@ibm.com>, Riya Kumari <Riya.Kumari3@ibm.com>
 License: Apache-2.0
 License-File: LICENSE.md
 Requires-Python: >=3.10
 Requires-Dist: fastmcp==2.10.3
-Requires-Dist: instana-client==1.0.0
+Requires-Dist: instana-client==1.0.1
+Requires-Dist: mcp
 Requires-Dist: pydantic==2.11.7
 Requires-Dist: python-dotenv==1.1.0
 Requires-Dist: requests==2.32.4
@@ -23,6 +24,7 @@ Description-Content-Type: text/markdown
 
 <!-- START doctoc generated TOC please keep comment here to allow auto update -->
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+<!-- mcp-name: io.github.instana/mcp-instana -->
 **Table of Contents**
 
 - [MCP Server for IBM Instana](#mcp-server-for-ibm-instana)
@@ -77,6 +79,10 @@ Description-Content-Type: text/markdown
       - [**Basic Usage**](#basic-usage)
       - [**Environment Variables**](#environment-variables)
       - [**Docker Compose Example**](#docker-compose-example)
+    - [Multi-Architecture Support](#multi-architecture-support)
+      - [**Supported Architectures**](#supported-architectures)
+      - [**Benefits of Multi-Architecture Images**](#benefits-of-multi-architecture-images)
+      - [**How It Works**](#how-it-works)
     - [Docker Security Features](#docker-security-features)
       - [**Security Best Practices Implemented**](#security-best-practices-implemented)
       - [**Image Size Optimization**](#image-size-optimization)
@@ -1023,16 +1029,40 @@ The project uses a **two-file dependency management strategy**:
 #### **Prerequisites**
 - Docker installed and running
 - Access to the project source code
+- Docker BuildKit for multi-architecture builds (enabled by default in recent Docker versions)
 
 #### **Build Command**
+
+**Single Architecture Build (Default):**
 ```bash
-# Build the optimized production image
-docker build -t mcp-instana .
+# Build for your local architecture (automatic detection)
+docker build -t mcp-instana:latest .
 
 # Build with a specific tag
 docker build -t mcp-instana:v1.0.0 .
 ```
 
+**Multi-Architecture Build:**
+```bash
+# Set up Docker BuildKit builder if you haven't already
+docker buildx create --name multiarch --driver docker-container --use
+
+# Build and push a multi-architecture image to a registry
+docker buildx build --platform linux/amd64,linux/arm64 -t username/mcp-instana:latest --push .
+```
+
+**Using the Helper Script:**
+```bash
+# Make the script executable
+chmod +x build_multiarch.sh
+
+# Build for local architecture
+./build_multiarch.sh
+
+# Build and push multi-architecture image
+./build_multiarch.sh --registry username/ --push
+```
+
 #### **What the Build Does**
 1. **Multi-stage build** for optimal size and security
 2. **Builder stage**: Installs only runtime dependencies from `pyproject-runtime.toml`
@@ -1044,27 +1074,14 @@ docker build -t mcp-instana:v1.0.0 .
 
 #### **Basic Usage**
 ```bash
-# Run with environment variables (recommended)
-docker run -p 8080:8080 \
-  -e INSTANA_API_TOKEN=your_instana_token \
-  -e INSTANA_BASE_URL=https://your-instana-instance.instana.io \
-  mcp-instana
+# Run the container (no credentials needed in the container)
+docker run -p 8080:8080 mcp-instana
 
 # Run with custom port
-docker run -p 8081:8080 \
-  -e INSTANA_API_TOKEN=your_instana_token \
-  -e INSTANA_BASE_URL=https://your-instana-instance.instana.io \
-  mcp-instana
+docker run -p 8081:8080 mcp-instana
 ```
 
-#### **Environment Variables**
-The container requires the following environment variables:
 
-| Variable | Description | Example |
-|----------|-------------|---------|
-| `INSTANA_API_TOKEN` | Your Instana API token | `your_instana_token` |
-| `INSTANA_BASE_URL` | Your Instana instance URL | `https://your-instana-instance.instana.io` |
-| `PORT` | Server port (optional, defaults to 8080) | `8080` |
 
 #### **Docker Compose Example**
 ```yaml
@@ -1074,9 +1091,6 @@ services:
     build: .
     ports:
       - "8080:8080"
-    environment:
-      - INSTANA_API_TOKEN=${INSTANA_API_TOKEN}
-      - INSTANA_BASE_URL=${INSTANA_BASE_URL}
     restart: unless-stopped
     healthcheck:
       test: ["CMD", "python", "-c", "import requests; requests.get('http://127.0.0.1:8080/health', timeout=5)"]
@@ -1086,15 +1100,35 @@ services:
       start_period: 40s
 ```
 
+### Multi-Architecture Support
+
+The Docker image supports multiple processor architectures, making it portable across different environments:
+
+#### **Supported Architectures**
+- ✅ **amd64/x86_64**: Standard Intel/AMD processors (Windows, Linux, most cloud VMs)
+- ✅ **arm64/aarch64**: Apple Silicon (M1/M2/M3), AWS Graviton, Raspberry Pi 4, etc.
+
+#### **Benefits of Multi-Architecture Images**
+- **Cross-Platform Compatibility**: Run the same image on any supported architecture
+- **Seamless Deployment**: No need to build different images for different environments
+- **CI/CD Simplification**: Build once, deploy anywhere
+- **Cloud Flexibility**: Switch between cloud providers and instance types without rebuilding images
+
+#### **How It Works**
+1. The multi-architecture image is a "manifest list" containing images for each architecture
+2. When you pull the image, Docker automatically selects the correct architecture for your system
+3. The image runs natively on your architecture without emulation, ensuring optimal performance
+
 ### Docker Security Features
 
 #### **Security Best Practices Implemented**
 - ✅ **Non-root user**: Container runs as `mcpuser` (not root)
-- ✅ **No hardcoded secrets**: All credentials passed via environment variables
+- ✅ **No secrets in container**: Credentials are passed via HTTP headers from clients, not stored in the container
 - ✅ **Minimal dependencies**: Only 20 essential runtime dependencies
 - ✅ **Multi-stage build**: Build tools don't make it to final image
 - ✅ **Health checks**: Built-in container health monitoring
 - ✅ **Optimized base image**: Uses `python:3.11-slim`
+- ✅ **Multi-architecture support**: Run natively on any supported platform
 
 #### **Image Size Optimization**
 - **Original approach**: 95+ dependencies → ~1-2GB+ image
@@ -1134,11 +1168,12 @@ docker exec -it <container_id> /bin/bash
 ### Production Deployment
 
 #### **Recommended Production Setup**
-1. **Use environment variables** for all secrets
-2. **Set up proper logging** and monitoring
-3. **Configure health checks** for container orchestration
-4. **Use container orchestration** (Kubernetes, Docker Swarm, etc.)
-5. **Implement proper backup** and disaster recovery
+1. **Run container without credentials** - The container runs in Streamable HTTP mode, so no Instana credentials are needed in the container
+2. **Configure clients with credentials** - Pass Instana credentials via HTTP headers from MCP clients (Claude Desktop, GitHub Copilot, etc.)
+3. **Set up proper logging** and monitoring
+4. **Configure health checks** for container orchestration
+5. **Use container orchestration** (Kubernetes, Docker Swarm, etc.)
+6. **Implement proper backup** and disaster recovery
 
 #### **Kubernetes Example**
 ```yaml
@@ -1161,14 +1196,6 @@ spec:
         image: mcp-instana:latest
         ports:
         - containerPort: 8080
-        env:
-        - name: INSTANA_API_TOKEN
-          valueFrom:
-            secretKeyRef:
-              name: instana-secrets
-              key: api-token
-        - name: INSTANA_BASE_URL
-          value: "https://your-instana-instance.instana.io"
         livenessProbe:
           httpGet:
             path: /health
@@ -1193,9 +1220,11 @@ spec:
 docker logs <container_id>
 
 # Common issues:
-# 1. Missing environment variables
-# 2. Port already in use
-# 3. Invalid Instana credentials
+# 1. Port already in use
+# 2. Invalid container image
+# 3. Missing dependencies
+
+# Credentials are passed via HTTP headers from the MCP client
 ```
 
 #### **Connection Issues**

{mcp_instana-0.2.1.dist-info → mcp_instana-0.3.1.dist-info}/RECORD

@@ -1,28 +1,28 @@
 src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/application/__init__.py,sha256=cfWHjA5NzAvL0jcekaIO3NTe5DRtznYRqg9_8hVwSzc,37
-src/application/application_alert_config.py,sha256=7_t-ahjwJgGdQvN7Cx5iopZCbIsabXj7HdYm0dW5Gg0,29769
-src/application/application_analyze.py,sha256=Ny5wCluzDTr_Rvo-xs0k976E9-6UCtTsPjRDEB9s3xI,26143
-src/application/application_catalog.py,sha256=F2UIVkWQrwV9crMVuK2tIzFBqz691JrVajk9quiLhE8,6210
-src/application/application_global_alert_config.py,sha256=05b8WdUMAKBCqzztO6PV8OSsk-sHuPUaQkvzEXg4enw,29860
-src/application/application_metrics.py,sha256=diWKASUFIWzlD2V-hAbog4zs2fkbD6ZoO-fthNGGShU,14901
-src/application/application_resources.py,sha256=6mX2n3JgmXeBfRNxcqi_de0ZaCnZlnwAgbni0rI6cL8,17722
-src/application/application_settings.py,sha256=jKuJRyVqY-Uq3WqeWYDtwf6ojkZ6J1ydLrywrm7bx6E,72869
-src/application/application_topology.py,sha256=_AcVsm7jw8b6CO5bCnsrpQdKjNw7gRQaH_-T3dD4_t4,4411
-src/automation/action_catalog.py,sha256=u_CR1h4cdT1kjQ0mknRf5kcu0XTTQIjyWCOb0t4VqLE,17596
-src/automation/action_history.py,sha256=kqEx5SIl_WFbgGs_eaKKDANOidTBtPqndfbA5iAJ9NA,15920
+src/application/application_alert_config.py,sha256=dbYGzUNZdfcEp_-zLLLm8_AfJZHoSPamLp4eHNYQ42I,31196
+src/application/application_analyze.py,sha256=EXOaGRn8wEoFUltAmAnzFRiTrkLzh7c_RHdP5Nj2-Hk,26947
+src/application/application_catalog.py,sha256=MVjU1CyYf6NSeCt2o0aTlNDAKeMUY3vr-wDOprnt2D8,6540
+src/application/application_global_alert_config.py,sha256=HqBlLLhMmpwy8pJlz9SDkHJ6w1vHH0LD7_LX4YWe7uk,31684
+src/application/application_metrics.py,sha256=swuoMk6fWNbW-IzivxJv8C7CgJie66u9d0JvtZ2jU4Y,15476
+src/application/application_resources.py,sha256=USbIrPnkokUBOiack7EChOTH2vqJM2D0EF-9MjGbn5w,18279
+src/application/application_settings.py,sha256=UZHZwY3GNW4JMl1Q6gGtGCE4iYERR7ijK0hslCYBMTo,76210
+src/application/application_topology.py,sha256=WinVNHSSTF771vq5hl2GxTLm3bdpehAQJ1AMumfy7M0,4870
+src/automation/action_catalog.py,sha256=jivR73riqBt-MGDnhSoEsshG7bHk7JpxvVuRx7FCtOA,17493
+src/automation/action_history.py,sha256=aMHUd5RLMrgdDvJXv0x6dkUA7I_35O0A89RPhFUfORI,16494
 src/core/__init__.py,sha256=gZdGV4TVETqe3XV-_lzQMw0IgyTTCqYYgP3PH9YdWbU,30
-src/core/server.py,sha256=-Dio8DtpPpkcw9cAlbCZzfa57_imdT9Nm6Y54GnejLk,24786
-src/core/utils.py,sha256=pDcMziANMCcgrzaTkEsISXOe-bB5sQmZOU70vJSqDx8,10306
+src/core/server.py,sha256=WvkxAWYBiKdo3mdxoc6v_9SCO8Ij6hS2vCSMSlIvbTY,25022
+src/core/utils.py,sha256=vB2ArNkOy0YIHk8Xv8nYHGEeTpw79pStJz6HL2aHWK8,11527
 src/event/__init__.py,sha256=ru-xCHU9xksGf9aJslvI37-6SI2yoBOpsoaED-vbaaQ,31
-src/event/events_tools.py,sha256=ZFoJit8QPN4Xa3Q8PKd58di4tnWEnLJjx_D5UaGqaAw,41902
+src/event/events_tools.py,sha256=R17EYk1jUUIQl5706idtOKzLWWNLchv2fRd-U8S1Uno,42775
 src/infrastructure/__init__.py,sha256=xZuRO1Zb2iPyO5G3PRM90dfesaFheL7DMSSJMujtLVk,40
-src/infrastructure/infrastructure_analyze.py,sha256=u830FfgSu6fCeFjQfAH5OgfOfW5IZQ7XwuH7wVOixPY,28922
-src/infrastructure/infrastructure_catalog.py,sha256=Ghe3xE9i90_F6nfjvwcLn6TYKlOPGW8Ex7ixd2_0Dxo,27058
-src/infrastructure/infrastructure_metrics.py,sha256=2ITmA2F7whIbAfEvBL51sIaBICrQUqRf3jlpkL2cTIM,6914
-src/infrastructure/infrastructure_resources.py,sha256=OM1NFyjoU_ADcNB1Tezlsi2JIiPzAb-xQBXCsqPlaTo,28434
-src/infrastructure/infrastructure_topology.py,sha256=YsEc1RgvQlMddQSolAoCC4YIDzihGUj5y6tKE0v5eAg,14556
+src/infrastructure/infrastructure_analyze.py,sha256=eBo9Rq7DRzsIKup4LR-ar_1g4kr_IPWeKcHMb-w1hLA,29455
+src/infrastructure/infrastructure_catalog.py,sha256=rE_ySS-MHDwGc_msat6XsxKolgYbduZSnPp4adXFQKM,29827
+src/infrastructure/infrastructure_metrics.py,sha256=he_KAadNp5VAWdDM65ZuDavHOZvwOX4tEuXJYwXjm78,7081
+src/infrastructure/infrastructure_resources.py,sha256=gFxjzGbUdlFXVjbuWKUxC0NEuwkPsZNkrWhnZ2Zd2t0,29297
+src/infrastructure/infrastructure_topology.py,sha256=mVz9jrpjstDNh_iUxZfGo912Ze5I3zH3XlapFIwm_3A,14830
 src/log/__init__.py,sha256=NwPZccMqR5aR6PrISe760gkABtpg7zpbwOK-uMPB-_Y,29
-src/log/log_alert_configuration.py,sha256=OTGxj9MmtTQOupAR65C1fbK_byG2wkkIGMlGTT1kEXU,14746
+src/log/log_alert_configuration.py,sha256=-8ORRo889n4X4GalwhTQa9uHU4JuERy2OfnhP7k6LOM,18430
 src/prompts/__init__.py,sha256=oXt7rf_EASRtgL43lKRgH8xhX6abJ3fhpHfarIlkFog,405
 src/prompts/application/__init__.py,sha256=9F3sMZpDkAiWi7oQDTd5OM1KBWIdCi2GQCTZlafcIGA,44
 src/prompts/application/application_alerts.py,sha256=1-SRn2mnd8BlT8vXLp7XmcEKUBOo7OxIHQOMCPP7BfQ,1853
@@ -46,14 +46,14 @@ src/prompts/website/website_catalog.py,sha256=bUIOMuKxtbTFaIrLpDL7soAvsINU9BJJcj
 src/prompts/website/website_configuration.py,sha256=d10veq4PwwPuJLxDpZUaObaOZZs2IIOBb-2-_nDNjm0,3694
 src/prompts/website/website_metrics.py,sha256=bJ5A7QuCdDsBiN0byFpTWl2Ir-qIc7mXuQyn80Px83E,1172
 src/settings/__init__.py,sha256=GD1pD_OLXbsJkNfMobByAV04HRKDknrJPyXUkMjZhvc,34
-src/settings/custom_dashboard_tools.py,sha256=OPqIBW3rUK1i1qafOez4iI2VvuwI-2FXCIrW0ptGtVM,16827
+src/settings/custom_dashboard_tools.py,sha256=HRYqkscf6rZVaGAFLzP5gUYN-aRkpmrRVv-Hq5-UHVo,17739
 src/website/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-src/website/website_analyze.py,sha256=jMduhrmndzdOOjRIfEvJb8dPyy0QQtr0fcXDls0psKA,21058
-src/website/website_catalog.py,sha256=vI0vkMjh-r4HmTuK5Lxf88yAGvlxS0tdqF13wDfCsqw,6705
-src/website/website_configuration.py,sha256=C0IAuNHysy7_oq8yulJ71wAyJ9mP2j0HIuKdcBVR3sU,34205
-src/website/website_metrics.py,sha256=dMDVTvYyJO9IRxIdxJ9B-nI4oeGMT_pS92iTWw7-jVY,10659
-mcp_instana-0.2.1.dist-info/METADATA,sha256=-FvjJ3v9aS32BxNiFCatML6x5btC02iwNvWMEyaNPyA,47070
-mcp_instana-0.2.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mcp_instana-0.2.1.dist-info/entry_points.txt,sha256=p1aZ9Ks0aJKpoIy6Mk-08cGYAfkXMNbwYIlokm513A4,140
-mcp_instana-0.2.1.dist-info/licenses/LICENSE.md,sha256=Ox7lseFP2kBRXBjsLweW1jLmWiCyrKjwF8ZUvCbKd70,11310
-mcp_instana-0.2.1.dist-info/RECORD,,
+src/website/website_analyze.py,sha256=0VyK8f-9vW1LzZ70b7IxKzwqSL2bWw8wDFSOCx2pEr4,21347
+src/website/website_catalog.py,sha256=Z21urtdTf8sU2SZiCwGq5OyPLaswS9lw12TCD9pS__4,7127
+src/website/website_configuration.py,sha256=hBHSFgj6GXOfLvlq8p-tBU4KFQc99uS167DBz4cjjK0,35926
+src/website/website_metrics.py,sha256=6McxbVYZq5i61Ml3QcVeHS86y2rCIPzdDuUDOxNtnMM,10954
+mcp_instana-0.3.1.dist-info/METADATA,sha256=ihXkPTCUrBqJJ_hqtIBfi7rSfb-3xuEiQLn_-LhSwL8,48596
+mcp_instana-0.3.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mcp_instana-0.3.1.dist-info/entry_points.txt,sha256=p1aZ9Ks0aJKpoIy6Mk-08cGYAfkXMNbwYIlokm513A4,140
+mcp_instana-0.3.1.dist-info/licenses/LICENSE.md,sha256=Ox7lseFP2kBRXBjsLweW1jLmWiCyrKjwF8ZUvCbKd70,11310
+mcp_instana-0.3.1.dist-info/RECORD,,

src/application/application_alert_config.py

@@ -7,6 +7,11 @@ This module provides application alert configuration tools for Instana monitorin
 import logging
 from typing import Any, Dict, List, Optional, Union
 
+from mcp.types import ToolAnnotations
+
+from src.core.utils import BaseInstanaClient, register_as_tool, with_header_auth
+from src.prompts import mcp
+
 # Import the necessary classes from the SDK
 try:
     from instana_client.api.application_alert_configuration_api import (
@@ -18,8 +23,6 @@ except ImportError:
     logger.error("Failed to import application alert configuration API", exc_info=True)
     raise
 
-from src.core.utils import BaseInstanaClient, register_as_tool, with_header_auth
-
 # Configure logger for this module
 logger = logging.getLogger(__name__)
 
@@ -30,7 +33,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
         """Initialize the Application Alert MCP tools client."""
         super().__init__(read_token=read_token, base_url=base_url)
 
-    @register_as_tool
+    @register_as_tool(
+        title="Find Application Alert Config",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def find_application_alert_config(self,
                                             id: str,
@@ -78,7 +84,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             return {"error": f"Failed to get application alert config: {e!s}"}
 
 
-    @register_as_tool
+    @register_as_tool(
+        title="Find Application Alert Config Versions",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def find_application_alert_config_versions(self,
                                                      id: str,
@@ -126,7 +135,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in find_application_alert_config_versions: {e}", exc_info=True)
             return {"error": f"Failed to get application alert config versions: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Application Alert Configs",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def get_application_alert_configs(self,
                                             application_id: Optional[str] = None,
@@ -173,7 +185,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in get_application_alert_configs: {e}", exc_info=True)
             return {"error": f"Failed to get application alert configs: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Delete Application Alert Config",
+        annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=True)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def delete_application_alert_config(self,
                                               id: str,
@@ -214,7 +229,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in delete_application_alert_config: {e}", exc_info=True)
             return {"error": f"Failed to delete application alert config: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Enable Application Alert Config",
+        annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def enable_application_alert_config(self,
                                               id: str,
@@ -259,7 +277,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in enable_application_alert_config: {e}", exc_info=True)
             return {"error": f"Failed to enable application alert config: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Disable Application Alert Config",
+        annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def disable_application_alert_config(self,
                                                id: str,
@@ -304,7 +325,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in disable_application_alert_config: {e}", exc_info=True)
             return {"error": f"Failed to disable application alert config: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Restore Application Alert Config",
+        annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def restore_application_alert_config(self,
                                                id: str,
@@ -354,7 +378,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in restore_application_alert_config: {e}", exc_info=True)
             return {"error": f"Failed to restore application alert config: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Update Application Alert Config Baseline",
+        annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def update_application_alert_config_baseline(self,
                                                        id: str,
@@ -399,7 +426,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in update_application_alert_config_baseline: {e}", exc_info=True)
             return {"error": f"Failed to update application alert config baseline: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Create Application Alert Config",
+        annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def create_application_alert_config(self,
                                               payload: Union[Dict[str, Any], str],
@@ -521,7 +551,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in create_application_alert_config: {e}", exc_info=True)
             return {"error": f"Failed to create application alert config: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Update Application Alert Config",
+        annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def update_application_alert_config(self,
                                               id: str,

src/application/application_analyze.py

@@ -7,6 +7,10 @@ This module provides application analyze tool functionality for Instana monitori
 import logging
 from typing import Any, Dict, List, Optional, Union
 
+from mcp.types import ToolAnnotations
+
+from src.prompts import mcp
+
 # Import the necessary classes from the SDK
 try:
     from instana_client.api.application_analyze_api import ApplicationAnalyzeApi
@@ -50,7 +54,10 @@ class ApplicationAnalyzeMCPTools(BaseInstanaClient):
             logger.error(f"Error initializing ApplicationAnalyzeApi: {e}", exc_info=True)
             raise
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Call Details",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAnalyzeApi)
     async def get_call_details(
         self,
@@ -97,7 +104,10 @@ class ApplicationAnalyzeMCPTools(BaseInstanaClient):
             logger.error(f"Error getting call details: {e}", exc_info=True)
             return {"error": f"Failed to get call details: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Trace Details",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAnalyzeApi)
     async def get_trace_details(
         self,
@@ -159,7 +169,10 @@ class ApplicationAnalyzeMCPTools(BaseInstanaClient):
             return {"error": f"Failed to get trace details: {e!s}"}
 
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get All Traces",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAnalyzeApi)
     async def get_all_traces(
         self,
@@ -287,7 +300,10 @@ class ApplicationAnalyzeMCPTools(BaseInstanaClient):
             logger.error(f"Error in get_traces: {e}")
             return {"error": f"Failed to get traces: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Grouped Trace Metrics",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAnalyzeApi)
     async def get_grouped_trace_metrics(
         self,
@@ -431,7 +447,10 @@ class ApplicationAnalyzeMCPTools(BaseInstanaClient):
             logger.error(f"Error in get_grouped_trace_metrics: {e}")
             return {"error": f"Failed to get grouped trace metrics: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Grouped Calls Metrics",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAnalyzeApi)
     async def get_grouped_calls_metrics(
         self,
@@ -585,7 +604,10 @@ class ApplicationAnalyzeMCPTools(BaseInstanaClient):
             return {"error": f"Failed to get grouped call: {e!s}"}
 
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Correlated Traces",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAnalyzeApi)
     async def get_correlated_traces(
         self,

src/application/application_catalog.py

@@ -11,11 +11,14 @@ import traceback
 from datetime import datetime, timedelta
 from typing import Any, Dict, Optional
 
+from mcp.types import ToolAnnotations
+
 from src.core.utils import (
     BaseInstanaClient,
     register_as_tool,
     with_header_auth,
 )
+from src.prompts import mcp
 
 try:
     from instana_client.api.application_catalog_api import (
@@ -38,7 +41,10 @@ class ApplicationCatalogMCPTools(BaseInstanaClient):
         """Initialize the Application Catalog MCP tools client."""
         super().__init__(read_token=read_token, base_url=base_url)
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Application Tag Catalog",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationCatalogApi)
     async def get_application_tag_catalog(self,
                                           use_case: Optional[str] = None,
@@ -106,7 +112,10 @@ class ApplicationCatalogMCPTools(BaseInstanaClient):
             return {"error": f"Failed to get application catalog: {e!s}"}
 
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Application Metric Catalog",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationCatalogApi)
     async def get_application_metric_catalog(self, ctx=None, api_client=None) -> Dict[str, Any]:
         """