@last9/mcp-server 0.1.15 → 0.2.0

package/README.md

@@ -45,6 +45,7 @@ IDEs. Implements the following MCP
 
 **Traces Management:**
 
+- `get_traces`: Retrieve traces by trace ID or service name with time range filtering.
 - `get_service_traces`: Query traces for a specific service with filtering options for span kinds, status codes, and other trace attributes.
 - `get_trace_attributes`: Get available trace attributes (series) for a specified time window.
 
@@ -73,7 +74,9 @@ Parameters:
   HH:MM:SS). Leave empty to use lookback_minutes.
 - `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD
   HH:MM:SS). Leave empty to default to current time.
+- `service_name` (string, optional): Filter exceptions by service name (e.g., api-service).
 - `span_name` (string, optional): Name of the span to filter by.
+- `deployment_environment` (string, optional): Filter exceptions by deployment environment from resource attributes (e.g., production, staging).
 
 ### get_service_summary
 
@@ -290,6 +293,30 @@ Returns:
   - Log Attributes: Standard log fields like service, severity, body, level, etc.
   - Resource Attributes: Resource-related fields prefixed with "resource_" like resource_k8s.pod.name, resource_service.name, etc.
 
+### get_traces
+
+Retrieve traces from Last9 by trace ID or service name. This tool allows you to get specific traces either by providing a trace ID for a single trace, or by providing a service name to get all traces for that service within a time range.
+
+Parameters:
+
+- `trace_id` (string, optional): Specific trace ID to retrieve. Cannot be used with service_name.
+- `service_name` (string, optional): Name of service to get traces for. Cannot be used with trace_id.
+- `lookback_minutes` (integer, optional): Number of minutes to look back from now. Default: 60 minutes. Examples: 60, 30, 15.
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to now - lookback_minutes.
+- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to current time.
+- `limit` (integer, optional): Maximum number of traces to return. Default: 10. Range: 1-100.
+- `env` (string, optional): Environment to filter by. Use "get_service_environments" tool to get available environments.
+
+Usage rules:
+- Exactly one of `trace_id` or `service_name` must be provided (not both, not neither)
+- Time range filtering only applies when using `service_name`
+
+Examples:
+- trace_id="abc123def456" - retrieves the specific trace
+- service_name="payment-service" + lookback_minutes=30 - gets all payment service traces from last 30 minutes
+
+Returns trace data including trace IDs, spans, duration, timestamps, and status information.
+
 ### get_service_traces
 
 Query traces for a specific service with filtering options for span kinds, status codes, and other trace attributes. This tool retrieves distributed tracing data for debugging performance issues, understanding request flows, and analyzing service interactions.
@@ -401,6 +428,8 @@ The Last9 MCP server requires the following environment variables:
 - `LAST9_REFRESH_TOKEN`: (required) Refresh Token with Write permissions, needed
   for accessing control plane APIs from
   [API Access](https://app.last9.io/settings/api-access)
+- `OTEL_EXPORTER_OTLP_ENDPOINT`: (required) OpenTelemetry collector endpoint URL
+- `OTEL_EXPORTER_OTLP_HEADERS`: (required) Headers for OTLP exporter authentication
 
 ## Usage
 
@@ -423,7 +452,9 @@ Configure the Claude app to use the MCP server:
       "env": {
         "LAST9_BASE_URL": "<last9_otlp_host>",
         "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
-        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>",
+        "OTEL_EXPORTER_OTLP_ENDPOINT": "<otel_endpoint_url>",
+        "OTEL_EXPORTER_OTLP_HEADERS": "<otel_headers>"
       }
     }
   }
@@ -440,7 +471,9 @@ Configure the Claude app to use the MCP server:
       "env": {
         "LAST9_BASE_URL": "<last9_otlp_host>",
         "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
-        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>",
+        "OTEL_EXPORTER_OTLP_ENDPOINT": "<otel_endpoint_url>",
+        "OTEL_EXPORTER_OTLP_HEADERS": "<otel_headers>"
       }
     }
   }
@@ -466,7 +499,9 @@ Configure Cursor to use the MCP server:
       "env": {
         "LAST9_BASE_URL": "<last9_otlp_host>",
         "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
-        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>",
+        "OTEL_EXPORTER_OTLP_ENDPOINT": "<otel_endpoint_url>",
+        "OTEL_EXPORTER_OTLP_HEADERS": "<otel_headers>"
       }
     }
   }
@@ -483,7 +518,9 @@ Configure Cursor to use the MCP server:
       "env": {
         "LAST9_BASE_URL": "<last9_otlp_host>",
         "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
-        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>",
+        "OTEL_EXPORTER_OTLP_ENDPOINT": "<otel_endpoint_url>",
+        "OTEL_EXPORTER_OTLP_HEADERS": "<otel_headers>"
       }
     }
   }
@@ -509,7 +546,9 @@ Configure Windsurf to use the MCP server:
       "env": {
         "LAST9_BASE_URL": "<last9_otlp_host>",
         "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
-        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>",
+        "OTEL_EXPORTER_OTLP_ENDPOINT": "<otel_endpoint_url>",
+        "OTEL_EXPORTER_OTLP_HEADERS": "<otel_headers>"
       }
     }
   }
@@ -526,7 +565,9 @@ Configure Windsurf to use the MCP server:
       "env": {
         "LAST9_BASE_URL": "<last9_otlp_host>",
         "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
-        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>",
+        "OTEL_EXPORTER_OTLP_ENDPOINT": "<otel_endpoint_url>",
+        "OTEL_EXPORTER_OTLP_HEADERS": "<otel_headers>"
       }
     }
   }
@@ -555,7 +596,9 @@ Configure Windsurf to use the MCP server:
         "env": {
           "LAST9_BASE_URL": "<last9_otlp_host>",
           "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
-          "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+          "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>",
+          "OTEL_EXPORTER_OTLP_ENDPOINT": "<otel_endpoint_url>",
+          "OTEL_EXPORTER_OTLP_HEADERS": "<otel_headers>"
         }
       }
     }
@@ -575,7 +618,9 @@ Configure Windsurf to use the MCP server:
         "env": {
           "LAST9_BASE_URL": "<last9_otlp_host>",
           "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
-          "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+          "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>",
+          "OTEL_EXPORTER_OTLP_ENDPOINT": "<otel_endpoint_url>",
+          "OTEL_EXPORTER_OTLP_HEADERS": "<otel_headers>"
         }
       }
     }
@@ -595,6 +640,8 @@ Set the `HTTP_MODE` environment variable to enable HTTP server mode:
 # Export required environment variables
 export LAST9_API_TOKEN="your_api_token"
 export LAST9_BASE_URL="https://your-last9-endpoint"  # Your Last9 endpoint
+export OTEL_EXPORTER_OTLP_ENDPOINT="<otel_endpoint_url>"
+export OTEL_EXPORTER_OTLP_HEADERS="<otel_headers>"
 export HTTP_MODE=true
 export HTTP_PORT=8080  # Optional, defaults to 8080
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@last9/mcp-server",
-  "version": "0.1.15",
+  "version": "0.2.0",
   "description": "Last9 MCP Server - Model Context Protocol server implementation for Last9",
   "bin": {
     "last9-mcp": "./bin/cli.js"