Skip to main content
Glama
aahl

MCP Server for notify to weixin / telegram / bark / lark

by aahl

💬 Notify MCP Server

简体中文 | English

提供消息推送的 MCP (Model Context Protocol) 服务器,支持企业微信、钉钉、Telegram、Bark、Lark、飞书、Home Assistant

安装

方式1: uvx

{
  "mcpServers": {
    "mcp-notify": {
      "command": "uvx",
      "args": ["mcp-notify"],
      "env": {
        "WEWORK_BOT_KEY": "your-wework-bot-key"
      }
    }
  }
}

方式2: Smithery

需要通过OAuth授权或Smithery key

{
  "mcpServers": {
    "mcp-aktools": {
      "url": "https://server.smithery.ai/@aahl/mcp-notify/mcp" # 流式传输HTTP
    }
  }
}

方式3: Docker

mkdir /opt/mcp-notify
cd /opt/mcp-notify
wget https://raw.githubusercontent.com/aahl/mcp-notify/refs/heads/main/docker-compose.yml
docker-compose up -d
{
  "mcpServers": {
    "mcp-notify": {
      "url": "http://0.0.0.0:8809/mcp" # 流式传输HTTP
    }
  }
}

快速开始

  • 在线体验: fastmcp.cloud

  • 在线体验:

  • 添加到 Cursor Install MCP Server

  • 添加到 VS Code Install MCP Server

  • 添加到 Cherry Studio Install MCP Server

  • 添加到 Claude Code, 执行命令: claude mcp add notify -- uvx mcp-notify

  • 添加到 OpenAI CodeX, 执行命令: codex mcp add notify -- uvx mcp-notify

⚙️ 环境变量

企业微信群机器人

  • WEWORK_BOT_KEY: 企业微信群机器人默认key,也可以在提示词指定

企业微信应用号

  • WEWORK_APP_CORPID: 企业微信所属的企业ID

  • WEWORK_APP_SECRET: 企业微信应用的凭证密钥

  • WEWORK_APP_AGENTID: 企业微信应用的ID,默认: 1000002

  • WEWORK_APP_TOUSER: 企业微信默认接收人ID,也可以在提示词指定,默认: @all

  • WEWORK_BASE_URL: 企业微信API反代理地址,用于可信IP,默认: https://qyapi.weixin.qq.com

钉钉群机器人

  • DINGTALK_BOT_KEY: 钉钉群机器人access_token

  • DINGTALK_BASE_URL: 钉钉API地址,默认: https://oapi.dingtalk.com

飞书/Lark群机器人

  • FEISHU_BOT_KEY: 飞书群机器人key,也可以在提示词指定

  • FEISHU_BASE_URL: 飞书API地址,默认: https://open.feishu.cn

  • LARK_BOT_KEY: Lark群机器人key,也可以在提示词指定

  • LARK_BASE_URL: Lark API地址,默认: https://open.larksuite.com

Telegram

  • TELEGRAM_DEFAULT_CHAT: Telegram 默认会话ID,也可以在提示词指定

  • TELEGRAM_BOT_TOKEN: Telegram 机器人令牌

  • TELEGRAM_BASE_URL: Telegram API反代理地址,默认: https://api.telegram.org

Home Assistant

  • HASS_BASE_URL: Home Assistant 地址,默认: http://homeassistant.local:8123

  • HASS_ACCESS_TOKEN: Home Assistant 长效令牌

  • HASS_MOBILE_KEY: Home Assistant 移动设备key (如: mobile_app_your_iphone),也可在提示词指定

其他

  • BARK_DEVICE_KEY: 默认Bark设备key,也可以在提示词指定

  • BARK_BASE_URL: Bark API地址,默认: https://api.day.app

  • NTFY_DEFAULT_TOPIC: 默认Ntfy订阅主题,也可以在提示词指定

  • NTFY_BASE_URL: Ntfy API地址,默认: https://ntfy.sh

  • PUSH_PLUS_TOKEN: 默认PushPlus令牌,也可以在提示词指定

  • PUSH_PLUS_BASE_URL: PushPlus API地址,默认: http://www.pushplus.plus


Related MCP server: ntfy-mcp

🛠️ 可用工具

  • wework_send_text - 发送文本或Markdown消息

  • wework_send_image - 发送图片消息

  • wework_send_news - 发送图文链接消息

  • wework_app_send_text - 发送文本或Markdown消息

  • wework_app_send_image - 发送图片消息

  • wework_app_send_video - 发送视频消息

  • wework_app_send_voice - 发送语音消息

  • wework_app_send_file - 发送文件消息

  • wework_app_send_news - 发送图文链接消息

  • tg_send_message - 发送文本或Markdown消息

  • tg_send_photo - 发送图片消息

  • tg_send_video - 发送视频消息

  • tg_send_audio - 发送音频消息

  • tg_send_file - 发送文件消息

  • ding_send_text - 通过钉钉群机器人发送文本或Markdown消息

  • lark_send_text - 通过飞书/Lark群机器人发送文本或Markdown消息

  • bark_send_notify - 通过Bark发送通知

  • ntfy_send_notify - 通过Ntfy发送通知

  • pushplus_send_msg - 通过PushPlus发送消息

  • ha_send_mobile - 通过Home Assistant发送通知

  • text_to_sound - 将一段文本转成mp3音频链接


