Skip to main content
Glama
willsygao

Tencent Cloud Live MCP Server

by willsygao

腾讯云直播服务

本服务基于Model Context Protocol(MCP)实现提供腾讯云直播API调用Tools的MCP Server,提供腾讯云直播域名管理、拉流转推、直播流管理和流管理等相关接口。

简介

本项目主要为大语言模型提供通过自然语言调用腾讯云直播API,管理腾讯云直播服务的能力。

Related MCP server: CLS MCP Server

依赖环境

  • Python 1.12

  • 腾讯云API密钥( 腾讯云控制台申请

    • TENCENTCLOUD_SECRET_ID

    • TENCENTCLOUD_SECRET_KEY

  • 腾讯云SDK-Python

获取安装

本地运行Server

# 配置环境变量
export TENCENTCLOUD_SECRET_ID="您的腾讯云SecretId"
export TENCENTCLOUD_SECRET_KEY="您的腾讯云SecretId"

# 启动服务
uv run src/server.py

Cursor中使用

通过发布在PyPI的包使用

先决条件:uv包管理器

需要注意的是,你必须安装好了uvx才可以进行Cursor的配置。

{
  "mcpServers": {
    "tencentcloud-live-mcp-server": {
      "command": "uvx",
      "args": [
        "tencentcloud-live-mcp-server"
      ],
      "env": {
        "TENCENTCLOUD_SECRET_ID": "------> 替换成你自己的 ID <------",
        "TENCENTCLOUD_SECRET_KEY": "------> 替换成你自己的 KEY <------"
      }
    }
  }
}

完成后重启Cursor完成配置。

功能

  • Tools

    • 域名管理

      • 添加域名

      • 删除域名

      • 启用域名

      • 禁用域名

      • 查询域名信息

      • 查询域名列表

    • 拉流转推

      • 删除直播拉流任务

      • 查询直播拉流任务

      • 创建直播拉流任务

      • 更新直播拉流任务

    • 直播流管理

      • 查询流状态

      • 查询直播中的流

    • 流管理

      • 断开直播流

      • 恢复直播流

      • 禁播直播流

      • 查询推断流事件

      • 设置延时直播

      • 取消直播延时

    • 转码模版

      • 创建转码模版

      • 删除转码模版

      • 创建转码规则

      • 删除转码规则

使用场景

MCP 如何赋能 AI Agent

  • MCP 提供统一的 protocol + params 语义化接口。

  • 签名、证书管理、API版本兼容等问题由 MCP Server 处理,AI Agent 只需关注业务逻辑。

  • 标准化错误处理

  • 降低开发门槛

MCP AI Agent 增强场景

  • AI驱动的云直播域名自动化运维:

    • 通过MCP协议将腾讯云直播域名管理的操作转化为可调用的工具。

    • 使大模型可根据自然语言指令完成域名管理操作。

  • AI运营专员零代码创建拉转推任务:

    • 无需记忆API参数规则,口语化指令直接拉起目标任务。

    • 一键跨平台分发,将直播流一键转发多平台。

  • AI直播房间智能化管理:

    • 快速熔断违规直播间,言出即停。

    • 实时掌控活跃直播间信息,联动多平台,纵览全局。

  • AI模板管理:

    • 目前已支持转码类模板的智能管理,可通过文本指令进行转码模板的增删改查操作。

Available Tools

23 tools
add_delay_live_streamC
设置延时直播

    Args:
        stream_name: 流名称
        domain_name: 推流域名
        app_name: 推流路径
        delay_time: 延播时间
        expire_time: 延播设置的过期时间(optional)

    Returns:
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
app_nameNo推流路径,与推流和播放地址中的AppName保持一致,默认为live
domain_nameNo您的推流域名。示例值:5000.livepush.myqcloud.com
stream_nameNo流名称。示例值:stream1
delay_timeNo延播时间,单位:秒,上限:600秒
expire_timeNo延播设置的过期时间。UTC 格式,例如:2018-11-29T19:00:00Z

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It mentions the tool sets up delayed live streaming but doesn't describe whether this is a mutation (likely yes), what permissions are required, whether it affects ongoing streams, rate limits, or error conditions. The return value '请求ID' (request ID) is noted but without context on how to use it. Significant behavioral gaps remain.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise and well-structured with clear sections for Args and Returns. It uses minimal words to convey the core function. However, the front-loaded purpose statement is very brief ('设置延时直播') and could be more informative without sacrificing conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations and no output schema, the description is incomplete for a mutation tool with 5 parameters. It lacks behavioral context (e.g., side effects, permissions), doesn't differentiate from siblings, and provides minimal guidance. The return value is mentioned but without detail on format or usage. More context is needed for safe and effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all parameters thoroughly with examples and constraints. The description lists parameters but adds no meaning beyond what the schema provides (e.g., it doesn't explain relationships between parameters or usage nuances). Baseline 3 is appropriate when schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the tool '设置延时直播' (sets up delayed live streaming), which is a clear verb+resource combination. However, it doesn't distinguish this from sibling tools like 'resume_delay_live_stream' or explain what differentiates 'add' from 'resume' in this context. The purpose is understandable but lacks sibling differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'resume_delay_live_stream' or 'forbid_live_stream'. It doesn't mention prerequisites, use cases, or exclusions. The agent must infer usage from the tool name alone, which is insufficient.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

add_live_domainC
添加域名

    Args:
        domain_name: 推流域名
        domain_type: 域名类型
        play_type: 拉流域名类型(optional)
        is_delay_live: 是否是慢直播(optional)
        is_mini_program_live: 是否是小程序直播(optional)
        verify_owner_type: 域名归属校验类型(optional)

    Returns:
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
domain_nameNo域名名称。示例值:www.test.com
domain_typeNo域名类型,0:推流域名,1:播放域名。示例值:0
play_typeNo拉流域名类型:1:国内,2:全球,3:境外。默认值:1。示例值:1
is_delay_liveNo是否是慢直播:0: 普通直播,1 :慢直播 。默认值: 0。示例值:1
is_mini_program_liveNo是否是小程序直播:0: 标准直播,1 :小程序直播 。默认值: 0。示例值:1
verify_owner_typeNo域名归属校验类型

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It states '添加域名' (add domain) which implies a write/mutation operation, but doesn't disclose behavioral traits like required permissions, whether this is idempotent, rate limits, or what '请求ID' (request ID) in the return means. The description is minimal and lacks crucial operational context for a domain creation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with just '添加域名' (add domain) followed by parameter and return documentation. While efficient, it's arguably under-specified rather than optimally concise. The structure with Args/Returns sections is clear but minimal.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a domain creation tool with 6 parameters, no annotations, and no output schema, the description is incomplete. It doesn't explain what happens after adding a domain, error conditions, or relationship to other live streaming operations. The return value '请求ID' (request ID) is mentioned but not explained. More context is needed for effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all parameters thoroughly with descriptions, examples, and defaults. The description lists parameter names in Chinese but adds no additional meaning beyond what's in the schema. Baseline 3 is appropriate when schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states '添加域名' (add domain) which provides a basic verb+resource, but it's vague about what type of domain (live streaming domain) and doesn't distinguish from sibling tools like 'add_delay_live_stream' or 'enable_live_domain'. The purpose is clear at a high level but lacks specificity for this context.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives like 'enable_live_domain' or 'add_delay_live_stream'. The description provides no context about prerequisites, when this is appropriate, or what happens after adding a domain. Usage is implied through parameter names but not explicitly stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

create_live_pull_stream_taskC
创建直播拉流任务

    Args:
        region: 地域
        source_type: 拉流源的类型
        source_urls: 拉流源 url 列表
        domain_name: 推流域名
        app_name: 推流路径
        stream_name: 推流名称
        start_time: 开始时间
        end_time: 结束时间
        operator: 任务操作人备注
        push_args: 推流参数(optional)
        callback_events: 需要回调的事件(optional)
        vod_loop_times: 点播拉流转推循环次数(optional)
        vod_refresh_type: 点播更新SourceUrls后的播放方式(optional)
        callback_url: 自定义回调地址(optional)
        extra_cmd: 其他参数(optional)
        specify_task_id: 自定义任务 ID(optional)
        comment: 任务描述(optional)
        to_url: 完整目标 URL 地址(optional)
        file_index: 指定播放文件索引(optional)
        offset_time: 指定播放文件偏移(optional)
        backup_source_type: 备源的类型(optional)
        backup_source_url: 备源 URL(optional)
        vod_local_mode: 点播源是否启用本地推流模式(optional)
        record_template_id: 录制模板 ID(optional)
        backup_to_url: 新的目标地址,用于任务同时推两路场景(optional)
        transcode_template_name: 直播转码模板(optional)

    Returns:
        TaskId: 任务ID
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
regionNo地域ap-guangzhou
source_typeNo拉流源的类型:PullLivePushLive -直播,PullVodPushLive -点播,PullPicPushLive -图片。示例值:PullLivePushLive
source_urlsNo拉流源 url 列表,SourceType 为直播(PullLivePushLive)只可以填1个,SourceType 为点播(PullVodPushLive)可以填多个,上限30个。当前支持的文件格式:flv,mp4,hls。当前支持的拉流协议:http,https,rtmp,rtmps,rtsp,srt。
domain_nameNo推流域名。将拉取过来的流推到该域名
app_nameNo推流路径。将拉取过来的流推到该路径。
stream_nameNo推流名称。将拉取过来的流推到该流名称。
start_timeNo开始时间。使用 UTC 格式时间,例如:2019-01-08T10:00:00Z
end_timeNo结束时间
operatorNo任务操作人备注
push_argsNo推流参数。推流时携带自定义参数。
callback_eventsNo选择需要回调的事件(不填则回调全部)
vod_loop_timesNo点播拉流转推循环次数,默认:-1
vod_refresh_typeNo点播更新SourceUrls后的播放方式:ImmediateNewSource:立即播放新的拉流源内容;ContinueBreakPoint:播放完当前正在播放的点播 url 后再使用新的拉流源播放。(旧拉流源未播放的点播 url 不会再播放)
callback_urlNo自定义回调地址。拉流转推任务相关事件会回调到该地址。
extra_cmdNo其他参数
specify_task_idNo自定义任务 ID
commentNo任务描述,限制 512 字节
to_urlNo完整目标 URL 地址
file_indexNo指定播放文件索引
offset_timeNo指定播放文件偏移
backup_source_typeNo备源的类型:PullLivePushLive -直播,PullVodPushLive -点播
backup_source_urlNo备源 URL
vod_local_modeNo点播源是否启用本地推流模式,默认0,不启用
record_template_idNo录制模板 ID
backup_to_urlNo新的目标地址,用于任务同时推两路场景
transcode_template_nameNo直播转码模板,使用云直播的转码功能进行转码后再转推出去。转码模板需在云直播控制台创建

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. While '创建' (create) implies a write operation, the description doesn't specify required permissions, whether the task starts immediately, error handling, rate limits, or what happens if parameters are invalid. For a complex 26-parameter mutation tool with zero annotation coverage, this is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the purpose statement, but then includes a verbose Args/Returns section that duplicates schema information. While this structure might help human readers, it adds redundancy for an AI agent that already has access to the schema. The core description is concise, but the overall text could be more streamlined.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex mutation tool with 26 parameters and no annotations or output schema, the description is inadequate. It doesn't explain what the tool returns beyond 'TaskId' and '请求ID' (request ID), doesn't describe error conditions, doesn't provide usage examples, and doesn't clarify the operational context. The agent lacks crucial information to use this tool effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 26 parameters thoroughly with descriptions, defaults, and examples. The description adds no additional parameter information beyond what's in the schema, but since schema coverage is high, the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('创建直播拉流任务' translates to 'Create live pull stream task') and identifies the resource (a streaming task). It distinguishes from siblings like 'delete_live_pull_stream_task' by specifying creation, but doesn't explicitly differentiate from other creation tools like 'create_live_transcode_rule' or 'create_live_transcode_template' in terms of when to use each.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. The description doesn't mention prerequisites, constraints, or scenarios where this tool is appropriate compared to other streaming-related tools in the sibling list. The agent must infer usage from the tool name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

create_live_transcode_ruleC
创建转码规则
    Args:
        app_name: 推流路径
        domain_name: 推流域名
        stream_name: 流名称
        template_id: 模版ID

    Returns:
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
app_nameNo推流路径,与推流和播放地址中的AppName保持一致,默认为livelive
domain_nameNo您的推流域名。示例值:5000.livepush.myqcloud.com
stream_nameNo流名称。示例值:stream1
template_idNo模版ID

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It states '创建' (create) which implies a write/mutation operation, but doesn't disclose behavioral traits like whether this requires specific permissions, if it's idempotent, what happens on failure, or if there are rate limits. The description only lists parameters and a return value without explaining the tool's behavior beyond the basic action.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized and structured with clear sections for Args and Returns. It uses minimal text to convey the basic information, though the parameter section is redundant with the schema. No unnecessary elaboration or wasted sentences.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a mutation tool with no annotations and no output schema, the description is incomplete. It doesn't explain what a 'live transcode rule' is, how it integrates with the system, what the '请求ID' (request ID) represents, or error conditions. Given the complexity of live streaming operations and lack of structured context, more explanation is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all parameters thoroughly. The description merely repeats the parameter names in Chinese without adding any additional meaning, examples, or context beyond what's in the schema. This meets the baseline for high schema coverage but doesn't provide extra value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states '创建转码规则' (create transcode rule), which provides a basic verb+resource combination. However, it doesn't specify what type of transcode rule (e.g., live streaming, real-time encoding) or how it differs from sibling tools like 'create_live_transcode_template' or 'delete_live_transcode_rule'. The purpose is clear but lacks sibling differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. The description doesn't mention prerequisites, when this tool is appropriate, or what happens after creation. For example, it doesn't clarify if this should be used before or after creating a transcode template, or how it relates to other live streaming operations.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

create_live_transcode_templateC
创建转码模板

    Args:
        template_name: 模板名称
        video_bitrate: 视频码率
        acodec: 音频编码(optional)
        audio_bitrate: 音频码率(optional)
        vcodec: 视频编码(optional)
        description: 模板描述(optional)
        need_video: 是否保留视频(optional)
        width: 宽(optional)
        need_audio: 是否保留音频(optional)
        height: 高(optional)
        fps: 帧率(optional)
        gop: 关键帧间隔(optional)
        rotate: 旋转角度(optional)
        profile: 编码质量(optional)
        bitrate_to_orig: 当设置的码率>原始码率时,是否以原始码率为准(optional)
        height_to_orig: 当设置的高度>原始高度时,是否以原始高度为准(optional)
        fps_to_orig: 当设置的帧率>原始帧率时,是否以原始帧率为准(optional)
        ai_trans_code: 是否是极速高清模板(optional)
        adapt_bitrate_percent: 极速高清视频码率压缩比(optional)
        short_edge_as_height: 是否以短边作为高度(optional)
        drm_type: DRM 加密类型(optional)
        drm_tracks: DRM 加密项(optional)

    Returns:
        TemplateId: 模版ID
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
template_nameNo模板名称,例: 900p 仅支持字母和数字的组合
video_bitrateNo视频码率。范围:0kbps - 8000kbps
acodecNo音频编码:aac,默认aac
audio_bitrateNo音频码率,默认0
vcodecNo视频编码:h264/h265/origin,默认origin
descriptionNo模板描述
need_videoNo是否保留视频,0:否,1:是。默认1
widthNo宽,默认0。范围[0-3000] 数值必须是2的倍数,0是原始宽度
need_audioNo是否保留音频,0:否,1:是。默认1
heightNo高,默认0。范围[0-3000] 数值必须是2的倍数,0是原始高度
fpsNo帧率,默认0。范围0-60fps
gopNo关键帧间隔,单位:秒。默认原始的间隔范围2-6
rotateNo旋转角度,默认0 可取值:0,90,180,270
profileNo编码质量:baseline/main/high。默认baseline
bitrate_to_origNo当设置的码率>原始码率时,是否以原始码率为准。0:否, 1:是
height_to_origNo当设置的高度>原始高度时,是否以原始高度为准。0:否, 1:是
fps_to_origNo当设置的帧率>原始帧率时,是否以原始帧率为准。0:否, 1:是
ai_trans_codeNo是否是极速高清模板,0:否,1:是。默认0
adapt_bitrate_percentNo极速高清视频码率压缩比
short_edge_as_heightNo是否以短边作为高度,0:否,1:是。默认0
drm_typeNoDRM 加密类型,可选值:fairplay、normalaes、widevine
drm_tracksNoDRM 加密项,可选值:AUDIO、SD、HD、UHD1、UHD2,后四个为一组,同组中的内容只能选一个

TDQS

C2.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure but provides minimal information. It states the tool creates something but doesn't mention whether this is a write operation requiring specific permissions, whether templates are immediately usable, what happens if creation fails, or any rate limits. The description only lists parameters without explaining the tool's behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely brief ('创建转码模板') followed by a parameter list. While concise, it's under-specified rather than efficiently informative. The parameter list is organized but adds little value since the schema already documents everything. The structure is functional but not optimized for understanding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex 22-parameter tool with no annotations and no output schema, the description is inadequate. It doesn't explain what a 'live transcode template' is, how it differs from rules, when templates are used, what the return values mean, or any prerequisites. The parameter list doesn't compensate for the lack of conceptual context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 22 parameters thoroughly with ranges, defaults, and constraints. The description merely lists parameter names without adding meaningful semantic context beyond what's already in the schema. The baseline is 3 when schema coverage is complete.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description '创建转码模板' (Create transcode template) is a tautology that restates the tool name without providing additional specificity. It doesn't distinguish this tool from sibling tools like 'create_live_transcode_rule' or explain what makes a 'live transcode template' different from other transcode-related operations.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. There are multiple sibling tools related to live streaming and transcoding (create_live_transcode_rule, delete_live_transcode_template, etc.), but the description offers no context about when this specific template creation tool is appropriate versus other options.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

delete_live_domainC
删除域名

    Args:
        domain_name: 推流域名
        domain_type: 域名类型

    Returns:
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
domain_nameNo域名名称。示例值:www.test.com
domain_typeNo域名类型,0:推流域名,1:播放域名。示例值:0

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It states the tool deletes a domain, implying a destructive mutation, but lacks critical behavioral details: whether deletion is permanent/reversible, required permissions, rate limits, error conditions, or what '请求ID' (request ID) in returns signifies (e.g., async operation).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is brief and front-loaded with the main purpose ('删除域名'), followed by parameter and return sections. However, the Args/Returns formatting in Chinese is slightly redundant with the schema, and more context could be added without sacrificing conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a destructive tool with no annotations and no output schema, the description is incomplete. It doesn't explain the return value ('请求ID') meaning, error handling, or safety considerations (e.g., confirmation prompts, dependencies). Given the complexity of deletion operations, more behavioral context is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, providing clear parameter details (domain_name as string with example, domain_type as integer with values 0/1 explained). The description adds minimal value by listing parameters in Chinese but doesn't enhance semantics beyond the schema's thorough documentation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('删除域名' meaning 'delete domain') and specifies it's for live streaming domains, distinguishing it from non-live domain tools. However, it doesn't explicitly differentiate from sibling deletion tools like delete_live_pull_stream_task or delete_live_transcode_rule, which target different resources.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. The description doesn't mention prerequisites (e.g., domain must exist or be disabled), exclusions, or comparisons with sibling tools like forbid_live_domain (which might disable rather than delete).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

delete_live_pull_stream_taskC
删除直播拉流任务

    Args:
        region: 地域
        task_id: 任务ID
        operator: 操作人姓名
        specify_task_id: 指定任务ID(optional)

    Returns:
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
regionNo地域ap-guangzhou
task_idNo任务 Id。示例值:9564231
operatorNo任务 Id。示例值:9564231
specify_task_idNo指定任务 ID。注意:用于删除使用自定义任务 ID 创建的任务。示例值:myspecifytaskid

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It states the action is a deletion (implying destructive), but doesn't mention critical behaviors: whether deletion is permanent/reversible, required permissions, rate limits, error conditions, or what happens to associated resources. The return value ('请求ID' meaning 'request ID') is noted but without context on how to use it.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized and front-loaded with the core purpose. The parameter list and return statement are structured but not overly verbose. However, the formatting with indentation and separate sections is slightly more structured than necessary for pure conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given this is a destructive operation with no annotations and no output schema, the description is incomplete. It lacks behavioral details (safety, permissions), doesn't explain the return value's significance, and provides minimal usage context. For a 4-parameter deletion tool in a live streaming context, this leaves significant gaps for an AI agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all parameters thoroughly. The description lists parameters but adds minimal semantics beyond the schema—it notes 'specify_task_id' is optional and provides Chinese translations, but doesn't explain interdependencies (e.g., when to use 'task_id' vs 'specify_task_id') or usage context. Baseline 3 is appropriate given high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb ('删除' meaning 'delete') and resource ('直播拉流任务' meaning 'live pull stream task'), making the purpose unambiguous. It distinguishes from siblings like 'delete_live_domain' or 'delete_live_transcode_rule' by specifying the exact resource type. However, it doesn't explicitly contrast with similar deletion tools in the sibling list.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., task must exist), exclusions, or relationships to sibling tools like 'describe_live_pull_stream_tasks' (which might list tasks before deletion) or 'create_live_pull_stream_task' (its counterpart). Usage is implied but not explicitly stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

delete_live_transcode_ruleC
删除转码规则
    Args:
        app_name: 推流路径
        domain_name: 推流域名
        stream_name: 流名称
        template_id: 模版ID

    Returns:
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
app_nameNo推流路径,与推流和播放地址中的AppName保持一致,默认为livelive
domain_nameNo您的推流域名。示例值:5000.livepush.myqcloud.com
stream_nameNo流名称。示例值:stream1
template_idNo模版ID

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. While '删除' (delete) implies a destructive mutation, the description doesn't specify whether this requires special permissions, whether the deletion is permanent or reversible, what happens to associated resources, or any rate limits. For a destructive operation with zero annotation coverage, this is inadequate behavioral transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is brief with a clear purpose statement followed by Args/Returns sections. However, the structure is somewhat inefficient - the Args section essentially repeats parameter names without adding value beyond the schema. The single-sentence purpose statement is front-loaded but could be more informative about the tool's scope and impact.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a destructive deletion tool with no annotations and no output schema, the description is incomplete. It doesn't explain what a 'transcode rule' is in this context, what the deletion affects, what the return value '请求ID' (request ID) represents, or error conditions. Given the complexity of live streaming systems and the lack of structured behavioral information, the description should provide more context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, so all parameters are documented in the input schema. The description lists the four parameters but adds no additional semantic context beyond what's already in the schema descriptions. It doesn't explain relationships between parameters or provide usage examples. With complete schema coverage, the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states '删除转码规则' (delete transcode rule) which is a specific verb+resource combination. It distinguishes this tool from other deletion tools like delete_live_domain or delete_live_pull_stream_task by specifying it's for transcode rules. However, it doesn't explicitly differentiate from create_live_transcode_rule beyond the obvious delete/create distinction.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., that a transcode rule must exist first), when deletion is appropriate, or what happens after deletion. With multiple sibling tools for managing live streaming resources, this lack of contextual guidance is a significant gap.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

delete_live_transcode_templateC
删除转码模板

    Args:
        template_id: 模版ID

    Returns:
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
template_idYes

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden but only states the action ('delete') without disclosing behavioral traits. It doesn't mention permissions required, whether deletion is permanent/reversible, side effects (e.g., impact on ongoing streams), or error handling, which is inadequate for a destructive operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately concise with a brief purpose statement and parameter/return notes. However, the structure could be improved by front-loading critical information (e.g., deletion implications) rather than burying details in a simple list.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of a deletion tool with no annotations, no output schema, and incomplete behavioral disclosure, the description is insufficient. It lacks details on what '请求ID' (request ID) means in returns, error cases, or confirmation of deletion success, leaving gaps for safe agent invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds minimal semantics by naming the parameter ('template_id: 模版ID'), but with 0% schema description coverage and only one parameter, this provides basic clarification. Since there are 0 parameters with schema descriptions, the baseline is 4, as the description compensates slightly by identifying the parameter.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description '删除转码模板' (delete transcode template) states the verb and resource clearly, but it's vague about what 'transcode template' refers to in this live streaming context. It doesn't differentiate from sibling tools like delete_live_transcode_rule, which suggests similar deletion operations on related resources.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. The description doesn't mention prerequisites (e.g., template must exist), exclusions, or relationships to sibling tools like create_live_transcode_template or delete_live_transcode_rule, leaving usage context unclear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

describe_live_domainC
查询域名信息

    Args:
        domain_name: 推流域名

    Returns:
        DomainInfo: 域名信息
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
domain_nameNo域名名称。示例值:www.test.com

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions the tool queries information, implying a read-only operation, but doesn't specify if it requires authentication, has rate limits, returns real-time or cached data, or handles errors. For a tool with zero annotation coverage, this is a significant gap in transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is brief and structured with Args and Returns sections, making it easy to scan. However, it includes redundant information (e.g., '请求ID' - request ID is vague) and could be more front-loaded with key details. It's efficient but not perfectly optimized.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of live streaming domains and lack of annotations or output schema, the description is incomplete. It doesn't explain what 'DomainInfo' includes (e.g., status, settings, URLs) or the purpose of '请求ID', leaving the agent guessing about return values and operational context. This is inadequate for a tool in a domain with many siblings.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, with the parameter 'domain_name' well-documented in the input schema (including an example). The description adds minimal value by restating the parameter name in Chinese without additional context, such as format constraints or domain types. Baseline 3 is appropriate since the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the tool '查询域名信息' (queries domain information), which provides a basic verb+resource combination. However, it lacks specificity about what type of domain information is retrieved (e.g., configuration, status, metadata) and doesn't distinguish itself from sibling tools like 'describe_live_domains' (plural) or 'describe_play_addr' (address description). The purpose is clear but vague in scope.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. It doesn't mention prerequisites, such as whether the domain must be enabled or configured, or differentiate from sibling tools like 'describe_live_domains' for listing multiple domains. The description only states what it does, not when to use it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

describe_live_domainsC
查询域名列表

    Args:
        domain_status: 域名状态过滤(optional)
        domain_type: 域名类型(optional)
        page_size: 分页大小(optional)
        page_num: 取第几页(optional)
        is_delay_live: 普通直播/慢直播(optional)
        domain_prefix: 域名前缀(optional)
        play_type: 播放区域(optional)

    Returns:
        AllCount: 总记录数
        DomainList: 域名详细信息列表
        CreateLimitCount: 可继续添加域名数量
        PlayTypeCount: 启用的播放域名加速区域统计
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
domain_statusNo域名状态过滤。0-停用,1-启用。示例值:1
domain_typeNo域名类型,0:推流域名,1:播放域名。示例值:0
page_sizeNo分页大小,范围:10~100。默认10。示例值:10
page_numNo取第几页,范围:1~100000。默认1。示例值:1
is_delay_liveNo0 普通直播 1慢直播 默认0。示例值:0
domain_prefixNo域名前缀。示例值:qq
play_typeNo播放区域,只在 DomainType=1 时该参数有意义。1: 国内。2: 全球。3: 海外。

TDQS

C2.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It only states it's a query/read operation and lists return fields, but doesn't mention authentication requirements, rate limits, pagination behavior beyond parameters, error conditions, or whether this affects system state. For a 7-parameter query tool with no annotation coverage, this is insufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is structured with Args/Returns sections which is helpful, but includes redundant parameter documentation that duplicates the schema. The core purpose statement is only 4 characters ('查询域名列表'), making it overly terse. The return field documentation is useful but could be more efficiently integrated.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 7-parameter query tool with no annotations and no output schema, the description is incomplete. While it documents return fields, it doesn't explain the overall response structure, error handling, authentication needs, or how pagination works beyond the page_size/page_num parameters. The lack of output schema means the description should provide more complete return value documentation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 7 parameters thoroughly with descriptions, examples, and constraints. The description merely repeats parameter names without adding any additional semantic context, format details, or usage examples beyond what's in the schema. This meets the baseline for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states '查询域名列表' (query domain list), which clearly indicates a read operation to retrieve domain information. However, it doesn't specify what type of domains (live streaming domains) or differentiate from similar siblings like 'describe_live_domain' (singular). The purpose is clear but lacks specificity about the resource scope.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided about when to use this tool versus alternatives. The sibling list includes 'describe_live_domain' (singular) and other describe_* tools, but the description doesn't explain when to use list vs. single domain queries, or how this relates to other domain management tools like add/delete/enable_live_domain.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

describe_live_pull_stream_tasksC
查询直播拉流任务

    Args:
        region: 地域
        task_id: 任务ID
        page_num: 取得第几页(optional)
        page_size: 分页大小(optional)
        specify_task_id: 指定任务ID(optional)

    Returns:
        TaskInfos: 直播拉流任务信息列表
        PageNum: 分页的页码
        PageSize: 每页大小
        TotalNum: 符合条件的总个数
        TotalPage: 总页数
        LimitTaskNum: 限制可创建的最大任务数
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
regionNo地域ap-guangzhou
task_idNo任务 Id。来源:调用 CreateLivePullStreamTask 接口时返回。不填默认查询所有任务,按更新时间倒序排序。示例值:9564231
page_numNo取得第几页,默认值:1。示例值:1
page_sizeNo分页大小,默认值:10。取值范围:1~20 之前的任意整数。示例值:10
specify_task_idNo指定任务 ID。注意:仅供使用指定 ID 创建的任务查询。示例值:myspecifytaskid

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. While it mentions the tool queries tasks and describes return values, it doesn't disclose important behavioral traits like whether this is a read-only operation (implied but not stated), authentication requirements, rate limits, error conditions, or performance characteristics. The description provides basic functional information but lacks operational transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is reasonably structured with Args and Returns sections, but contains redundant information. The parameter explanations in the description are less detailed than those in the schema, making them somewhat wasteful. The Chinese-only text limits accessibility. While not excessively verbose, the description could be more efficiently integrated with the schema information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a query tool with 5 parameters and no output schema, the description provides basic functional coverage but lacks important context. It documents parameters and return values but doesn't explain the relationship between task_id and specify_task_id, doesn't mention pagination behavior beyond listing return fields, and provides no error handling information. With no annotations and no output schema, the description should do more to compensate for these gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description lists all 5 parameters with brief explanations, but the input schema already has 100% description coverage with more detailed documentation (including defaults, examples, and constraints). The description adds minimal value beyond what's already in the schema - it essentially repeats parameter names with less detail. With complete schema coverage, the baseline score of 3 is appropriate as the description doesn't significantly enhance parameter understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose as '查询直播拉流任务' (query live pull stream tasks), which is a specific verb+resource combination. It distinguishes itself from siblings like 'create_live_pull_stream_task' (create) and 'delete_live_pull_stream_task' (delete) by focusing on querying/describing existing tasks. However, it doesn't explicitly differentiate from other 'describe_' tools in the sibling list.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention when this query tool should be used instead of other describe tools (like describe_live_domain or describe_live_stream_state), nor does it provide any context about prerequisites or typical usage scenarios. The parameter documentation implies query capabilities but offers no strategic guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

describe_live_stream_event_listC
查询推断流事件

    Args:
        start_time: 起始时间
        end_time: 结束时间
        stream_name: 流名称
        domain_name: 推流域名
        app_name: 推流路径(optional)
        page_num: 取得第几页(optional)
        page_size: 分页大小(optional)
        is_fiter: 是否过滤(optional)
        is_strict: 是否精确查询(optional)
        is_asc: 是否按结束时间正序显示(optional)

    Returns:
        EventList: 推断流事件列表
        PageNum: 分页的页码
        PageSize: 每页大小
        TotalNum: 符合条件的总个数
        TotalPage: 总页数
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
start_timeNo起始时间。 UTC 格式,例如:2018-12-29T19:00:00Z。支持查询2个月内的历史记录
end_timeNo结束时间。UTC 格式,例如:2018-12-29T20:00:00Z。不超过当前时间,且和起始时间相差不得超过1个月
app_nameNo推流路径,与推流和播放地址中的AppName保持一致,默认为live
domain_nameNo您的推流域名。示例值:5000.livepush.myqcloud.com
stream_nameNo流名称。示例值:stream1
page_numNo取得第几页
page_sizeNo分页大小
is_fiterNo是否过滤,默认不过滤
is_strictNo是否精确查询,默认模糊匹配
is_ascNo是否按结束时间正序显示,默认逆序

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. While it mentions the tool queries inferred stream events and lists parameters, it doesn't describe important behavioral aspects: whether this is a read-only operation, what permissions might be required, whether there are rate limits, what happens if parameters are omitted, or how errors are handled. The description provides basic functional information but lacks crucial operational context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is efficiently structured with a brief purpose statement followed by parameter and return value documentation. While the Chinese text could be more concise, it follows a clear format with Args and Returns sections. Every sentence serves a purpose, though the initial purpose statement could be more informative.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a query tool with 10 parameters and no annotations or output schema, the description is insufficient. It doesn't explain what 'inferred stream events' are, what the EventList contains, how pagination works in practice, or what format the response takes. The lack of output schema means the description should explain return values more thoroughly, but it only lists names without context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, meaning all parameters are well-documented in the input schema itself. The description lists parameters but adds minimal semantic value beyond what's already in the schema descriptions. It doesn't explain relationships between parameters (e.g., how start_time and end_time work together) or provide usage examples. Given the high schema coverage, the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states '查询推断流事件' (query inferred stream events), which provides a basic purpose but is vague. It doesn't clearly differentiate this from sibling tools like 'describe_live_stream_online_list' or 'describe_live_stream_state', nor does it specify what 'inferred stream events' actually means. The description lacks specificity about what resource is being queried beyond the general concept of stream events.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided about when to use this tool versus alternatives. The description doesn't mention any prerequisites, context for usage, or comparisons with sibling tools like 'describe_live_stream_online_list' or 'describe_live_stream_state'. The agent receives no help in determining when this specific query tool is appropriate versus other describe tools in the system.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

describe_live_stream_online_listC
查询直播中的流

    Args:
        app_name: 推流路径(optional)
        domain_name: 推流域名(optional)
        page_num: 取的第几页(optional)
        page_size: 每页大小(optional)
        stream_name: 流名称(optional)

    Returns:
        正在直播中的流列表
ParametersJSON Schema
NameRequiredDescriptionDefault
app_nameNo推流路径,与推流和播放地址中的AppName保持一致,默认为livelive
domain_nameNo您的推流域名。示例值:5000.livepush.myqcloud.com5000.livepush.myqcloud.com
page_numNo取得第几页,默认1。示例值:1
page_sizeNo每页大小,最大100。取值:10~100之间的任意整数。默认值:10。示例值:10
stream_nameNo流名称。示例值:stream1mystream

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool returns '正在直播中的流列表' (list of live streams), which implies a read-only operation, but doesn't address critical behaviors like pagination handling (implied by page_num/page_size but not explained), rate limits, authentication needs, error conditions, or response format details. For a tool with 5 parameters and no annotation coverage, this is inadequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise and well-structured: a brief purpose statement followed by Args and Returns sections. However, the Args section merely lists parameter names without adding meaningful context, and the Returns section is vague ('正在直播中的流列表' doesn't specify structure). It's efficient but could be more informative with less redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 5 parameters, no annotations, and no output schema, the description is incomplete. It lacks behavioral details (e.g., pagination mechanics, error handling), usage guidance relative to siblings, and specifics on the return value format. For a query tool with filtering and pagination, this leaves significant gaps for an agent to invoke it correctly without additional context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with detailed parameter descriptions in the input schema (e.g., defaults, examples, constraints like page_size max 100). The tool description lists parameters in Args but adds minimal semantic value beyond restating names. It doesn't explain interactions between parameters (e.g., how app_name, domain_name, and stream_name filter results together) or provide usage examples. Baseline 3 is appropriate since the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: '查询直播中的流' (query live streams). It specifies the resource (live streams) and verb (query/list), which is specific and actionable. However, it doesn't explicitly differentiate from siblings like 'describe_live_stream_state' or 'describe_live_stream_event_list', which reduces clarity about when to choose this tool over those alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention sibling tools like 'describe_live_stream_state' (which might check individual stream status) or 'describe_live_stream_event_list' (which might list stream events), leaving the agent to guess based on names alone. There's no context about prerequisites, typical use cases, or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

describe_live_stream_stateC
查询流状态
    Args:
        app_name: 推流路径
        domain_name: 推流域名
        stream_name: 流名称

    Returns:
        流状态
ParametersJSON Schema
NameRequiredDescriptionDefault
app_nameNo推流路径,与推流和播放地址中的AppName保持一致,默认为livelive
domain_nameNo您的推流域名。示例值:5000.livepush.myqcloud.com
stream_nameNo流名称。示例值:stream1

TDQS

C2.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It only states it queries status without disclosing behavioral traits like whether it's read-only, requires authentication, has rate limits, or what happens on errors. For a tool with no annotations, this leaves critical operational details unspecified.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is brief but structured with Args and Returns sections, which is helpful. However, it includes redundant parameter listings that add little beyond the schema, and the core description '查询流状态' is overly terse, lacking necessary context. It's efficient but under-specified.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations and no output schema, the description is incomplete. It doesn't explain what '流状态' (stream status) returns, such as data format or possible values, nor does it cover error handling or dependencies. For a query tool with three parameters, this leaves too much ambiguity for effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, providing full parameter documentation. The description adds minimal value by listing parameters in an Args section, but doesn't explain semantics beyond what the schema already covers, such as interdependencies or usage examples. Baseline 3 is appropriate as the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states '查询流状态' (query stream status), which provides a basic verb+resource but is vague about what 'stream status' entails. It doesn't differentiate from siblings like 'describe_live_stream_online_list' or 'describe_live_stream_event_list', leaving the specific scope unclear. The purpose is identifiable but lacks precision.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. It doesn't mention prerequisites, context, or exclusions, such as how it differs from other 'describe' tools for streams. The agent must infer usage from the name alone, which is insufficient for informed selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

describe_play_addrC
获取播放地址

    Args:
        domain_name: 推流域名
        app_name: 区分同一个域名下多个 App 的地址路径
        stream_name: 流名称
        expire_time: 过期时间(optional)
        transcode_template: 转码模版ID(optional)

    Returns:
        PushAuthKeyInfo: 推流鉴权key信息
        RTMPAddr: RTMP地址
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
domain_nameNo域名名称。示例值:www.test.com
app_nameNo区分同一个域名下多个 App 的地址路径,默认为 live
stream_nameNo自定义的流名称,每路直播流的唯一标识符
expire_timeNo过期时间。默认:7天
transcode_templateNo转码模版ID

TDQS

C2.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. While it mentions the return values (PushAuthKeyInfo, RTMPAddr, 请求ID), it doesn't describe whether this is a read-only operation, what permissions are needed, whether it has side effects, rate limits, or error conditions. The description provides output information but lacks important behavioral context for a tool with no annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is efficiently structured with a brief purpose statement followed by Args and Returns sections. While the Chinese/English mix could be cleaner, the information is well-organized and front-loaded. The Args/Returns formatting helps with readability despite the language inconsistency.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 5 parameters, 100% schema coverage, but no annotations and no output schema, the description provides basic purpose and return value information. However, it lacks important context about when to use this versus sibling tools, behavioral characteristics, and deeper parameter relationships. The return value descriptions are helpful but incomplete without an output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all parameters thoroughly. The description lists parameters but doesn't add meaningful semantic context beyond what's in the schema. It correctly identifies optional parameters but doesn't explain relationships between parameters or provide usage examples that go beyond schema documentation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the purpose as '获取播放地址' (get playback address), which is a clear verb+resource combination. However, it doesn't distinguish this from sibling tools like 'describe_rtmp_addr' or explain what makes this specific playback address retrieval different from other describe/retrieval tools in the list.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided about when to use this tool versus alternatives. The description doesn't mention when this specific playback address retrieval is appropriate compared to other describe tools or the sibling 'describe_rtmp_addr' tool. There's no context about prerequisites or typical use cases.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

describe_rtmp_addrC
获取推流地址

    Args:
        domain_name: 推流域名
        app_name: 区分同一个域名下多个 App 的地址路径
        stream_name: 流名称
        expire_time: 过期时间(optional)

    Returns:
        PushAuthKeyInfo: 推流鉴权key信息
        RTMPAddr: RTMP地址
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
domain_nameNo域名名称。示例值:www.test.com
app_nameNo区分同一个域名下多个 App 的地址路径,默认为 live
stream_nameNo自定义的流名称,每路直播流的唯一标识符
expire_timeNo过期时间。默认:7天

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. While it mentions the tool retrieves RTMP addresses and auth key information, it doesn't disclose important behavioral aspects: whether this is a read-only operation, authentication requirements, rate limits, error conditions, or what happens when parameters are invalid. The description is minimal beyond basic functionality.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is reasonably concise with a clear purpose statement followed by Args and Returns sections. However, the formatting with indentation is inconsistent, and the Returns section lists data types without explaining what they contain or their significance. The structure is functional but could be more polished.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations, no output schema, and a tool that retrieves authentication-sensitive streaming addresses, the description is incomplete. It doesn't explain the security implications of the returned auth key, how the RTMP address should be used, or what format the response takes. For a tool dealing with streaming infrastructure and authentication, more context is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all parameters thoroughly with descriptions, examples, and defaults. The description's Args section merely repeats parameter names without adding meaningful semantic context beyond what's in the schema. This meets the baseline 3 for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose as '获取推流地址' (get RTMP push address), which is a specific verb+resource combination. It distinguishes itself from siblings like 'describe_play_addr' (which likely retrieves playback addresses) by focusing on push/streaming addresses rather than playback. However, it doesn't explicitly differentiate from all siblings, just implies a different address type.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites, when this tool is appropriate versus other describe_* tools, or any exclusions. The agent must infer usage from the tool name and description alone without explicit context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

drop_live_streamC
断开直播流

    Args:
        stream_name: 流名称
        domain_name: 推流域名
        app_name: 推流路径

    Returns:
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
app_nameNo推流路径,与推流和播放地址中的AppName保持一致,默认为live
domain_nameNo您的推流域名。示例值:5000.livepush.myqcloud.com
stream_nameNo流名称。示例值:stream1

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. While '断开' (disconnect) implies a destructive action, the description doesn't clarify whether this is reversible, what permissions are required, whether it affects viewers, or what happens to the stream data. This is a significant gap for a mutation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is efficiently structured with a clear purpose statement followed by parameter and return documentation. Every sentence serves a purpose, though the parameter listing could be more integrated with the main description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a destructive operation with no annotations and no output schema, the description is inadequate. It doesn't explain what '断开' actually means operationally, what the request ID represents, or what side effects occur. The agent lacks crucial context to use this tool safely and effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already fully documents all three parameters. The description lists the parameters but adds no additional meaning beyond what's in the schema descriptions. This meets the baseline for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('断开直播流' - disconnect live stream) and resource (live stream), making the purpose immediately understandable. It doesn't explicitly differentiate from sibling tools like 'forbid_live_stream' or 'resume_live_stream', which prevents a perfect score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'forbid_live_stream' or 'resume_live_stream'. There's no mention of prerequisites, consequences, or appropriate contexts for disconnecting a live stream.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

enable_live_domainC
启用域名

    Args:
        domain_name: 推流域名

    Returns:
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
domain_nameNo域名名称。示例值:www.test.com

TDQS

C2.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. '启用域名' implies a write/mutation operation (changing domain state to enabled), but it doesn't specify what 'enabling' actually does (e.g., makes domain available for live streaming, requires specific permissions, may have propagation delays). It mentions a return value ('请求ID' - request ID) which suggests an asynchronous operation, but doesn't explain what this ID is for or how to track completion. For a mutation tool with zero annotation coverage, this is inadequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is brief (three lines) but poorly structured. The first line '启用域名' is under-informative, while the Args/Returns sections are formatted but add little beyond what's in the schema. The description feels incomplete rather than efficiently concise - it wastes the opportunity to provide meaningful context in its limited space.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a mutation tool with no annotations and no output schema, the description is insufficient. It doesn't explain what 'enabling' a live domain entails operationally, what state changes occur, potential side effects, or how to use the returned request ID. Given the sibling tools include both 'add_live_domain' and 'forbid_live_domain', the description should clarify this tool's specific role in the domain lifecycle management.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with the parameter 'domain_name' well-documented in the schema (including example value and clear title). The description adds minimal value by labeling it '推流域名' (push streaming domain) which provides slightly more context than the schema's '域名名称' (domain name), but this is marginal. With high schema coverage, the baseline score of 3 is appropriate as the schema does most of the work.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description '启用域名' (Enable domain) is a tautology that essentially restates the tool name 'enable_live_domain' in Chinese. While it indicates the action is enabling something related to domains, it doesn't specify what type of domain (live streaming domain) or what 'enabling' entails operationally. It fails to distinguish this tool from sibling tools like 'add_live_domain' or 'forbid_live_domain' which also manipulate domains.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides absolutely no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., domain must exist, be in a disabled state), nor does it differentiate from similar tools like 'add_live_domain' (create new) or 'forbid_live_domain' (disable). The agent receives no contextual cues about appropriate usage scenarios.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

forbid_live_domainC
禁用域名

    Args:
        domain_name: 推流域名

    Returns:
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
domain_nameNo域名名称。示例值:www.test.com

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden but offers minimal behavioral insight. It states the action is 'disable' but doesn't clarify if this is reversible, requires specific permissions, affects ongoing streams, or has side effects. For a mutation tool with zero annotation coverage, this is insufficient disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is brief and structured with Args/Returns sections, but the core description '禁用域名' is overly terse. It efficiently states the action and parameter, though it could benefit from a slightly more explanatory opening sentence without becoming verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a mutation tool with no annotations and no output schema, the description is incomplete. It doesn't explain what 'disable' means operationally, what the return value '请求ID' (request ID) implies (e.g., for async tracking), or error conditions. Given the complexity of domain management and sibling tools, more context is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents the 'domain_name' parameter with an example. The description adds no additional meaning beyond restating the parameter name in Chinese ('推流域名' - push stream domain), which slightly clarifies it's for live streaming domains but doesn't provide format constraints or validation rules beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states '禁用域名' (disable domain) which provides a basic verb+resource, but it's vague about what type of domain and what 'disable' entails. It doesn't distinguish from siblings like 'delete_live_domain' or 'enable_live_domain', leaving ambiguity about whether this is a temporary deactivation or permanent removal.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives like 'delete_live_domain' or 'enable_live_domain'. The description lacks context about prerequisites, consequences, or typical use cases, leaving the agent with no usage differentiation from sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

forbid_live_streamC
禁推直播流

    Args:
        stream_name: 流名称
        domain_name: 推流域名
        app_name: 推流路径
        resume_time: 恢复流的时间(optional)
        reason: 禁推原因(optional)

    Returns:
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
app_nameNo推流路径,与推流和播放地址中的AppName保持一致,默认为live
domain_nameNo您的推流域名。示例值:5000.livepush.myqcloud.com
stream_nameNo流名称。示例值:stream1
resume_timeNo恢复流的时间。UTC 格式,例如:2018-11-29T19:00:00Z
reasonNo禁推原因。注明:请务必填写禁推原因,防止误操作

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. While '禁推' (forbid) implies a destructive/mutative action, the description doesn't clarify what 'forbid' actually means operationally - whether it stops streaming immediately, blocks future streams, requires specific permissions, or has irreversible consequences. The optional 'resume_time' parameter suggests this might be temporary, but this isn't explicitly stated in the description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is efficiently structured with a clear purpose statement followed by Args/Returns sections. However, the purpose statement is overly terse ('禁推直播流' - just three characters in Chinese) and could benefit from slightly more elaboration about what 'forbid' entails. The structure is good but could be more informative in the opening statement.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a destructive/mutative tool with no annotations and no output schema, the description is insufficient. It doesn't explain what the tool actually does operationally, what permissions are required, what the consequences are, or what the return value '请求ID' (request ID) represents. The description leaves critical behavioral questions unanswered for a tool that appears to modify live streaming state.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already fully documents all 5 parameters. The description lists parameters but adds no additional semantic context beyond what's in the schema. The baseline score of 3 is appropriate when the schema does all the parameter documentation work.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose as '禁推直播流' (forbid live stream), which is a specific verb+resource combination. However, it doesn't explicitly differentiate from sibling tools like 'drop_live_stream' or 'forbid_live_domain', which appear to be related stream management operations. The purpose is clear but lacks sibling differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance about when to use this tool versus alternatives like 'drop_live_stream' or 'resume_live_stream'. There's no mention of prerequisites, consequences, or typical use cases. The only implied usage is through the parameter descriptions, but no explicit guidance is provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

resume_delay_live_streamC
取消直播延时

    Args:
        stream_name: 流名称
        domain_name: 推流域名
        app_name: 推流路径

    Returns:
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
app_nameNo推流路径,与推流和播放地址中的AppName保持一致,默认为live
domain_nameNo您的推流域名。示例值:5000.livepush.myqcloud.com
stream_nameNo流名称。示例值:stream1

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It states the action ('取消直播延时') but lacks behavioral details: whether this requires specific permissions, if it's reversible, what happens to the stream (e.g., goes live immediately), rate limits, or side effects. For a mutation tool with zero annotation coverage, this is insufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is brief and front-loaded with the purpose ('取消直播延时'), followed by parameter and return sections. However, the parameter listing is redundant with the schema, and the return statement ('请求ID') is vague without context. It could be more efficient by omitting the Args/Returns boilerplate.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a mutation tool with no annotations and no output schema, the description is incomplete. It doesn't explain what '取消直播延时' entails behaviorally, what '请求ID' means (e.g., for tracking), error handling, or dependencies. Given the complexity of live streaming operations, more context is needed for safe use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with each parameter well-documented in the schema (e.g., '推流路径,与推流和播放地址中的AppName保持一致'). The description lists parameters but adds no meaning beyond the schema—it doesn't explain relationships between parameters or usage context. Baseline 3 is appropriate when schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description '取消直播延时' (cancel live stream delay) clearly states the verb (cancel) and resource (live stream delay). It distinguishes from sibling tools like 'add_delay_live_stream' (add delay) and 'resume_live_stream' (resume stream without specifying delay). However, it doesn't explicitly mention what type of delay is being canceled (e.g., buffer delay vs. scheduled delay), which prevents a perfect score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives. It doesn't specify prerequisites (e.g., must have an active delayed stream), contrast with 'resume_live_stream' (which might resume without affecting delay), or mention error conditions. The agent must infer usage from the name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

resume_live_streamC
恢复直播流

    Args:
        stream_name: 流名称
        domain_name: 推流域名
        app_name: 推流路径

    Returns:
        请求ID
ParametersJSON Schema
NameRequiredDescriptionDefault
app_nameNo推流路径,与推流和播放地址中的AppName保持一致,默认为live
domain_nameNo您的推流域名。示例值:5000.livepush.myqcloud.com
stream_nameNo流名称。示例值:stream1

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It states the action ('resume') but doesn't explain what 'resume' means operationally (e.g., does it restart streaming, restore permissions, or something else?), what permissions are required, whether it's idempotent, or what happens on failure. The return value '请求ID' (request ID) is mentioned but not explained. Significant behavioral gaps exist.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is brief and structured with clear sections for Args and Returns. However, the single-sentence purpose statement '恢复直播流' is somewhat terse and could benefit from slightly more context about what 'resume' entails. No wasted text, but slightly under-specified.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations and no output schema, the description is incomplete for a mutation tool. It doesn't explain the behavioral implications of 'resume' (e.g., side effects, error conditions), the meaning of the return value, or how this tool relates to siblings like 'forbid_live_stream'. For a tool that likely changes system state, this leaves critical gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with each parameter well-documented in the input schema (e.g., 'stream_name' has description '流名称。示例值:stream1'). The description lists the three parameters but adds no meaningful semantics beyond what the schema already provides. This meets the baseline of 3 when schema coverage is high.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the tool's purpose as '恢复直播流' (resume live stream), which is a clear verb+resource combination. However, it doesn't differentiate from sibling tools like 'resume_delay_live_stream' or 'forbid_live_stream', leaving ambiguity about when to use this specific resume operation versus alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., the stream must be in a forbidden state), compare to sibling tools like 'resume_delay_live_stream', or indicate when this tool would be inappropriate. The agent receives no usage context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 23 tool updates
    • First observedadd_delay_live_stream
    • First observedadd_live_domain
    • First observedcreate_live_pull_stream_task
    • First observedcreate_live_transcode_rule
    • First observedcreate_live_transcode_template
    • First observeddelete_live_domain
    • First observeddelete_live_pull_stream_task
    • First observeddelete_live_transcode_rule
    • First observeddelete_live_transcode_template
    • First observeddescribe_live_domain
    • First observeddescribe_live_domains
    • First observeddescribe_live_pull_stream_tasks
    • First observeddescribe_live_stream_event_list
    • First observeddescribe_live_stream_online_list
    • First observeddescribe_live_stream_state
    • First observeddescribe_play_addr
    • First observeddescribe_rtmp_addr
    • First observeddrop_live_stream
    • First observedenable_live_domain
    • First observedforbid_live_domain
    • First observedforbid_live_stream
    • First observedresume_delay_live_stream
    • First observedresume_live_stream

TDQS

B3.1/5.0

Scored across 23 tools

Disambiguation4/5

Most tools have distinct purposes targeting specific resources and actions (e.g., domain management, stream control, transcode operations). However, some overlap exists between 'describe_play_addr' and 'describe_rtmp_addr' (both retrieve addresses) and between 'forbid_live_stream' and 'drop_live_stream' (both stop streams), which could cause minor confusion.

Naming Consistency5/5

Tool names follow a highly consistent verb_noun pattern throughout, using snake_case uniformly. Verbs like 'add', 'create', 'delete', 'describe', 'enable', 'forbid', 'drop', and 'resume' are applied predictably to nouns like 'domain', 'stream', 'task', and 'template', making the set easy to navigate.

Tool Count4/5

With 23 tools, the count is slightly high but reasonable for a comprehensive live streaming service covering domains, streams, tasks, and templates. It supports core workflows without being excessively bloated, though some consolidation might improve usability.

Completeness5/5

The tool set provides complete CRUD/lifecycle coverage for Tencent Cloud Live's domain, including domain management (add, delete, enable, forbid, describe), stream control (forbid, drop, resume, delay), task handling (create, delete, describe), and transcode operations (create/delete rules and templates). No obvious gaps are present for the stated purpose.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    C
    quality
    C
    maintenance
    Enables AI models to interact with Tencent Cloud COS for cloud storage operations (upload, download, list files) and advanced media processing capabilities (image super-resolution, QR code recognition, video thumbnails, document conversion, and natural language-based file search).
    21
    Apache 2.0
  • A
    license
    A
    quality
    D
    maintenance
    Provides a suite of 33 tools for interacting with Tencent Cloud Log Service (CLS), enabling log analysis, PromQL metrics queries, and resource management. It allows AI assistants to perform CQL/SQL retrieval, manage alarm strategies, and handle data processing tasks with tiered permission controls.
    24
    6
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables large language models to directly access Tencent Cloud Log Service for log search, metric queries, and alarm management without code.
    256
    11
    Apache 2.0