Merge pull request #920 from logzio/mcp-updates

Simplychee · web-flow · commit 06305cf9b439 · 2025-11-06T14:27:27.000+02:00
MCP - adding link
diff --git a/docs/open360/logzio-mcp.md b/docs/open360/logzio-mcp.md
@@ -6,7 +6,7 @@ image: https://dytvr9ot2sszz.cloudfront.net/logz-docs/social-assets/docs-social.
 keywords: [logz.io, mcp, model context protocol, llm tools, observability, logs, metrics, prometheus, promql, dashboards, alerts, elasticsearch, ai agents, integrations]
 ---
 
-The Logz.io Public API MCP (Model Context Protocol) server allows LLM clients (Claude, Cursor, ChatGPT, etc.) to access observability data—logs, metrics, dashboards, and alerts, in a standardized way. With MCP, AI agents can fetch context and trigger actions without custom integrations.
+The Logz.io Public API MCP (Model Context Protocol) server allows LLM clients (Claude, Cursor, ChatGPT, etc.) to access observability data - logs, metrics, dashboards, and alerts, in a standardized way. With MCP, AI agents can fetch context and trigger actions without custom integrations.
 
 ### Prerequisites
 
@@ -56,62 +56,62 @@ The MCP server exposes tools grouped by domain. Each tool follows the MCP reques
 
 Tools for managing and retrieving account information:
 