🔗 相关连接


Available Tools

21 tools
bark_send_notifyBark推送通知C

通过Bark推送通知

ParametersJSON Schema
NameRequiredDescriptionDefault
bodyYes推送内容
titleNo推送标题
subtitleNo推送副标题
device_keyNo设备key,默认从环境变量获取
urlNo点击推送时,跳转的URL ,支持URL Scheme 和 Universal Link
iconNo自定义图标URL
levelNo推送中断级别。critical: 重要警告, 在静音模式下也会响铃active:默认值,系统会立即亮屏显示通知timeSensitive:时效性通知,可在专注状态下显示通知。passive:仅将通知添加到通知列表,不会亮屏提醒。active
volumeNo重要警告的通知音量(0-10),默认为5

TDQS

C2.9/5.0
Behavior1/5

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

No annotations are provided, and the description does not disclose any behavioral traits (e.g., side effects, permission requirements, or limits). The single sentence only restates the verb and resource.

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 very concise (one sentence) and no information is wasted. However, it lacks front-loading of critical details like required parameter 'body'.

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?

With 8 parameters and no output schema or annotations, a one-sentence description is insufficient. It does not explain return values, usage patterns, or how parameters like 'level' affect behavior.

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 each parameter. The description adds no extra meaning beyond the schema, meeting the baseline level.

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

Purpose5/5

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

The description clearly states the tool's action (推送通知) and specific service (Bark). This distinguishes it from sibling tools like ding_send_text or lark_send_text, which target different platforms.

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 ntfy_send_notify or pushplus_send_msg. There is no mention of prerequisites, context, or when not to use it.

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

ding_send_text钉钉群机器人-发送文本消息B

钉钉群机器人发送文本或Markdown消息

ParametersJSON Schema
NameRequiredDescriptionDefault
textYes消息内容
titleNo消息标题
msgtypeNo内容类型,仅支持: text/markdownmarkdown
bot_keyNo钉钉群机器人access_token,默认从环境变量获取

TDQS

B3.1/5.0
Behavior2/5

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

No annotations are present, so the description must fully disclose behavioral traits. It only states the tool sends messages; it does not mention authentication (bot_key), error handling, rate limits, idempotency, or whether the operation is destructive. This is insufficient for an agent to understand implications.

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 a single sentence, concise and front-loaded. However, given the low behavioral transparency and missing guidance, a slightly longer description with more context would be justified 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?

With no output schema, no annotations, and 4 parameters, the description is too sparse. It fails to explain important aspects like how bot_key defaults from environment variable, the role of title in Markdown messages, or what the response looks like. The tool's complexity warrants a richer description.

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 baseline is 3. The description adds no additional meaning beyond the schema fields; each parameter is already described in the schema. The tool's description does not clarify relationships between parameters (e.g., title and msgtype) or provide context for use.

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

Purpose5/5

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

The description clearly states that the tool sends text or Markdown messages via a DingTalk group robot. It uses a specific verb ('发送') and resource ('钉钉群机器人'), which distinguishes it from sibling tools targeting other platforms (e.g., Bark, Lark, Telegram).

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. With many sibling tools for different messaging platforms, explicit instructions on when to choose DingTalk robot over others are missing.

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

ha_send_mobileSend to HomeAssistant Mobile APPC

Send a notification to Home Assistant Mobile APP

ParametersJSON Schema
NameRequiredDescriptionDefault
messageYesNotification content
titleNoNotification title
subtitleNoNotification subtitle
dataNoExtended data, json string. ```json { "image": "http://a.com/photo.jpg", "video": "http://a.com/video.mp4", "audio": "http://a.com/audio.mp3", # ios only "actions": [ { "action": "YOUR_ACTION_KEY", # Required. The identifier passed back in events. "title": "Do Something", "icon": "sfsymbols:bell.slash" # ios only }, { "action": "URL", # Must be set to URI if you plan to use a URI "title": "Open Url", # The action button title "url": "https://github.com" # URL to open when action is selected }, { "action": "REPLY", # When set to REPLY, you will be prompted for text to send with the event. "title": "Reply me", "behavior": "textInput" # Optional. Set to `textInput` to prompt for text to return with the event. This also occurs when setting the action to `REPLY`. } ] } ``` All fields in the extended data are optional. {}
urlNoOpening a URL when tapping on a notification
device_keyNoDevice key, Default to get from environment variables

TDQS

C2.8/5.0
Behavior2/5

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

