MCP Server for notify to weixin / telegram / bark / lark
This MCP server enables sending notifications and messages to multiple platforms through AI assistants.
Supported Platforms:
WeChat Work (企业微信): Send text/Markdown messages, images, and news articles via group bots; send text/Markdown, images, videos, voice messages, files, and news cards via application accounts to specific users or all members
Telegram Bot: Send text messages with Markdown formatting, photos, videos, audio files, and general files with captions; supports custom chat IDs, parse modes, and provides Markdown formatting rules for compatibility
DingTalk (钉钉): Send text/Markdown messages via group bot
Feishu/Lark (飞书): Send text/Markdown messages via group bot
Bark: Send push notifications to iOS devices
Ntfy: Send notifications via Ntfy service
PushPlus: Send messages via PushPlus service
Home Assistant: Send mobile notifications
Additional Features:
Convert text to MP3 audio links
Supports custom API endpoints, proxy URLs, and flexible configuration via environment variables or parameters
Enables sending messages and notifications to Telegram chats and channels through bot integration
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Server for notify to weixin / telegram / bark / larksend 'Meeting starts in 5 minutes' to our WeChat work group"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
💬 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
}
}
}快速开始
在线体验:
在线体验:
添加到 Cursor
添加到 VS Code
添加到 Cherry Studio
添加到 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: 企业微信所属的企业IDWEWORK_APP_SECRET: 企业微信应用的凭证密钥WEWORK_APP_AGENTID: 企业微信应用的ID,默认:1000002WEWORK_APP_TOUSER: 企业微信默认接收人ID,也可以在提示词指定,默认:@allWEWORK_BASE_URL: 企业微信API反代理地址,用于可信IP,默认:https://qyapi.weixin.qq.com
钉钉群机器人
DINGTALK_BOT_KEY: 钉钉群机器人access_tokenDINGTALK_BASE_URL: 钉钉API地址,默认:https://oapi.dingtalk.com
飞书/Lark群机器人
FEISHU_BOT_KEY: 飞书群机器人key,也可以在提示词指定FEISHU_BASE_URL: 飞书API地址,默认:https://open.feishu.cnLARK_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:8123HASS_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.appNTFY_DEFAULT_TOPIC: 默认Ntfy订阅主题,也可以在提示词指定NTFY_BASE_URL: Ntfy API地址,默认:https://ntfy.shPUSH_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音频链接
🔗 相关连接
大饼报告 - 基于此MCP实现的Telegram频道
Available Tools
21 toolsbark_send_notifyBark推送通知C
通过Bark推送通知
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | 推送内容 | |
| title | No | 推送标题 | |
| subtitle | No | 推送副标题 | |
| device_key | No | 设备key,默认从环境变量获取 | |
| url | No | 点击推送时,跳转的URL ,支持URL Scheme 和 Universal Link | |
| icon | No | 自定义图标URL | |
| level | No | 推送中断级别。critical: 重要警告, 在静音模式下也会响铃active:默认值,系统会立即亮屏显示通知timeSensitive:时效性通知,可在专注状态下显示通知。passive:仅将通知添加到通知列表,不会亮屏提醒。 | active |
| volume | No | 重要警告的通知音量(0-10),默认为5 |
TDQS
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.
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.
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.
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.
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.
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消息
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | 消息内容 | |
| title | No | 消息标题 | |
| msgtype | No | 内容类型,仅支持: text/markdown | markdown |
| bot_key | No | 钉钉群机器人access_token,默认从环境变量获取 |
TDQS
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.
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.
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.
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.
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.
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
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | Notification content | |
| title | No | Notification title | |
| subtitle | No | Notification subtitle | |
| data | No | Extended 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. | {} |
| url | No | Opening a URL when tapping on a notification | |
| device_key | No | Device key, Default to get from environment variables |
TDQS
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.
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.
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.
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.
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.
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消息
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | 消息内容 | |
| msgtype | No | 内容类型,仅支持: text/markdown | markdown |
| bot_key | No | 飞书/Lark机器人key,uuid格式,默认从环境变量获取 | |
| is_lark | No | 根据用户描述识别 0:飞书 1:Lark |
TDQS
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.
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.
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.
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.
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.
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
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | Notification message body; set to `triggered` if empty or not passed | |
| title | No | Notification title | |
| topic | No | Target topic name or URL | |
| click | No | URL opened when notification is clicked | |
| attach | No | URL of an attachment | |
| icon | No | URL of notification icon | |
| markdown | No | Set to `true` if the message is Markdown-formatted | |
| filename | No | File name of the attachment | |
| priority | No | Message priority with 1=min, 3=default and 5=max | |
| delay | No | Timestamp or duration for delayed delivery. Example: 30min, 9am | |
| actions | No | List 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
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.
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.
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.
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.
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.
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(推送加)推送消息
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | 消息内容 | |
| title | No | 消息标题 | |
| token | No | 用户token,默认从环境变量获取 | |
| template | No | 消息内容格式: `html`(默认)/`txt`/`markdown` | |
| channel | No | 发送渠道: `wechat`(默认)/`webhook`/`mail` |
TDQS
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.
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.
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.
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.
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.
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音频链接
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | 文本内容 | |
| lang | No | 目标语言,支持: en/zh/cte(粤语)/ara/de/fra/kor/pt/ru/spa/th, 建议根据文本内容选择 | en |
| speed | No | 语速,默认7 |
TDQS
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.
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.
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.
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.
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.
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
| Name | Required | Description | Default |
|---|---|---|---|
| audio | Yes | Audio URL or base64 data URI (e.g., data:audio/wav;base64,... | |
| chat_id | No | Telegram chat id, Default to get from environment variables | |
| caption | No | Audio caption, 0-1024 characters after entities parsing | |
| parse_mode | No | Mode for parsing entities in the caption. [text/MarkdownV2] | |
| reply_to_message_id | No | Identifier of the message that will be replied to |
TDQS
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.
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.
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.
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.
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.
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
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | File URL | |
| chat_id | No | Telegram chat id, Default to get from environment variables | |
| caption | No | File caption, 0-1024 characters after entities parsing | |
| parse_mode | No | Mode for parsing entities in the caption. [text/MarkdownV2] | |
| reply_to_message_id | No | Identifier of the message that will be replied to |
TDQS
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.
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.
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.
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.
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.
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
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Text of the message to be sent, 1-4096 characters after entities parsing | |
| chat_id | No | Telegram chat id, Default to get from environment variables | |
| parse_mode | No | Mode for parsing entities in the message text. [text/MarkdownV2] | |
| reply_to_message_id | No | Identifier of the message that will be replied to |
TDQS
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.
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.
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.
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.
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.
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
| Name | Required | Description | Default |
|---|---|---|---|
| photo | Yes | Photo URL or base64 data URI (e.g., data:image/png;base64,... | |
| chat_id | No | Telegram chat id, Default to get from environment variables | |
| caption | No | Photo caption, 0-1024 characters after entities parsing | |
| parse_mode | No | Mode for parsing entities in the caption. [text/MarkdownV2] | |
| reply_to_message_id | No | Identifier of the message that will be replied to |
TDQS
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.
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.
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.
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.
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.
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
| Name | Required | Description | Default |
|---|---|---|---|
| video | Yes | Video URL or base64 data URI (e.g., data:video/mp4;base64,... | |
| cover | No | Cover for the video in the message. Optional | |
| chat_id | No | Telegram chat id, Default to get from environment variables | |
| caption | No | Video caption, 0-1024 characters after entities parsing | |
| parse_mode | No | Mode for parsing entities in the caption. [text/MarkdownV2] | |
| reply_to_message_id | No | Identifier of the message that will be replied to |
TDQS
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.
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.
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.
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.
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.
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
通过企业微信应用号发送发送文件消息
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | 文件URL | |
| touser | No | 接收消息的成员ID,多个用`|`分隔,为`@all`时向该企业应用全部成员发送,默认从环境变量获取 |
TDQS
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.
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.
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.
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.
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.
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
通过企业微信应用号发送发送图片消息
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | 图片URL | |
| touser | No | 接收消息的成员ID,多个用`|`分隔,为`@all`时向该企业应用全部成员发送,默认从环境变量获取 |
TDQS
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.
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.
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.
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.
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.
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
通过企业微信应用号发送图文卡片消息
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | 标题,不超过128个字符 | |
| url | Yes | 跳转链接,最长2048字节,必须包含协议头(http/https) | |
| picurl | No | 图片URL | |
| description | No | 描述,不超过512个字符 | |
| touser | No | 接收消息的成员ID,多个用`|`分隔,为`@all`时向该企业应用全部成员发送,默认从环境变量获取 |
TDQS
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.
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.
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.
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.
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.
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消息
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | 消息内容,最长不超过2048个字节 | |
| msgtype | No | 内容类型,仅支持: text/markdown | text |
| touser | No | 接收消息的成员ID,多个用`|`分隔,为`@all`时向该企业应用全部成员发送,默认从环境变量获取 |
TDQS
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.
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.
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.
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.
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.
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
通过企业微信应用号发送发送视频消息
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | 视频URL | |
| touser | No | 接收消息的成员ID,多个用`|`分隔,为`@all`时向该企业应用全部成员发送,默认从环境变量获取 |
TDQS
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.
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.
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.
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.
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.
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
通过企业微信应用号发送发送语音消息
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | 语音URL | |
| touser | No | 接收消息的成员ID,多个用`|`分隔,为`@all`时向该企业应用全部成员发送,默认从环境变量获取 |
TDQS
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.
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.
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.
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.
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.
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
通过企业微信群机器人发送图片消息
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | 图片url | |
| bot_key | No | 企业微信群机器人key,uuid格式,默认从环境变量获取 |
TDQS
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.
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.
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.
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.
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.
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
通过企业微信群机器人发送图文链接消息
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | 标题,不超过128个字节 | |
| url | Yes | 跳转链接,必填 | |
| picurl | No | 图片URL | |
| description | No | 描述,不超过512个字节 | |
| bot_key | No | 企业微信群机器人key,uuid格式,默认从环境变量获取 |
TDQS
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.
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.
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.
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.
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.
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消息
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | 消息内容,长度限制: (text: 2048个字节, markdown_v2: 4096个字节) | |
| msgtype | No | 内容类型,仅支持: text/markdown_v2 | text |
| bot_key | No | 企业微信群机器人key,uuid格式,默认从环境变量获取 |
TDQS
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.
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.
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.
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.
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.
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.
3 tool updates
v0.1.11- Changed
tg_send_audio1 field changed- changed
Input schema / properties / audio / descriptionPrevious value: -"Audio URL"New value: +"Audio URL or base64 data URI (e.g., data:audio/wav;base64,..."
- Changed
tg_send_photo1 field changed- changed
Input schema / properties / photo / descriptionPrevious value: -"Photo URL"New value: +"Photo URL or base64 data URI (e.g., data:image/png;base64,..."
- Changed
tg_send_video1 field changed- changed
Input schema / properties / video / descriptionPrevious value: -"Video URL"New value: +"Video URL or base64 data URI (e.g., data:video/mp4;base64,..."
13 tool updates
v1.0.0- Added
bark_send_notify - Added
ding_send_text - Added
ha_send_mobile - Added
lark_send_text - Added
ntfy_send_notify - Added
pushplus_send_msg - Added
text_to_sound - Removed
tg_markdown_rule - Changed
tg_send_audio1 field changed- added
Input schema / properties / reply_to_message_idAdded value: +{ + "default": 0, + "description": "Identifier of the message that will be replied to", + "type": "integer" +}
- Changed
tg_send_file1 field changed- added
Input schema / properties / reply_to_message_idAdded value: +{ + "default": 0, + "description": "Identifier of the message that will be replied to", + "type": "integer" +}
- Changed
tg_send_message1 field changed- added
Input schema / properties / reply_to_message_idAdded value: +{ + "default": 0, + "description": "Identifier of the message that will be replied to", + "type": "integer" +}
- Changed
tg_send_photo1 field changed- added
Input schema / properties / reply_to_message_idAdded value: +{ + "default": 0, + "description": "Identifier of the message that will be replied to", + "type": "integer" +}
- Changed
tg_send_video1 field changed- added
Input schema / properties / reply_to_message_idAdded value: +{ + "default": 0, + "description": "Identifier of the message that will be replied to", + "type": "integer" +}
15 tool updates
- First observed
tg_markdown_rule - First observed
tg_send_audio - First observed
tg_send_file - First observed
tg_send_message - First observed
tg_send_photo - First observed
tg_send_video - First observed
wework_app_send_file - First observed
wework_app_send_image - First observed
wework_app_send_news - First observed
wework_app_send_text - First observed
wework_app_send_video - First observed
wework_app_send_voice - First observed
wework_send_image - First observed
wework_send_news - First observed
wework_send_text
TDQS
Scored across 21 tools
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.
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).
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.
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
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
MCP server wrapping the Tesla Fleet API and TeslaMate API
MCP server for GLM chat completions using Zhipu AI models via AceDataCloud
MCP server for Qwen Image 3 AI image generation
Related MCP Servers
- AlicenseCqualityDmaintenanceMCP Server for send text/markdown message via dingding (aka dingtalk) group custom robot21712MIT
- AlicenseNot gradedqualityDmaintenanceThe MCP server that keeps you informed by sending the notification on phone using ntfy.sh57344Apache 2.0
- MIT
- AlicenseNot gradedqualityCmaintenanceFree self-hosted WeChat push notification service with a standard MCP Server, enabling message sending via Webhook or MCP tools.GPL 3.0