-| Tool                      | Description                         | Parameters |
-| ------------------------- | ----------------------------------- | ---------- |
-| `get_account_info` | Retrieve account name and ID for the current token. | None |
-| `get_associated_accounts` | List all accounts associated with the current account (including sub-accounts for owners). | None |
-| `get_metrics_accounts` | List all metrics accounts with details. | None |
+| Tool                      | Description                         | Parameters | API Link |
+| ------------------------- | ----------------------------------- | ---------- | ---------- |
+| `get_account_info` | Retrieve account name and ID for the current token. | None | [Link](https://api-docs.logz.io/docs/logz/who-am-i/) |
+| `get_associated_accounts` | List all accounts associated with the current account (including sub-accounts for owners). | None |  |
+| `get_metrics_accounts` | List all metrics accounts with details. | None | [Link](https://api-docs.logz.io/docs/logz/get-a-list-of-all-metrics-accounts) |
 
 ### Metrics management 
 
 Tools for querying metrics:
 
-| Tool | Description | Parameters |
-| ---- | ----------- | ---------- |
-| `query_prometheus_metrics` | Run a PromQL query at a single timestamp. | `query` (string, required), `time` (string, optional), `timeout` (string, optional) |
-| `query_prometheus_metrics_range` | Run a PromQL query over a time range. | `query` (string, required), `start` (string, required), `end` (string, required), `step` (string, required), `timeout` (string, optional) |
-| `get_available_metrics` | List available Prometheus metric names. | None |
-| `get_metric_labels` | List available labels for a metric. | `metric_name` (string, required) |
+| Tool | Description | Parameters | API Link |
+| ---- | ----------- | ---------- | ---------- |
+| `query_prometheus_metrics` | Run a PromQL query at a single timestamp. | `query` (string, required), `time` (string, optional), `timeout` (string, optional) | [Link](https://api-docs.logz.io/docs/logz/post-instant-query/) |
+| `query_prometheus_metrics_range` | Run a PromQL query over a time range. | `query` (string, required), `start` (string, required), `end` (string, required), `step` (string, required), `timeout` (string, optional) | [Link](https://api-docs.logz.io/docs/logz/post-range-query) |
+| `get_available_metrics` | List available Prometheus metric names. | None |   |
+| `get_metric_labels` | List available labels for a metric. | `metric_name` (string, required) | [Link](https://api-docs.logz.io/docs/logz/post-series-by-labels) |
 
 ### Logs management 
 
 Tools for searching, filtering, and managing logs:
 
-| Tool | Description | Parameters |
-| ---- | ----------- | ---------- |
-| `search_logs` | Search logs with Elasticsearch DSL. | `query` (object, required), `size` (int, optional), `from` (int, optional), `sort` (array, optional) |
-| `scroll_logs` | Scroll through large sets of log data. | `query` (object, optional), `scroll_id` (string, optional), `size` (int, optional), `scroll` (string, optional) |
-| `search_logs_simple` | Full-text search across all log fields. | `search_term` (string, required), `size` (int, optional), `from` (int, optional) |
-| `search_logs_by_timestamp` | Search logs within a specific time range. | `start_time` (string, required), `end_time` (string, required), `search_term` (string, optional), `size` (int, optional), `from` (int, optional) |
-| `get_log_structures` | Get the 40 most frequent log record structures. | None |
-| `get_all_log_types` | List all log types available. | None |
-| `retrieve_drop_filters` | Retrieve all configured drop filters. | None |
+| Tool | Description | Parameters | API Link |
+| ---- | ----------- | ---------- | ---------- |
+| `search_logs` | Search logs with Elasticsearch DSL. | `query` (object, required), `size` (int, optional), `from` (int, optional), `sort` (array, optional) | [Link](https://api-docs.logz.io/docs/logz/search) |
+| `scroll_logs` | Scroll through large sets of log data. | `query` (object, optional), `scroll_id` (string, optional), `size` (int, optional), `scroll` (string, optional) | [Link](https://api-docs.logz.io/docs/logz/scroll) |
+| `search_logs_simple` | Full-text search across all log fields. | `search_term` (string, required), `size` (int, optional), `from` (int, optional) | [Link](https://api-docs.logz.io/docs/logz/search) |
+| `search_logs_by_timestamp` | Search logs within a specific time range. | `start_time` (string, required), `end_time` (string, required), `search_term` (string, optional), `size` (int, optional), `from` (int, optional) | [Link](https://api-docs.logz.io/docs/logz/search) |
+| `get_log_structures` | Get the 40 most frequent log record structures. | None |   |
+| `get_all_log_types` | List all log types available. | None | [Link](https://api-docs.logz.io/docs/logz/get-log-types/) |
+| `retrieve_drop_filters` | Retrieve all configured drop filters. | None | [Link](https://api-docs.logz.io/docs/logz/get-all-for-account) |
 
 ### Dashboards & folders
 
 Tools for creating and managing dashboards and dashboard folders:
 
-| Tool | Description | Parameters |
-| ---  | ----------- | ---------- |
-| `get_all_dashboards` | List all dashboards with UIDs. | None |
-| `get_dashboard_by_id` | Retrieve a dashboard by UID. | `folder_id` (string, required), `uid` (string, required) |
-| `create_dashboard` | Create a dashboard from configuration.  | `folder_id` (string, required), `dashboard_config` (object, required) |
-| `update_dashboard` | Update a dashboard. | `folder_id` (string, required), `uid` (string, required), `dashboard_config` (object, required) |
-| `move_dashboard` | Move a dashboard to a different folder. | `uid` (string, required), `target_folder_id` (string, required) |
-| `get_all_dashboard_folders` | List all dashboard folders. | `with_dashboards` (string, optional) |
-| `create_dashboard_folder` | Create a new dashboard folder. | `name` (string, required) |
-| `get_dashboard_schema_example` | Retrieve an example dashboard schema. | None |
+| Tool | Description | Parameters | API Link |
+| ---  | ----------- | ---------- | ---------- |
+| `get_all_dashboards` | List all dashboards with UIDs. | None | [Link](https://api-docs.logz.io/docs/logz/get-all-dashboards) |
+| `get_dashboard_by_id` | Retrieve a dashboard by UID. | `folder_id` (string, required), `uid` (string, required) | [Link](https://api-docs.logz.io/docs/logz/get-dashboard-by-id) |
+| `create_dashboard` | Create a dashboard from configuration.  | `folder_id` (string, required), `dashboard_config` (object, required) | [Link](https://api-docs.logz.io/docs/logz/create-a-new-dashboard) |
+| `update_dashboard` | Update a dashboard. | `folder_id` (string, required), `uid` (string, required), `dashboard_config` (object, required) | [Link](https://api-docs.logz.io/docs/logz/update-an-existing-dashboard) |
+| `move_dashboard` | Move a dashboard to a different folder. | `uid` (string, required), `target_folder_id` (string, required) | [Link](https://api-docs.logz.io/docs/logz/move-a-dashboard-to-a-different-folder) |
+| `get_all_dashboard_folders` | List all dashboard folders. | `with_dashboards` (string, optional) | [Link](https://api-docs.logz.io/docs/logz/get-all-dashboards-folders) |
+| `create_dashboard_folder` | Create a new dashboard folder. | `name` (string, required) | [Link](https://api-docs.logz.io/docs/logz/create-dashboards-folder) |
+| `get_dashboard_schema_example` | Retrieve an example dashboard schema. | None |  |
 
 
 ### Alerts & insights
 
 Tools for alerts and insights:
 
-| Tool | Description | Parameters |
-| ---- | ----------- | ---------- |
-| `get_all_alerts`       | List all configured alerts.     | None |
-| `get_triggered_alerts` | List all triggered alerts.      | None |
-| `get_insights`         | Get insights matching criteria. | `startDate` (int, optional), `endDate` (int, optional), `size` (int, optional, 1–100), `search` (string, optional)|
+| Tool | Description | Parameters | API Link |
+| ---- | ----------- | ---------- | ---------- | 
+| `get_all_alerts`       | List all configured alerts.     | None | [Link](https://api-docs.logz.io/docs/logz/get-all-alerts) |
+| `get_triggered_alerts` | List all triggered alerts.      | None | [Link](https://api-docs.logz.io/docs/logz/triggered-alerts) |
+| `get_insights`         | Get insights matching criteria. | `startDate` (int, optional), `endDate` (int, optional), `size` (int, optional, 1–100), `search` (string, optional)| [Link](https://api-docs.logz.io/docs/logz/get-public-insights) |
 
 ## Best practices
 
@@ -120,4 +120,8 @@ Tools for alerts and insights:
 * Start with smaller query sizes to validate setup before scaling.
 * Secure your tokens; do not hard-code in public repos.
 
-For additional help, contact [Logz.io's Support](mailto:help@logz.io).
+For additional help, contact [Logz.io's Support](mailto:help@logz.io).
+
+---
+
+**Any use of Logz.io's MCP is subject to our [Terms of Use](https://logz.io/about-us/terms-of-use/).**