With no annotations, the description bears full responsibility for behavioral disclosure. It fails to mention any traits such as asynchronicity, error handling, or network requirements. The only behavior implied is sending, but no side effects or success indicators.

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 concise (one sentence), but it sacrifices informativeness. It arguably could be expanded to include key capabilities without losing conciseness. It is not verbose, but it is under-specific.

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 tool's complexity (6 parameters, including a complex JSON field) and the lack of an output schema, the description is too sparse. It does not explain what happens after sending (e.g., success response, errors) or provide context like whether the device key is required.

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 input schema has 100% description coverage, including detailed examples for the 'data' field. The tool description adds no additional parameter meaning, so the baseline of 3 is appropriate. It does not compensate for any missing schema details.

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 (send a notification) and the target (Home Assistant Mobile APP), which differentiates it from sibling notification tools targeting other platforms. However, it does not elaborate on the capabilities like rich content (images, actions) hinted in the schema.

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 usage guidelines are provided. The description does not specify when to use this tool over alternatives (e.g., bark, tg_send_message), nor does it mention any prerequisites or limitations.

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

lark_send_text飞书/Lark机器人-发送文本消息A

飞书/Lark群机器人发送文本或Markdown消息

ParametersJSON Schema
NameRequiredDescriptionDefault
textYes消息内容
msgtypeNo内容类型,仅支持: text/markdownmarkdown
bot_keyNo飞书/Lark机器人key,uuid格式,默认从环境变量获取
is_larkNo根据用户描述识别 0:飞书 1:Lark

TDQS

A3.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 must disclose behavioral traits. It only states the basic function and does not mention authentication requirements, failure modes, or any side effects. The bot_key parameter hints at a key but is not elaborated.

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 a single sentence, concise and front-loaded. It is appropriate for a simple tool, though it could be slightly more informative 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?

Given no output schema and no annotations, the description lacks completeness. It does not explain return values, error handling, or behavior when parameters are missing. For a sending tool with 4 parameters, 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 explains all parameters. The description adds no further meaning, meeting the baseline of 3.

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

Purpose5/5

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

The description clearly states the tool sends text or Markdown messages to Lark group robots. The verb '发送' and resource '文本或Markdown消息' are specific, and it distinguishes from sibling tools that target different platforms.

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

Usage Guidelines4/5

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

The description and context of sibling tools make it clear when to use this tool (for sending to Lark). However, there is no explicit statement of when not to use it or alternatives, but the platform context is strong.

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

ntfy_send_notifyNtfy Push NotificationC

Push a notification via Ntfy

ParametersJSON Schema
NameRequiredDescriptionDefault
messageYesNotification message body; set to `triggered` if empty or not passed
titleNoNotification title
topicNoTarget topic name or URL
clickNoURL opened when notification is clicked
attachNoURL of an attachment
iconNoURL of notification icon
markdownNoSet to `true` if the message is Markdown-formatted
filenameNoFile name of the attachment
priorityNoMessage priority with 1=min, 3=default and 5=max
delayNoTimestamp or duration for delayed delivery. Example: 30min, 9am
actionsNoList of action buttons. The following actions are supported: - view: Opens a website or app when the action button is tapped - broadcast: Sends an Android broadcast intent when the action button is tapped (only supported on Android) - http: Sends HTTP POST/GET/PUT request when the action button is tapped ```json [ { "action": "view", "label": "Open portal", "url": "https://home.nest.com/", "clear": true }, { "action": "http", "label": "Turn down", "url": "https://api.nest.com/", "body": "{"temperature": 65}" }, { "action": "broadcast", "label": "Take picture", "extras": { "cmd": "pic", "camera": "front" } } ] ```

TDQS

C2.7/5.0
Behavior2/5

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

No behavioral traits beyond the action are disclosed. Since no annotations are provided, the description should cover aspects like authentication, delivery guarantees, or side effects, but it does not. The agent has no insight into potential behaviors.

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

Conciseness2/5

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

The description is extremely concise but at the expense of completeness. It is a single sentence that lacks structure and does not front-load critical information such as return values or usage context, making it less helpful than it could be.

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 tool has 11 parameters, no output schema, and no annotations, the description is severely incomplete. It omits return format, failure modes, and any context for using the various parameters, leaving the agent without sufficient guidance.

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 coverage is 100%, so all parameters are already described in the input schema. The description adds no additional meaning, meeting the baseline of 3.

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 'Push a notification via Ntfy' clearly identifies the action and service, making the tool's purpose understandable despite its brevity. While it does not differentiate from siblings, the specific reference to Ntfy provides enough context for basic purpose clarity.

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 usage guidelines are provided. The description fails to specify when to use this tool over sibling notification tools (e.g., bark_send_notify, tg_send_message), nor does it mention prerequisites or context for use.

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

pushplus_send_msgPushPlus推送消息C

通过PushPlus(推送加)推送消息

ParametersJSON Schema
NameRequiredDescriptionDefault
contentYes消息内容
titleNo消息标题
tokenNo用户token,默认从环境变量获取
templateNo消息内容格式: `html`(默认)/`txt`/`markdown`
channelNo发送渠道: `wechat`(默认)/`webhook`/`mail`

TDQS

C2.9/5.0
Behavior2/5

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

