19 tools from the Cls MCP Server, categorised by risk level.
View the Cls policy →DescribeAlarmNotices 获取 CLS 通知渠道组列表。查询指定地域下的通知渠道组列表，通知渠道组用于配置告警通知的接收方式和接收人，包括邮件、短信、电话、企业微信等。
支持的过滤条件（Filters 参数）：
- name: 按通知渠道组名称过滤
- alarmNoticeId: 按通知渠道组 ID 过滤
返回信... DescribeAlarms 获取 CLS 告警策略列表。查询指定地域的告警策略列表，支持按告警策略启用状态等条件过滤和分页。
支持的过滤条件（Filters 参数）：
- name: 按告警策略名称过滤
- alarmId: 按告警策略 ID 过滤
- topicId: 按监控对象的日志主题 ID 过滤
- enabl... DescribeAlarmShields 获取 CLS 告警屏蔽规则列表。查询指定通知渠道组下的告警屏蔽规则，屏蔽规则用于在特定时间段内屏蔽告警通知，避免维护期间产生大量告警噪音。
应用场景：
1. 查看某个通知渠道组下配置的所有屏蔽规则
2. 查询当前生效的屏蔽规则（按状态过滤）
3. 审计和管理告警屏蔽配置
支持的过滤条件（F... DescribeAlertRecordHistory 获取 CLS 告警历史记录。查询指定时间范围内的告警历史记录，包含告警触发、恢复等事件的详细信息，用于分析告警趋势和排查告警问题。
支持的过滤条件（Filters 参数）：
- alarmId: 按告警策略 ID 过滤
- alarmName: 按告警策略名称过滤
- topicId: 按日... DescribeIndex 获取 CLS 日志主题索引配置。查询指定日志主题的索引配置信息，包括键值索引、元数据索引（TAG）和全文索引的详细配置。
索引配置决定了日志哪些字段可以被搜索和分析，是日志检索和分析的基础配置。
使用场景：生成检索语句时，推荐优先使用 TextToSearchLogQuery 工具（自动适配... DescribeLogContext 获取指定日志的上下文内容（前后 N 条日志）。用于在定位到某条异常日志后，查看其前后的日志以分析问题根因。
前置条件：需先使用 SearchLog 工具检索到目标日志，从返回结果的 Results 中获取 Time、PkgId、PkgLogId 三个必填参数。 2/5 DescribeLogHistogram 获取 CLS 日志直方图数据。查询指定日志主题在指定时间范围内的日志分布直方图，统计各时间段内匹配查询条件的日志数量。
重要：本工具仅返回时间（BTime）和计数（Count）两个维度，无法做多字段聚合分析。
- 如果日志主题支持 SQL 分析（标准存储），应优先使用 SearchLog 工... 2/5 DescribeNoticeContents 获取 CLS 通知内容模板列表。查询指定地域下的通知内容模板，模板定义告警触发和恢复时的消息内容，支持邮件、短信、企业微信、Webhook 等渠道。
支持的过滤条件（Filters 参数）：
- name: 按模板名称过滤
- noticeContentId: 按模板 ID 过滤
返回信息... DescribeWebCallbacks 获取 CLS 告警回调配置列表。查询指定地域下的 Webhook 回调配置，用于在告警触发或恢复时向指定 URL 发送 HTTP 通知，常用于与第三方监控系统或自动化运维系统集成。
支持的过滤条件（Filters 参数）：
- name: 按回调配置名称过滤
- callbackId: 按回... GetAlarmDetail 通过告警详情 URL 获取 CLS 告警的详细信息。从告警通知中的 URL 提取并解析告警信息，支持短链接和长链接格式。
支持的 URL 格式：
1. 短链接：https://alarm.cls.tencentcs.com/WeNZ5sSP
2. 短链接：https://mc.tencent... GetAlarmLog 获取 CLS 告警执行详情日志。查询指定时间范围内的告警策略执行详情，包括执行时间、结果、触发的日志内容等。
查询语法说明：
- * : 查询所有告警策略的执行详情
- AlarmId:"alarm-xxx" : 查询指定告警策略的执行详情
- AlarmName:"告警名称" : 按告警名... 2/5 GetRegionCodeByName 按地域名称搜索腾讯云地域参数代码（如"广州"→"ap-guangzhou"），支持中文和英文名称模糊匹配。 GetTopicInfoByName 按名称搜索日志主题或指标主题信息，返回主题 ID、名称、保留周期等信息。 QueryMetric 针对指标主题，查询指定时刻指标的最新值（瞬时查询）。使用 PromQL 语法对指标主题中的数据进行查询。注意：若该时刻向前推5分钟内均无指标数据，则无相应查询结果。
PromQL 语法示例：
- 简单查询：ETLProcessingTraffic
- 速率计算：rate(http_reque... 2/5 QueryRangeMetric 针对指标主题，查询指定时间范围内指标的变化趋势（范围查询）。使用 PromQL 语法对指标主题中的数据进行时序查询，返回区间内的时序数据。
step 参数建议：根据查询时间范围合理设置数据点密度
- 1 小时内：step=60（每分钟）
- 1 天内：step=300（每 5 分钟）
- 1... 2/5 SearchLog 搜索CLS日志内容。在指定日志主题和时间范围内搜索日志，支持复杂查询语法和统计分析。
重要：务必先使用 TextToSearchLogQuery 工具生成 CQL 查询语句！
TextToSearchLogQuery 能自动适配日志主题索引配置，确保字段名称准确、语法正确。
警告：如果不使用... 2/5 TextToSearchLogQuery 【CQL专家】AI 智能生成 CLS CQL 查询语句。将自然语言描述转换为可直接用于 SearchLog 或 DescribeLogHistogram 的 CQL 语句。
核心优势：
1. 自动适配日志主题索引配置，字段名称 100% 准确
2. 严格遵循 CQL 语法规范，生成的语句保证... The Cls MCP server exposes 19 tools across 2 categories: Read, Write.
Use Intercept, the open-source MCP proxy. Write YAML rules for each tool — rate limits, argument validation, or deny rules — then run Intercept in front of the Cls server.
Cls tools are categorised as Read (17), Write (2). Each category has a recommended default policy.
Open source. One binary. Zero dependencies.
npx -y @policylayer/intercept