@last9/mcp-server 0.1.11 → 0.1.12

package/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2024-present Last9
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -18,6 +18,7 @@ IDEs. Implements the following MCP
 [tools](https://modelcontextprotocol.io/docs/concepts/tools):
 
 **Observability & APM Tools:**
+
 - `get_exceptions`: Get the list of exceptions.
 - `get_service_summary`: Get service summary with throughput, error rate, and response time.
 - `get_service_environments`: Get available environments for services.
@@ -26,19 +27,27 @@ IDEs. Implements the following MCP
 - `get_service_dependency_graph`: Get service dependency graph showing incoming/outgoing dependencies.
 
 **Prometheus/PromQL Tools:**
+
 - `promptheus_range_query`: Execute PromQL range queries for metrics data.
 - `prometheus_instant_query`: Execute PromQL instant queries for metrics data.
 - `prometheus_label_values`: Get label values for PromQL queries.
 - `prometheus_labels`: Get available labels for PromQL queries.
 
 **Logs Management:**
+
 - `get_logs`: Get logs filtered by service name and/or severity level.
 - `get_drop_rules`: Get drop rules for logs that determine what logs get
   filtered out at [Last9 Control Plane](https://last9.io/control-plane)
 - `add_drop_rule`: Create a drop rule for logs at
   [Last9 Control Plane](https://last9.io/control-plane)
+- `get_service_logs`: Get raw log entries for a specific service over a time range. Can apply filters on severity and body.
+
+**Traces Management:**
+
+- `get_service_traces`: Query traces for a specific service with filtering options for span kinds, status codes, and other trace attributes.
 
 **Alert Management:**
+
 - `get_alert_config`: Get alert configurations (alert rules) from Last9.
 - `get_alerts`: Get currently active alerts from Last9 monitoring system.
 
@@ -156,20 +165,19 @@ Parameters:
 
 ### get_logs
 
-Gets logs filtered by optional service name and/or severity level within a
-specified time range.
+Gets logs filtered by service name and/or severity level within a specified time range. This tool now uses the advanced v2 logs API with physical index optimization for better performance.
+
+**Note**: This tool now requires a `service_name` parameter and internally uses the same advanced infrastructure as `get_service_logs`.
 
 Parameters:
 
-- `service` (string, optional): Name of the service to get logs for.
-- `severity` (string, optional): Severity of the logs to get.
-- `lookback_minutes` (integer, recommended): Number of minutes to look back from
-  now. Default: 60. Examples: 60, 30, 15.
-- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD
-  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, required): Name of the service to get logs for.
+- `severity` (string, optional): Severity of the logs to get (automatically converted to severity_filters format).
+- `lookback_minutes` (integer, recommended): Number of minutes to look back from now. Default: 60. Examples: 60, 30, 15.
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD 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.
 - `limit` (integer, optional): Maximum number of logs to return. Default: 20.
+- `env` (string, optional): Environment to filter by. Use "get_service_environments" tool to get available environments.
 
 ### get_drop_rules
 
@@ -237,13 +245,62 @@ Returns information about:
 - Metric degradation information
 - Group labels and annotations for each instance
 
+### get_service_logs
+
+Get raw log entries for a specific service over a time range. This tool retrieves actual log entries including log messages, timestamps, severity levels, and other metadata. Useful for debugging issues, monitoring service behavior, and analyzing specific log patterns.
+
+Parameters:
+
+- `service_name` (string, required): Name of the service to get logs for.
+- `lookback_minutes` (integer, optional): Number of minutes to look back from now. Default: 60 minutes. Examples: 60, 30, 15.
+- `limit` (integer, optional): Maximum number of log entries to return. Default: 20.
+- `env` (string, optional): Environment to filter by. Use "get_service_environments" tool to get available environments.
+- `severity_filters` (array, optional): Array of severity patterns to filter logs (e.g., ["error", "warn"]). Uses OR logic.
+- `body_filters` (array, optional): Array of message content patterns to filter logs (e.g., ["timeout", "failed"]). Uses OR logic.
+- `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.
+
+Filtering behavior:
+- Multiple filter types are combined with AND logic (service AND severity AND body)
+- Each filter array uses OR logic (matches any pattern in the array)
+
+Examples:
+- service_name="api" + severity_filters=["error"] + body_filters=["timeout"] → finds error logs containing "timeout"
+- service_name="web" + body_filters=["timeout", "failed", "error 500"] → finds logs containing any of these patterns
+
+### 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.
+
+Parameters:
+
+- `service_name` (string, required): Name of the service to get traces for.
+- `lookback_minutes` (integer, optional): Number of minutes to look back from now. Default: 60 minutes. Examples: 60, 30, 15.
+- `limit` (integer, optional): Maximum number of traces to return. Default: 10.
+- `env` (string, optional): Environment to filter by. Use "get_service_environments" tool to get available environments.
+- `span_kind` (array, optional): Filter by span types (server, client, internal, consumer, producer).
+- `span_name` (string, optional): Filter by specific span name.
+- `status_code` (array, optional): Filter by trace status (ok, error, unset, success).
+- `order` (string, optional): Field to order traces by. Default: "Duration". Options: Duration, Timestamp.
+- `direction` (string, optional): Sort direction. Default: "backward". Options: forward, backward.
+- `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.
+
+Filtering options:
+- Combine multiple filters to narrow down specific traces of interest
+- Use time range filters with lookback_minutes or explicit start/end times
+
+Examples:
+- service_name="api" + span_kind=["server"] + status_code=["error"] → finds failed server-side traces
+- service_name="payment" + span_name="process_payment" + lookback_minutes=30 → finds payment processing traces from last 30 minutes
+
 ## Installation
 
 You can install the Last9 Observability MCP server using either:
 
 ### Homebrew
 
-```
+```bash
 # Add the Last9 tap
 brew tap last9/tap
 
@@ -285,6 +342,7 @@ Configure the Claude app to use the MCP server:
 4. Copy and paste the server config to your existing file, then save
 5. Restart Claude
 
+### If installed via Homebrew:
 ```json
 {
   "mcpServers": {
@@ -300,6 +358,23 @@ Configure the Claude app to use the MCP server:
 }
 ```
 
+### If installed via NPM:
+```json
+{
+  "mcpServers": {
+    "last9": {
+      "command": "npx",
+      "args": ["-y", "@last9/mcp-server"],
+      "env": {
+        "LAST9_BASE_URL": "<last9_otlp_host>",
+        "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
+        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+      }
+    }
+  }
+}
+```
+
 ## Usage with Cursor
 
 Configure Cursor to use the MCP server:
@@ -310,6 +385,7 @@ Configure Cursor to use the MCP server:
 4. Copy and paste the server config to your existing file, then save
 5. Restart Cursor
 
+### If installed via Homebrew:
 ```json
 {
   "mcpServers": {
@@ -325,6 +401,23 @@ Configure Cursor to use the MCP server:
 }
 ```
 
+### If installed via NPM:
+```json
+{
+  "mcpServers": {
+    "last9": {
+      "command": "npx",
+      "args": ["-y", "@last9/mcp-server"],
+      "env": {
+        "LAST9_BASE_URL": "<last9_otlp_host>",
+        "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
+        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+      }
+    }
+  }
+}
+```
+
 ## Usage with Windsurf
 
 Configure Windsurf to use the MCP server:
@@ -335,6 +428,7 @@ Configure Windsurf to use the MCP server:
 4. Copy and paste the server config to your existing file, then save
 5. Restart Windsurf
 
+### If installed via Homebrew:
 ```json
 {
   "mcpServers": {
@@ -350,17 +444,35 @@ Configure Windsurf to use the MCP server:
 }
 ```
 
+### If installed via NPM:
+```json
+{
+  "mcpServers": {
+    "last9": {
+      "command": "npx",
+      "args": ["-y", "@last9/mcp-server"],
+      "env": {
+        "LAST9_BASE_URL": "<last9_otlp_host>",
+        "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
+        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+      }
+    }
+  }
+}
+```
+
 ## Usage with VS Code
 
 > Note: MCP support in VS Code is available starting v1.99 and is currently in
 > preview. For advanced configuration options and alternative setup methods,
 > [view the VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
 
-1.  Open VS Code, go to Settings, select the User tab, then Features, then Chat
-2.  Click "Edit settings.json"
-3.  Copy and paste the server config to your existing file, then save
-4.  Restart VS Code
+1. Open VS Code, go to Settings, select the User tab, then Features, then Chat
+2. Click "Edit settings.json"
+3. Copy and paste the server config to your existing file, then save
+4. Restart VS Code
 
+### If installed via Homebrew:
 ```json
 {
   "mcp": {
@@ -379,6 +491,114 @@ Configure Windsurf to use the MCP server:
 }
 ```
 
+### If installed via NPM:
+```json
+{
+  "mcp": {
+    "servers": {
+      "last9": {
+        "type": "stdio",
+        "command": "npx",
+        "args": ["-y", "@last9/mcp-server"],
+        "env": {
+          "LAST9_BASE_URL": "<last9_otlp_host>",
+          "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
+          "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+        }
+      }
+    }
+  }
+}
+```
+
+## Development
+
+For local development and testing, you can run the MCP server in HTTP mode which makes it easier to debug requests and responses.
+
+### Running in HTTP Mode
+
+Set the `HTTP_MODE` environment variable to enable HTTP server mode:
+
+```bash
+# Export required environment variables
+export LAST9_API_TOKEN="your_api_token"
+export LAST9_BASE_URL="https://your-last9-endpoint"  # Your Last9 endpoint
+export HTTP_MODE=true
+export HTTP_PORT=8080  # Optional, defaults to 8080
+
+# Run the server
+./last9-mcp-server
+```
+
+The server will start on `http://localhost:8080/mcp` and you can test it with curl:
+
+### Testing with curl
+
+```bash
+# Test get_service_logs
+curl -X POST http://localhost:8080/mcp \
+    -H "Content-Type: application/json" \
+    -H "Mcp-Session-Id: session_$(date +%s)000000000" \
+    -d '{
+      "jsonrpc": "2.0",
+      "id": 1,
+      "method": "tools/call",
+      "params": {
+        "name": "get_service_logs",
+        "arguments": {
+          "service_name": "your-service-name",
+          "lookback_minutes": 30,
+          "limit": 10
+        }
+      }
+    }'
+
+# Test get_service_traces
+curl -X POST http://localhost:8080/mcp \
+    -H "Content-Type: application/json" \
+    -H "Mcp-Session-Id: session_$(date +%s)000000000" \
+    -d '{
+      "jsonrpc": "2.0",
+      "id": 2,
+      "method": "tools/call",
+      "params": {
+        "name": "get_service_traces",
+        "arguments": {
+          "service_name": "your-service-name",
+          "lookback_minutes": 60,
+          "limit": 5
+        }
+      }
+    }'
+
+# List available tools
+curl -X POST http://localhost:8080/mcp \
+    -H "Content-Type: application/json" \
+    -H "Mcp-Session-Id: session_$(date +%s)000000000" \
+    -d '{
+      "jsonrpc": "2.0",
+      "id": 3,
+      "method": "tools/list",
+      "params": {}
+    }'
+```
+
+### Building from Source
+
+```bash
+# Clone the repository
+git clone https://github.com/last9/last9-mcp-server.git
+cd last9-mcp-server
+
+# Build the binary
+go build -o last9-mcp-server
+
+# Run in development mode
+HTTP_MODE=true ./last9-mcp-server
+```
+
+**Note**: HTTP mode is for development and testing only. When integrating with Claude Desktop or other MCP clients, use the default STDIO mode (without `HTTP_MODE=true`).
+
 ## Badges
 
 [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/last9-last9-mcp-server-badge.png)](https://mseep.ai/app/last9-last9-mcp-server)

package/bin/download-binary.js

@@ -1,7 +1,8 @@
 const https = require('https');
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
+const { execSync, execFileSync } = require('child_process');
+const os = require('os');
 
 // Get version from package.json
 const version = require('../package.json').version;
@@ -34,9 +35,11 @@ if (!fs.existsSync(distDir)) {
 const downloadUrl = `https://github.com/last9/last9-mcp-server/releases/download/v${version}/last9-mcp-server_${osMap[platform]}_${archMap[arch]}${platform === 'win32' ? '.zip' : '.tar.gz'}`;
 
 console.log(`Downloading from: ${downloadUrl}`);
-console.log(`Saving to: ${binaryPath}`);
+console.log(`Extracting to: ${binaryPath}`);
 
-const file = fs.createWriteStream(binaryPath);
+// Create temporary file for the archive
+const tempArchivePath = path.join(os.tmpdir(), `last9-mcp-server-${Date.now()}${platform === 'win32' ? '.zip' : '.tar.gz'}`);
+const file = fs.createWriteStream(tempArchivePath);
 
 const download = (url) => {
   return new Promise((resolve, reject) => {
@@ -59,22 +62,36 @@ const download = (url) => {
       file.on('finish', () => {
         file.close();
         console.log('Download completed');
-        
-        // Make binary executable on Unix-like systems
-        if (platform !== 'win32') {
-          try {
-            execSync(`chmod +x ${binaryPath}`);
+
+        // Extract the archive
+        try {
+          if (platform === 'win32') {
+            // Extract zip file (requires unzip or similar)
+            execSync(`cd "${distDir}" && unzip -o "${tempArchivePath}"`);
+          } else {
+            // Extract tar.gz file
+            execSync(`tar -xzf "${tempArchivePath}" -C "${distDir}"`);
+          }
+          console.log('Archive extracted');
+
+          // Clean up temporary file
+          fs.unlinkSync(tempArchivePath);
+
+          // Make binary executable on Unix-like systems
+          if (platform !== 'win32') {
+            execFileSync('chmod', ['+x', binaryPath]);
             console.log('Made binary executable');
-          } catch (err) {
-            reject(new Error(`Failed to make binary executable: ${err.message}`));
-            return;
           }
+
+          resolve();
+        } catch (err) {
+          // Clean up on error
+          try { fs.unlinkSync(tempArchivePath); } catch {}
+          reject(new Error(`Failed to extract or setup binary: ${err.message}`));
         }
-        
-        resolve();
       });
     }).on('error', (err) => {
-      fs.unlink(binaryPath, () => {}); // Delete the file async
+      fs.unlink(tempArchivePath, () => {}); // Delete the temp file async
       reject(new Error(`Download failed: ${err.message}`));
     });
   });

package/dist/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/README.md

@@ -0,0 +1,384 @@
+# Last9 MCP Server
+
+![last9 mcp demo](mcp-demo.gif)
+
+A [Model Context Protocol](https://modelcontextprotocol.io/) server
+implementation for [Last9](https://last9.io/mcp/) that enables AI agents to
+seamlessly bring real-time production context — logs, metrics, and traces — into
+your local environment to auto-fix code faster.
+
+- [View demo](https://www.youtube.com/watch?v=AQH5xq6qzjI)
+- Read our
+  [announcement blog post](https://last9.io/blog/launching-last9-mcp-server/)
+
+## Status
+
+Works with Claude desktop app, or Cursor, Windsurf, and VSCode (Github Copilot)
+IDEs. Implements the following MCP
+[tools](https://modelcontextprotocol.io/docs/concepts/tools):
+
+**Observability & APM Tools:**
+- `get_exceptions`: Get the list of exceptions.
+- `get_service_summary`: Get service summary with throughput, error rate, and response time.
+- `get_service_environments`: Get available environments for services.
+- `get_service_performance_details`: Get detailed performance metrics for a service.
+- `get_service_operations_summary`: Get operations summary for a service.
+- `get_service_dependency_graph`: Get service dependency graph showing incoming/outgoing dependencies.
+
+**Prometheus/PromQL Tools:**
+- `promptheus_range_query`: Execute PromQL range queries for metrics data.
+- `prometheus_instant_query`: Execute PromQL instant queries for metrics data.
+- `prometheus_label_values`: Get label values for PromQL queries.
+- `prometheus_labels`: Get available labels for PromQL queries.
+
+**Logs Management:**
+- `get_logs`: Get logs filtered by service name and/or severity level.
+- `get_drop_rules`: Get drop rules for logs that determine what logs get
+  filtered out at [Last9 Control Plane](https://last9.io/control-plane)
+- `add_drop_rule`: Create a drop rule for logs at
+  [Last9 Control Plane](https://last9.io/control-plane)
+
+**Alert Management:**
+- `get_alert_config`: Get alert configurations (alert rules) from Last9.
+- `get_alerts`: Get currently active alerts from Last9 monitoring system.
+
+## Tools Documentation
+
+### get_exceptions
+
+Retrieves server-side exceptions over a specified time range.
+
+Parameters:
+
+- `limit` (integer, optional): Maximum number of exceptions to return.
+  Default: 20.
+- `lookback_minutes` (integer, recommended): Number of minutes to look back from
+  now. Default: 60. Examples: 60, 30, 15.
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD
+  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.
+- `span_name` (string, optional): Name of the span to filter by.
+
+### get_service_summary
+
+Get service summary over a given time range. Includes service name, environment, throughput, error rate, and response time. All values are p95 quantiles over the time range.
+
+Parameters:
+
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to end_time_iso - 1 hour.
+- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to current time.
+- `env` (string, optional): Environment to filter by. Defaults to 'prod'.
+
+### get_service_environments
+
+Get available environments for services. Returns an array of environments that can be used with other APM tools.
+
+Parameters:
+
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to end_time_iso - 1 hour.
+- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to current time.
+
+Note: All other APM tools that retrieve service information (like `get_service_performance_details`, `get_service_dependency_graph`, `get_service_operations_summary`, `get_service_summary`) require an `env` parameter. This parameter must be one of the environments returned by this tool. If this tool returns an empty array, use an empty string `""` for the env parameter.
+
+### get_service_performance_details
+
+Get detailed performance metrics for a specific service over a given time range.
+
+Parameters:
+
+- `service_name` (string, required): Name of the service to get performance details for.
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to now - 60 minutes.
+- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to current time.
+- `env` (string, optional): Environment to filter by. Defaults to 'prod'.
+
+### get_service_operations_summary
+
+Get a summary of operations inside a service over a given time range. Returns operations like HTTP endpoints, database queries, messaging producer and HTTP client calls.
+
+Parameters:
+
+- `service_name` (string, required): Name of the service to get operations summary for.
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to now - 60 minutes.
+- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to current time.
+- `env` (string, optional): Environment to filter by. Defaults to 'prod'.
+
+### get_service_dependency_graph
+
+Get details of the throughput, response times and error rates of incoming, outgoing and infrastructure components of a service. Useful for analyzing cascading effects of errors and performance issues.
+
+Parameters:
+
+- `service_name` (string, optional): Name of the service to get the dependency graph for.
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to now - 60 minutes.
+- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to current time.
+- `env` (string, optional): Environment to filter by. Defaults to 'prod'.
+
+### promptheus_range_query
+
+Perform a Prometheus range query to get metrics data over a specified time range. Recommended to check available labels first using `prometheus_labels` tool.
+
+Parameters:
+
+- `query` (string, required): The range query to execute.
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to now - 60 minutes.
+- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to current time.
+
+### prometheus_instant_query
+
+Perform a Prometheus instant query to get metrics data at a specific point in time. Typically should use rollup functions like sum_over_time, avg_over_time, quantile_over_time over a time window.
+
+Parameters:
+
+- `query` (string, required): The instant query to execute.
+- `time_iso` (string, optional): Time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to current time.
+
+### prometheus_label_values
+
+Return the label values for a particular label and PromQL filter query. Similar to Prometheus /label_values call.
+
+Parameters:
+
+- `match_query` (string, required): A valid PromQL filter query.
+- `label` (string, required): The label to get values for.
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to now - 60 minutes.
+- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to current time.
+
+### prometheus_labels
+
+Return the labels for a given PromQL match query. Similar to Prometheus /labels call.
+
+Parameters:
+
+- `match_query` (string, required): A valid PromQL filter query.
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to now - 60 minutes.
+- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to current time.
+
+### get_logs
+
+Gets logs filtered by optional service name and/or severity level within a
+specified time range.
+
+Parameters:
+
+- `service` (string, optional): Name of the service to get logs for.
+- `severity` (string, optional): Severity of the logs to get.
+- `lookback_minutes` (integer, recommended): Number of minutes to look back from
+  now. Default: 60. Examples: 60, 30, 15.
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD
+  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.
+- `limit` (integer, optional): Maximum number of logs to return. Default: 20.
+
+### get_drop_rules
+
+Gets drop rules for logs, which determine what logs get filtered out from
+reaching Last9.
+
+### add_drop_rule
+
+Adds a new drop rule to filter out specific logs at
+[Last9 Control Plane](https://last9.io/control-plane)
+
+Parameters:
+
+- `name` (string, required): Name of the drop rule.
+- `filters` (array, required): List of filter conditions to apply. Each filter
+  has:
+  - `key` (string, required): The key to filter on. Only attributes and
+    resource.attributes keys are supported. For resource attributes, use format:
+    resource.attributes[key_name] and for log attributes, use format:
+    attributes[key_name] Double quotes in key names must be escaped.
+  - `value` (string, required): The value to filter against.
+  - `operator` (string, required): The operator used for filtering. Valid
+    values:
+    - "equals"
+    - "not_equals"
+  - `conjunction` (string, required): The logical conjunction between filters.
+    Valid values:
+    - "and"
+
+### get_alert_config
+
+Get alert configurations (alert rules) from Last9. Returns all configured alert rules including their conditions, labels, and annotations.
+
+Parameters:
+
+None - This tool retrieves all available alert configurations.
+
+Returns information about:
+
+- Alert rule ID and name
+- Primary indicator being monitored
+- Current state and severity
+- Algorithm used for alerting
+- Entity ID and organization details
+- Properties and configuration
+- Creation and update timestamps
+- Group timeseries notification settings
+
+### get_alerts
+
+Get currently active alerts from Last9 monitoring system. Returns all alerts that are currently firing or have fired recently within the specified time window.
+
+Parameters:
+
+- `timestamp` (integer, optional): Unix timestamp for the query time. Leave empty to default to current time.
+- `window` (integer, optional): Time window in seconds to look back for alerts. Defaults to 900 seconds (15 minutes). Range: 60-86400 seconds.
+
+Returns information about:
+
+- Alert rule details (ID, name, group, type)
+- Current state and severity
+- Last fired timestamp and duration
+- Rule properties and configuration
+- Alert instances with current values
+- Metric degradation information
+- Group labels and annotations for each instance
+
+## Installation
+
+You can install the Last9 Observability MCP server using either:
+
+### Homebrew
+
+```
+# Add the Last9 tap
+brew tap last9/tap
+
+# Install the Last9 MCP CLI
+brew install last9-mcp
+```
+
+### NPM
+
+```bash
+# Install globally
+npm install -g @last9/mcp-server
+
+# Or run directly with npx
+npx @last9/mcp-server
+```
+
+## Configuration
+
+### Environment Variables
+
+The Last9 MCP server requires the following environment variables:
+
+- `LAST9_BASE_URL`: (required) Last9 API URL from
+  [OTel integration](https://app.last9.io/integrations?integration=OpenTelemetry)
+- `LAST9_AUTH_TOKEN`: (required) Authentication token for Last9 MCP server from
+  [OTel integration](https://app.last9.io/integrations?integration=OpenTelemetry)
+- `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)
+
+## Usage with Claude Desktop
+
+Configure the Claude app to use the MCP server:
+
+1. Open the Claude Desktop app, go to Settings, then Developer
+2. Click Edit Config
+3. Open the `claude_desktop_config.json` file
+4. Copy and paste the server config to your existing file, then save
+5. Restart Claude
+
+```json
+{
+  "mcpServers": {
+    "last9": {
+      "command": "/opt/homebrew/bin/last9-mcp",
+      "env": {
+        "LAST9_BASE_URL": "<last9_otlp_host>",
+        "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
+        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+      }
+    }
+  }
+}
+```
+
+## Usage with Cursor
+
+Configure Cursor to use the MCP server:
+
+1. Open Cursor, go to Settings, then Cursor Settings
+2. Select MCP on the left
+3. Click Add "New Global MCP Server" at the top right
+4. Copy and paste the server config to your existing file, then save
+5. Restart Cursor
+
+```json
+{
+  "mcpServers": {
+    "last9": {
+      "command": "/opt/homebrew/bin/last9-mcp",
+      "env": {
+        "LAST9_BASE_URL": "<last9_otlp_host>",
+        "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
+        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+      }
+    }
+  }
+}
+```
+
+## Usage with Windsurf
+
+Configure Windsurf to use the MCP server:
+
+1. Open Windsurf, go to Settings, then Developer
+2. Click Edit Config
+3. Open the `windsurf_config.json` file
+4. Copy and paste the server config to your existing file, then save
+5. Restart Windsurf
+
+```json
+{
+  "mcpServers": {
+    "last9": {
+      "command": "/opt/homebrew/bin/last9-mcp",
+      "env": {
+        "LAST9_BASE_URL": "<last9_otlp_host>",
+        "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
+        "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+      }
+    }
+  }
+}
+```
+
+## Usage with VS Code
+
+> Note: MCP support in VS Code is available starting v1.99 and is currently in
+> preview. For advanced configuration options and alternative setup methods,
+> [view the VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
+
+1.  Open VS Code, go to Settings, select the User tab, then Features, then Chat
+2.  Click "Edit settings.json"
+3.  Copy and paste the server config to your existing file, then save
+4.  Restart VS Code
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "last9": {
+        "type": "stdio",
+        "command": "/opt/homebrew/bin/last9-mcp",
+        "env": {
+          "LAST9_BASE_URL": "<last9_otlp_host>",
+          "LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
+          "LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
+        }
+      }
+    }
+  }
+}
+```
+
+## Badges
+
+[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/last9-last9-mcp-server-badge.png)](https://mseep.ai/app/last9-last9-mcp-server)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@last9/mcp-server",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Last9 MCP Server - Model Context Protocol server implementation for Last9",
   "bin": {
     "last9-mcp": "./bin/cli.js"
@@ -30,7 +30,7 @@
     "claude"
   ],
   "author": "Last9",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "bugs": {
     "url": "https://github.com/last9/last9-mcp-server/issues"
   },