No annotations are present, and the description fails to disclose any behavioral traits such as rate limits, error handling, permissions, or side effects. The description only restates the action without 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 extremely concise at one sentence, which is appropriate for a simple tool. However, it sacrifices completeness for brevity, but conciseness alone is well-achieved.

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 absence of annotations and output schema, and the presence of 5 parameters and many siblings, the description is insufficient. It lacks context on return values, errors, and integration nuances, leaving the agent underinformed.

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 input schema already provides 100% coverage with descriptions for each parameter. The description adds no additional semantic value beyond what the schema states, meeting the baseline.

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 (push/send) and the resource (PushPlus platform). However, it does not differentiate from other notification sibling tools like bark_send_notify or lark_send_text, but the basic purpose is evident.

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, nor any exclusions or prerequisites. With many sibling notification tools, the lack of usage context reduces effectiveness.

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

text_to_sound文本转音频B

将一段文本转成mp3音频链接

ParametersJSON Schema
NameRequiredDescriptionDefault
textYes文本内容
langNo目标语言,支持: en/zh/cte(粤语)/ara/de/fra/kor/pt/ru/spa/th, 建议根据文本内容选择en
speedNo语速,默认7

TDQS

B3.2/5.0
Behavior2/5

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

No annotations provided, so description bears full burden. Only states conversion without disclosing side effects, auth needs, rate limits, or behavior for edge cases (e.g., long text, unsupported lang). Missing behavioral context.

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

Conciseness5/5

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

Single sentence, no wasted words. Front-loaded with action and result. Appropriate length for the tool's simplicity.

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?

With no output schema, the description fails to explain the return value (mp3 link format). No mention of input constraints (max text length) or processing details. Sibling tools are different, so uniqueness is clear but completeness is lacking.

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 coverage is 100% with descriptions for each parameter. The tool description does not add new meaning beyond the schema. Baseline 3 is appropriate.

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

Purpose5/5

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

Description clearly states 'convert text to mp3 audio link', specifying verb (convert) and resource (mp3 audio link). It distinguishes from siblings which are all send/notification tools, not conversion.

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 vs alternatives. Does not mention prerequisites, when-not-to-use, or related tools (e.g., if you need to send the audio, you might combine with a send tool). Only the lang parameter gives a mild suggestion.

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

tg_send_audioTelegram send audioC

Send audio via telegram bot

ParametersJSON Schema
NameRequiredDescriptionDefault
audioYesAudio URL or base64 data URI (e.g., data:audio/wav;base64,...
chat_idNoTelegram chat id, Default to get from environment variables
captionNoAudio caption, 0-1024 characters after entities parsing
parse_modeNoMode for parsing entities in the caption. [text/MarkdownV2]
reply_to_message_idNoIdentifier of the message that will be replied to

TDQS

C2.3/5.0
Behavior1/5

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

No annotations are provided, and the description adds no behavioral details (e.g., file size limits, format requirements, authentication). The tool's behavior is opaque beyond what the name implies.

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 a single sentence, which is concise, but it lacks structure and fails to elaborate on key aspects. It is minimally adequate.

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?

With 5 parameters, no output schema, and no annotations, the description is incomplete. It does not explain how to provide the audio or the default behavior for chat_id.

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 coverage is 100%, so parameters are documented. The description adds no additional meaning beyond the schema, leaving baseline at 3.

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?

Description states 'Send audio via telegram bot', which is a verb+resource, but it does not differentiate from siblings like tg_send_file which could also send audio files. The purpose is clear but could be more specific.

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 tg_send_file or tg_send_voice. The description provides no context for selection.

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

tg_send_fileTelegram send fileA

Send general files via telegram bot

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYesFile URL
chat_idNoTelegram chat id, Default to get from environment variables
captionNoFile caption, 0-1024 characters after entities parsing
parse_modeNoMode for parsing entities in the caption. [text/MarkdownV2]
reply_to_message_idNoIdentifier of the message that will be replied to

TDQS

A3.5/5.0
Behavior2/5

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

No annotations provided, so the description carries full burden. It only states 'send' without disclosing file size limits, supported formats, required authentication, or whether the operation is destructive. This is insufficient for an agent to understand behavioral traits.

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

Conciseness5/5

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

Single sentence, front-loaded with the action, no wasted words. Extremely concise and to the point.

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?

With no output schema and no annotations, the description is adequate for differentiating from siblings but lacks details on return values, error handling, or URL formatting requirements. It covers the basics but has clear 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?

Input schema has 100% coverage with individual parameter descriptions. The description adds no extra meaning beyond the schema, providing a baseline 3. It does not explain what 'general files' entails or how parameters interact.

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

Purpose5/5

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

The description 'Send general files via telegram bot' clearly states the action (send), resource (general files), and channel (telegram bot). It effectively distinguishes from siblings like tg_send_photo (specific to photos) and tg_send_message (text messages).

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

Usage Guidelines3/5

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

No explicit guidance on when to use this tool versus alternatives. While siblings suggest it's for files not covered by specialized tools (audio, photo, video, message), the description does not state this directly or provide when-not-to-use scenarios.

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

tg_send_messageTelegram send textB

Send text or markdown message via telegram bot

ParametersJSON Schema
NameRequiredDescriptionDefault
textYesText of the message to be sent, 1-4096 characters after entities parsing
chat_idNoTelegram chat id, Default to get from environment variables
parse_modeNoMode for parsing entities in the message text. [text/MarkdownV2]
reply_to_message_idNoIdentifier of the message that will be replied to

TDQS

B3.2/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 only states the action (sending a message) but does not mention side effects, rate limits, error handling, or any safety considerations. The lack of detail leaves the agent unaware of potential issues.

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 a single sentence, concise and front-loaded with the purpose. While efficient, it could benefit from a slightly more structured format (e.g., listing supported formats). Nonetheless, it avoids unnecessary verbosity.

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?

Given 4 parameters with full schema coverage and no output schema, the description is somewhat complete but lacks contextual details such as dependency on environment variables or authentication requirements. It does not mention that the chat_id can default from environment, which is a key context for the 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 baseline is 3. The description adds no extra meaning beyond what the schema already provides for each parameter. It does not synthesize or contextualize the parameters in the broader task.

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

Purpose5/5

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

The description clearly states it sends text or markdown messages via a Telegram bot, using a specific verb ('send') and resource ('telegram bot'). It distinguishes itself from sibling tools like tg_send_audio, tg_send_photo, etc., which handle different media types.

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, nor any prerequisites or conditions. For example, it doesn't mention that a bot token must be configured or that the tool relies on environment variables for default chat_id.

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

tg_send_photoTelegram send photoB

Send photo via telegram bot

ParametersJSON Schema
NameRequiredDescriptionDefault
photoYesPhoto URL or base64 data URI (e.g., data:image/png;base64,...
chat_idNoTelegram chat id, Default to get from environment variables
captionNoPhoto caption, 0-1024 characters after entities parsing
parse_modeNoMode for parsing entities in the caption. [text/MarkdownV2]
reply_to_message_idNoIdentifier of the message that will be replied to

TDQS

B3/5.0
Behavior2/5

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

No annotations provided; the description does not disclose behavioral traits like size limits, error handling, or permissions required. It only states the basic action, leaving the agent underinformed.

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 very concise at one sentence, but it lacks detail. It is not verbose, but the brevity sacrifices informational value.

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 output schema and no annotations, the description is incomplete. It does not explain return values, error states, or usage patterns, making it insufficient for a tool with 5 parameters.

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 coverage is 100% with descriptions for all 5 parameters. The description adds no additional parameter context, but the schema already provides adequate meaning, achieving the baseline of 3.

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

Purpose5/5

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

Description clearly states 'Send photo via telegram bot', specifying the action (send) and resource (photo). It distinguishes from sibling tools like tg_send_message, tg_send_audio, etc., which handle other media types.

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 tg_send_file or tg_send_video. Does not mention prerequisites, such as needing a bot token or chat_id, which is only partially covered in the schema.

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

tg_send_videoTelegram send videoC

Send video via telegram bot

ParametersJSON Schema
NameRequiredDescriptionDefault
videoYesVideo URL or base64 data URI (e.g., data:video/mp4;base64,...
coverNoCover for the video in the message. Optional
chat_idNoTelegram chat id, Default to get from environment variables
captionNoVideo caption, 0-1024 characters after entities parsing
parse_modeNoMode for parsing entities in the caption. [text/MarkdownV2]
reply_to_message_idNoIdentifier of the message that will be replied to

TDQS

C2.9/5.0
Behavior1/5

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

No annotations provided, and description gives no behavioral details beyond 'send video' - no mention of authentication, rate limits, or side effects. Minimal transparency 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.

Conciseness5/5

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

Single sentence of 5 words - extremely concise, no redundancy, appropriately front-loaded.

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

Completeness1/5

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

Despite 6 parameters and no output schema/annotations, description only says 'send video'. Lacks details on return values, prerequisites (bot token), constraints (file size limits), or error conditions. Inadequate for a tool with this complexity.

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 parameters are well documented. Description adds no extra meaning beyond schema, but baseline 3 is appropriate.

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

Purpose5/5

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

Description clearly states 'Send video via telegram bot' - specific verb and resource, and distinguishes from sibling tools like tg_send_audio and tg_send_photo.

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 vs alternatives (e.g., tg_send_photo, tg_send_file). No exclusion criteria or context provided.

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

wework_app_send_file企业微信应用号-发送文件消息C

通过企业微信应用号发送发送文件消息

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYes文件URL
touserNo接收消息的成员ID,多个用`|`分隔,为`@all`时向该企业应用全部成员发送,默认从环境变量获取

TDQS

C2.9/5.0
Behavior2/5

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

With no annotations, the description should disclose behavioral traits such as file size limits, supported formats, or side effects. It merely says 'send file message' without any behavioral details.

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 a single sentence, very concise and front-loaded with the action. However, it lacks structure (e.g., bullet points) and contains a typo, but overall efficient.

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 output schema, the description should at least hint at return values or confirmation. It does not, leaving the agent without knowledge of success/failure behavior. For a mutation tool, this is insufficient.

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 description adds no new meaning beyond the schema. The short description does not enhance understanding of parameters, but it does not contradict the schema either.

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 it sends a file message via WeChat Work app, distinguishing it from sibling tools for other message types (text, image, news, etc.) and other platforms. However, there is a minor typo ('发送发送') and no further detail on file capabilities.

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 vs. other WeChat Work send tools or alternatives like 'wework_app_send_text'. Prerequisites like authentication or app ID are not mentioned.

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

wework_app_send_image企业微信应用号-发送图片消息C

通过企业微信应用号发送发送图片消息

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYes图片URL
touserNo接收消息的成员ID,多个用`|`分隔,为`@all`时向该企业应用全部成员发送,默认从环境变量获取

TDQS

C2.5/5.0
Behavior2/5

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

With no annotations, the description carries the full burden. It only says '发送图片消息' but does not disclose any behavioral traits like image format requirements, size limits, or whether the operation is destructive. This is insufficient for an agent to understand 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 very short (one line) but contains a typo (duplicate '发送'). While concise, the typo reduces clarity. It is not front-loaded with key information.

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 tool has 2 parameters, no output schema, and no annotations, the description is minimal. It does not explain return values, error conditions, or the effect of the 'touser' parameter default behavior. Incomplete for practical 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 both parameters. The description adds no additional meaning beyond the schema. Baseline 3 is appropriate as the description does not enhance parameter understanding.

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 '通过企业微信应用号发送发送图片消息' which indicates sending image messages via WeChat Work application. However, the duplicate '发送' and lack of distinction from siblings like 'wework_send_image' or 'wework_app_send_file' make it vague. The purpose is clear but not specific enough to differentiate.

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 such as 'wework_send_image' or other messaging tools. No context about when it is appropriate or when not to use it.

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

wework_app_send_news企业微信应用号-发送图文卡片消息C

通过企业微信应用号发送图文卡片消息

ParametersJSON Schema
NameRequiredDescriptionDefault
titleYes标题,不超过128个字符
urlYes跳转链接,最长2048字节,必须包含协议头(http/https)
picurlNo图片URL
descriptionNo描述,不超过512个字符
touserNo接收消息的成员ID,多个用`|`分隔,为`@all`时向该企业应用全部成员发送,默认从环境变量获取

TDQS

C2.9/5.0
Behavior2/5

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

With no annotations, the description carries full burden but only states 'send'. It does not disclose behavioral traits such as authentication requirements, rate limits, side effects, or failure modes. This is insufficient for an agent to assess risks.

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 a single concise sentence with no wasted words. However, it is extremely brief and could benefit from front-loading key details. It is not verbose, but may be underspecified for a tool with 5 parameters.

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 minimal description, the tool lacks contextual completeness. Important aspects like expected behavior, constraints, or prerequisites are missing, leaving the agent without enough information to use it reliably.

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 input schema has 100% coverage with descriptions for all parameters. The tool description adds no additional meaning beyond that. Baseline 3 is appropriate as the schema already provides adequate semantics.

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 sends a graphic card message via WeWork app account. It is specific about the action and resource, but does not explicitly differentiate from sibling tools like wework_app_send_text or wework_app_send_image, though the name implies the content 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?

No guidance is provided on when to use this tool versus alternatives. The description lacks context about suitable scenarios, prerequisites, or exclusion criteria, making it hard for an agent to decide when it is appropriate.

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

wework_app_send_text企业微信应用号-发送文本消息B

通过企业微信应用号发送文本或Markdown消息

ParametersJSON Schema
NameRequiredDescriptionDefault
textYes消息内容,最长不超过2048个字节
msgtypeNo内容类型,仅支持: text/markdowntext
touserNo接收消息的成员ID,多个用`|`分隔,为`@all`时向该企业应用全部成员发送,默认从环境变量获取

TDQS

B3.2/5.0
Behavior2/5

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

No annotations are provided, so the description must cover behavioral traits. However, it only states the basic function and does not disclose authentication needs, rate limits, error handling, or any side effects. Agent cannot infer safety or operational constraints.

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 a single short sentence, concise and without filler. However, it is underspecified, sacrificing clarity for brevity. It earns a 4 for being efficient but not maximal.

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 simple tool with 3 parameters, no output schema, and no annotations, the description is minimally complete. It conveys the core functionality but omits contextual details like recipient resolution or message length limits (which are in schema but not explained). Adequate but lacks depth.

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. The description adds no additional meaning beyond what is in the schema, meeting the baseline expectation.

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

Purpose5/5

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

The description clearly states the tool sends 'text or Markdown messages' via '企业微信应用号' (WeChat Work application), specifying the resource and action. This distinguishes it from sibling tools that send to different channels (e.g., ding, lark) or other message types (e.g., file, image) for the same channel.

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 wework_send_text or other notification tools. There is no mention of prerequisites, context, or exclusions, making it hard for an AI agent to decide correctly.

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

wework_app_send_video企业微信应用号-发送视频消息C

通过企业微信应用号发送发送视频消息

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYes视频URL
touserNo接收消息的成员ID,多个用`|`分隔,为`@all`时向该企业应用全部成员发送,默认从环境变量获取

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 must carry the full burden of behavioral disclosure. It only states the action (sending a video) without mentioning permissions, rate limits, or expected results (e.g., success/error handling). The typo also reduces clarity.

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 a single sentence but contains a repeated word ('发送发送'), indicating poor editing. It is concise but front-loads information poorly due to the 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 the tool's simplicity (2 parameters, no output schema), the description is insufficient. It does not explain that 'touser' accepts multiple IDs or '@all', nor does it mention the return value (if any). The sibling context suggests many similar tools, so 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?

The input schema covers 100% of parameters with descriptions, so the baseline is 3. The description adds no extra meaning beyond the schema; it does not explain the relationship between 'touser' and 'url' or provide usage examples.

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 title and description clearly state the tool sends video messages via WeChat Work app. However, the description merely restates the title with a typo (double '发送') and does not differentiate from sibling tools like 'wework_app_send_image' or 'wework_app_send_file', though the resource type (video) is unique.

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, such as 'wework_send_video' or other messaging tools. No prerequisites or context for selection are mentioned.

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

wework_app_send_voice企业微信应用号-发送语音消息C

通过企业微信应用号发送发送语音消息

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYes语音URL
touserNo接收消息的成员ID,多个用`|`分隔,为`@all`时向该企业应用全部成员发送,默认从环境变量获取

TDQS

C2.9/5.0
Behavior2/5

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

No annotations are present, so the description must disclose behavioral traits. It only states the basic action without revealing permissions, side effects, return values, or error behavior. For a mutating tool like this, more context is needed.

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 a single sentence, which is concise and front-loaded, but it contains a duplicated word ('发送发送') which slightly reduces clarity. Nevertheless, it is efficient and easy to parse.

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 output schema and no annotations, the description lacks important context such as supported voice formats, message size limits, or confirmation of sending. For a messaging tool, this is insufficient for full understanding.

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?

Both parameters have descriptions in the schema (100% coverage), and the tool description does not add additional semantic value beyond what is in the schema. The baseline 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 tool sends a voice message via WeCom application account, distinguishing it from siblings like text, image, and file sending tools. However, it has a minor duplicate word '发送' and could be more specific about voice message types.

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 other related tools (e.g., wework_app_send_audio is absent but wework_app_send_file, image, etc. exist). The description does not mention prerequisites, alternatives, or conditions for use.

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

wework_send_image企业微信群机器人-发送图片消息C

通过企业微信群机器人发送图片消息

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYes图片url
bot_keyNo企业微信群机器人key,uuid格式,默认从环境变量获取

TDQS

C2.9/5.0
Behavior2/5

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

No annotations are provided, and the description only states the action without disclosing any behavioral traits such as authentication requirements, rate limits, or side effects. The agent receives no additional context beyond the basic function.

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 a single concise sentence that directly states the tool's purpose. It is appropriately brief with no extraneous content.

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?

Given the tool's simplicity (two parameters, no output schema, no nested objects), the description is minimally adequate. However, it lacks any behavioral context or return value information that could help the agent understand the outcome of the operation.

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 input schema has 100% description coverage for its two parameters, so the schema itself provides adequate meaning. The description adds no extra parameter information, meeting the baseline for complete 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 sends image messages via the WeWork group robot. However, it does not differentiate from the sibling tool 'wework_app_send_image', which also sends images but via the WeWork app.

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 other WeWork messaging tools (e.g., wework_send_text, wework_send_news). The description only implies usage for sending images.

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

wework_send_news企业微信群机器人-发送图文消息A

通过企业微信群机器人发送图文链接消息

ParametersJSON Schema
NameRequiredDescriptionDefault
titleYes标题,不超过128个字节
urlYes跳转链接,必填
picurlNo图片URL
descriptionNo描述,不超过512个字节
bot_keyNo企业微信群机器人key,uuid格式,默认从环境变量获取

TDQS

A3.7/5.0
Behavior3/5

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

No annotations provided, so description carries full burden. It discloses the action (send via bot) but omits details like rate limits, error handling, or role of bot_key. Adequate but minimal.

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

Conciseness5/5

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

Single sentence, no redundancy, front-loaded with key action. Efficient and clear.

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?

No output schema and no annotations; description only covers purpose. Lacks details on bot_key derivation, error responses, or usage constraints. Adequate for simple tool but not comprehensive.

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?

Input schema covers all 5 parameters with descriptions (100% coverage). Description adds no additional meaning beyond schema, baseline score of 3 applies.

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

Purpose5/5

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

Description clearly states the verb (发送/send), resource (企业微信群机器人/WeWork group robot), and message type (图文链接消息/image-text link message), differentiating it from siblings like wework_send_text and wework_send_image.

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

Usage Guidelines3/5

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

No explicit guidance on when to use this tool versus alternatives like wework_app_send_news or other messaging tools. Usage is implied by the description, but no when-not-to-use or context is provided.

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

wework_send_text企业微信群机器人-发送文本消息C

通过企业微信群机器人发送文本或Markdown消息

ParametersJSON Schema
NameRequiredDescriptionDefault
textYes消息内容,长度限制: (text: 2048个字节, markdown_v2: 4096个字节)
msgtypeNo内容类型,仅支持: text/markdown_v2text
bot_keyNo企业微信群机器人key,uuid格式,默认从环境变量获取

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 bears full responsibility. It mentions sending text/Markdown but omits details like rate limits, authentication (bot_key required but may fallback to env var), or message length constraints (partially covered in schema). The description is insufficient for full 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.

Conciseness4/5

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

The description is a single concise sentence with no wasted words. However, it could be slightly more informative 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 tool with three parameters and no output schema, the description is minimal. It does not explain the purpose of bot_key or msgtype defaults, nor how it differs from WeWork sibling tools (e.g., wework_send_news). More context is needed for an agent to use it correctly.

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 baseline is 3. The description does not add any parameter information beyond what is in the schema. The schema descriptions are adequate, but the description itself contributes nothing.

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 that the tool sends text or Markdown messages via the WeWork group robot. It distinguishes from sibling tools targeting other platforms (e.g., DingTalk, Lark), but does not explicitly differentiate from other WeWork-specific tools like wework_send_image.

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, nor does it mention prerequisites or exclusions. It only describes the basic function without context for selection.

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. 3 tool updatesv0.1.11
    • Changedtg_send_audio1 field changed
      • changedInput schema / properties / audio / description
        Previous value: -"Audio URL"New value: +"Audio URL or base64 data URI (e.g., data:audio/wav;base64,..."
    • Changedtg_send_photo1 field changed
      • changedInput schema / properties / photo / description
        Previous value: -"Photo URL"New value: +"Photo URL or base64 data URI (e.g., data:image/png;base64,..."
    • Changedtg_send_video1 field changed
      • changedInput schema / properties / video / description
        Previous value: -"Video URL"New value: +"Video URL or base64 data URI (e.g., data:video/mp4;base64,..."
  2. 13 tool updatesv1.0.0
    • Addedbark_send_notify
    • Addedding_send_text
    • Addedha_send_mobile
    • Addedlark_send_text
    • Addedntfy_send_notify
    • Addedpushplus_send_msg
    • Addedtext_to_sound
    • Removedtg_markdown_rule
    • Changedtg_send_audio1 field changed
      • addedInput schema / properties / reply_to_message_id
        Added value: +{
        +  "default": 0,
        +  "description": "Identifier of the message that will be replied to",
        +  "type": "integer"
        +}
    • Changedtg_send_file1 field changed
      • addedInput schema / properties / reply_to_message_id
        Added value: +{
        +  "default": 0,
        +  "description": "Identifier of the message that will be replied to",
        +  "type": "integer"
        +}
    • Changedtg_send_message1 field changed
      • addedInput schema / properties / reply_to_message_id
        Added value: +{
        +  "default": 0,
        +  "description": "Identifier of the message that will be replied to",
        +  "type": "integer"
        +}
    • Changedtg_send_photo1 field changed
      • addedInput schema / properties / reply_to_message_id
        Added value: +{
        +  "default": 0,
        +  "description": "Identifier of the message that will be replied to",
        +  "type": "integer"
        +}
    • Changedtg_send_video1 field changed
      • addedInput schema / properties / reply_to_message_id
        Added value: +{
        +  "default": 0,
        +  "description": "Identifier of the message that will be replied to",
        +  "type": "integer"
        +}
  3. 15 tool updates
    • First observedtg_markdown_rule
    • First observedtg_send_audio
    • First observedtg_send_file
    • First observedtg_send_message
    • First observedtg_send_photo
    • First observedtg_send_video
    • First observedwework_app_send_file
    • First observedwework_app_send_image
    • First observedwework_app_send_news
    • First observedwework_app_send_text
    • First observedwework_app_send_video
    • First observedwework_app_send_voice
    • First observedwework_send_image
    • First observedwework_send_news
    • First observedwework_send_text

TDQS

B3.2/5.0

Scored across 21 tools

Disambiguation5/5

Each tool is uniquely identified by its platform prefix and action, making it easy for an agent to distinguish between sending text via Telegram vs. WeWork. There is no overlap in purpose.

Naming Consistency4/5

Most tools follow a consistent 'platform_verb_object' pattern (e.g., tg_send_message, wework_send_text). The exceptions are 'text_to_sound' (no platform prefix and a different verb structure) and 'ha_send_mobile' (missing underscore).

Tool Count4/5

With 21 tools across 9 platforms, the count is high but justified by the variety of platforms and message types. Each tool serves a distinct purpose, though some platforms have only a single tool.

Completeness4/5

The server covers a broad range of notification platforms with essential message types (text, image, file, etc.). Minor gaps exist (e.g., no Telegram location or email), and 'text_to_sound' seems tangential, but core notification workflows are well-supported.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers