Skip to main content
Glama

sau-mcp

基于 social-auto-uploadsau CLI,封装成 MCP 服务,供 Cursor 等 AI 客户端调用。

调用方法与目录说明 → docs/MCP_API.md

支持:抖音 / 快手 / 小红书 / Bilibili 的 Cookie 校验与视频(图文)发布。不实现浏览器自动化本身,只做薄封装。

前置条件

  1. 本机已安装并可运行 social-auto-upload(见上游文档)。

  2. 在真实终端登录一次(不要走 MCP):

sau douyin login --account <account>
sau douyin check --account <account>

Related MCP server: rednote-analyzer-mcp

安装 sau-mcp

cd <SAU_MCP_ROOT>
python -m venv .venv
.venv\Scripts\activate
python -m pip install -e .

若已安装 uv,也可用 uv venv + uv pip install -e .

环境变量

变量

说明

SAU_CMD

sau 可执行文件路径(已在 PATH 时可省略)

SAU_CWD

social-auto-upload 仓库根目录

SAU_TIMEOUT

子进程超时秒数(默认 600

复制 .env.example,按本机路径填写。不要把真实路径或账号名提交进仓库。

本地运行(stdio)

$env:SAU_CWD="<SAU_ROOT>"
$env:SAU_CMD="<SAU_ROOT>/.venv/Scripts/sau.exe"
python -m sau_mcp.server

Cursor MCP 配置

参考 cursor-mcp.example.json,把占位符换成你的本机路径,再合并到 Cursor 的 MCP 设置或项目 .cursor/mcp.json

保存后重启 Cursor / 刷新 MCP。

MCP 工具

工具

作用

sau_health

检查 sau --help 与环境路径

douyin_check

抖音 Cookie 是否有效

douyin_upload_video

发布抖音视频

douyin_upload_note

发布抖音图文

kuaishou_* / xiaohongshu_* / bilibili_*

其他平台

登录(扫码 / 短信)通过 MCP 暴露,需在本机终端执行。

对接 n8n

n8n 建议用 Execute Command 直接调 sau;MCP 面向 AI 客户端。

sau douyin upload-video --account <account> --file <VIDEO_PATH> --title "<title>"

说明

  • 上传在 MCP 所在机器上跑浏览器自动化。

  • Cookie 会过期,发布前先 douyin_check

  • 属于模拟客户端发布,存在平台风控风险,请自行评估。

Available Tools

10 tools
bilibili_checkB

Check whether a Bilibili account cookie is valid.

ParametersJSON Schema
NameRequiredDescriptionDefault
accountYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior2/5

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

Without annotations, the description must carry the full burden of behavioral disclosure, but it only states what the tool does. It does not reveal whether the operation is read-only, whether network calls are made, what side effects might occur, or what the output structure looks like despite having an output schema.

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?

The description is a single sentence that efficiently conveys the core purpose with no redundant words. It is front-loaded and appropriately sized for a simple one-parameter tool.

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 lack of annotations and sparse schema (0% description coverage), the description leaves significant gaps: no usage guidelines, no behavioral disclosures, and no parameter explanation. The output schema is present but not described in text, so the agent lacks crucial operational context for a complete understanding.

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

Parameters2/5

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

The schema provides only a parameter named 'account' with type string and no description; the description also does not explicitly define the parameter. However, the tool's description hints that 'account' refers to the Bilibili cookie, giving slight semantic context, but it does not clarify expected format or examples.

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 function with a specific verb ('Check') and resource ('a Bilibili account cookie is valid'), distinguishing it from sibling tools that check other platforms or upload content. It uniquely identifies the Bilibili platform and the validity-check intent.

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 offers no guidance on when to use this tool versus alternatives like kuaishou_check or douyin_check. It does not mention prerequisites, scenarios, or exclusions, leaving the agent without context for tool selection beyond the tool's name.

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

bilibili_upload_videoC

Upload and publish a Bilibili video via sau CLI.

ParametersJSON Schema
NameRequiredDescriptionDefault
tidNo
descNo
fileYes
tagsNo
titleYes
accountYes
headlessNodefault
scheduleNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

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 must carry the full burden. It only states the action and the CLI ('sau CLI'), without disclosing side effects, authentication requirements, upload behavior, scheduling, headless modes, failure modes, or return values. This is minimal transparency for a mutating tool.

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

Conciseness4/5

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

The description is a single, clear sentence with no redundant words. It is front-loaded and easy to parse. While brief, it earns its place by stating the tool's purpose without fluff.

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?

For an 8-parameter upload tool with no annotations, the description is severely incomplete. It provides no context about required arguments, optional settings, scheduling, headless behavior, or prerequisites. Even with an output schema present, the description fails to convey essential usage context for successful invocation.

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

Parameters1/5

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

Schema description coverage is 0%, and the description adds no information about any of the 8 parameters. It does not explain the meaning of 'account', 'file', 'title', 'tid', 'desc', 'tags', 'headless', or 'schedule', leaving the agent to rely solely on parameter names and defaults.

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 uses specific verb phrases 'Upload and publish' and names the resource 'a Bilibili video' via 'sau CLI', clearly identifying the tool's action and scope. It distinguishes itself from sibling tools like bilibili_check and other platform uploaders by naming Bilibili and the upload/publish action.

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?

The description implies usage: when you need to upload/publish a Bilibili video. However, it provides no explicit guidance on when to use this tool versus alternatives (e.g., bilibili_check for status checks) or any exclusions. The context is clear but not fully articulated.

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

douyin_checkA

Check whether a Douyin account cookie is valid (stdout: valid/invalid).

ParametersJSON Schema
NameRequiredDescriptionDefault
accountYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.2/5.0
Behavior3/5

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

No annotations are provided, so the description must carry the transparency burden. It discloses the output format ('stdout: valid/invalid'), which is valuable, but it does not explicitly state read-only behavior, network usage, or potential side effects. For a simple check tool, this is adequate but not exhaustive.

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?

The description is a single, front-loaded sentence that contains the essential purpose and output format without any filler. Every word contributes value.

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

Completeness4/5

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

For a simple one-parameter check tool, the description is nearly complete: it states the action, the resource, and the expected output. The output schema is present (even if not shown), and the description aligns with it. Minor gaps exist, such as not describing error behavior, but the tool's simplicity mitigates this.

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

Parameters4/5

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

The schema only provides a bare string parameter named 'account' with 0% description coverage. The description adds critical meaning by specifying it is a 'Douyin account cookie', clarifying that the parameter is the cookie string itself, not just an account name.

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 specifies the action ('Check'), the target resource ('Douyin account cookie'), and the outcome ('valid/invalid'). It distinguishes from sibling tools by explicitly naming the platform and the operation type, unlike upload or other platform checks.

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 clearly implies usage for validating a Douyin cookie, which is a distinct context from sibling checks for other platforms. No explicit alternatives are named, but the platform-specific purpose makes it unambiguous when to use this tool.

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

douyin_upload_noteC

Upload and publish a Douyin image note via sau CLI.

ParametersJSON Schema
NameRequiredDescriptionDefault
noteNo
tagsNo
titleYes
imagesYes
accountYes
headlessNodefault
scheduleNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.7/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 for behavioral disclosure. It only states 'upload and publish' which implies mutation but fails to mention authentication requirements, rate limits, or consequences of publishing. This is insufficient for a publishing tool.

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

Conciseness4/5

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

The description is a single concise sentence with no fluff, front-loading the primary purpose. While it's short, it earns each word for stating the core action, though it lacks detail.

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?

Given the tool's complexity (7 parameters), lack of annotations, and 0% schema description coverage, the description is far from complete. It only addresses purpose, not usage details, parameter explanations, or behavioral outcomes, making it inadequate for an agent to invoke the tool correctly.

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

Parameters1/5

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

Schema description coverage is 0%, and the description mentions no parameters. With 7 parameters including account, images, title, tags, headless, and schedule, the description provides zero semantic guidance beyond the schema names, which is inadequate.

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 explicitly states the action (upload and publish), the target platform (Douyin), the content type (image note), and the method (sau CLI). It clearly differentiates from sibling tools like douyin_upload_video by specifying 'image note'.

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 alternatives like douyin_upload_video. The description implies usage for image notes but does not mention exclusions, prerequisites, or alternative scenarios.

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

douyin_upload_videoC

Upload and publish a Douyin video via sau CLI.

ParametersJSON Schema
NameRequiredDescriptionDefault
descNo
fileYes
tagsNo
titleYes
accountYes
headlessNodefault
scheduleNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.3/5.0
Behavior1/5

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

With no annotations available, the description carries the full burden of behavioral disclosure. It only states the operation itself and provides no information about side effects (e.g., publishing publicly), required authentication, rate limits, or potential failures.

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 under-specified, consisting of a single generic sentence that adds little beyond the tool's name. While brief, it fails to include essential context expected for a tool with 7 parameters, making it incomplete rather than concise.

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?

Given the tool's complexity (7 parameters), no annotations, no parameter descriptions, and no usage context, the description is severely incomplete. It does not mention what 'sau CLI' entails, how the upload behaves, or what the output schema contains.

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

Parameters1/5

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

Schema description coverage is 0% and the description offers no explanation of parameters such as account, file, title, tags, headless, or schedule. The agent receives no additional meaning beyond the raw property names.

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 action (upload and publish), the resource (a Douyin video), and the mechanism (via sau CLI). It distinguishes itself from sibling tools like douyin_upload_note by specifying 'video' as the target.

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 such as douyin_upload_note or other platform uploaders. The description lacks any context about prerequisites, conditions, or exclusions.

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

kuaishou_checkB

Check whether a Kuaishou account cookie is valid.

ParametersJSON Schema
NameRequiredDescriptionDefault
accountYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.4/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. It states the core behavior (checking cookie validity) but does not disclose what constitutes 'valid', whether it makes a network request, what error conditions exist, or what side effects (e.g., session refresh) might occur. This is thin for a tool with no annotation support.

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?

The description is a single concise, front-loaded sentence that directly states the tool's purpose. Every word earns its place with no filler or redundancy; it is appropriately minimal for such a simple tool.

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 (one parameter) and the presence of an output schema (which presumably defines return values), the description covers the primary purpose. However, it lacks critical contextual details such as behavioral prerequisites, response format specifics, or failure modes. The absence of any annotation makes it only minimally complete.

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

Parameters2/5

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

The input schema has a single 'account' parameter with no description, and schema description coverage is 0%. The description mentions 'Kuaishou account cookie' but does not explicitly define whether 'account' refers to the cookie string itself, an account ID, or a credential object. Since the description does not clarify the parameter semantics, agents must rely on inference, which is risky.

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 specifies the verb 'Check', the resource ('Kuaishou account cookie'), and the intended outcome ('is valid'). It is unambiguous and distinguishes itself from sibling check tools for other platforms (xiaohongshu, bilibili, douyin) by naming the specific platform.

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?

The description implies the tool is used to validate a Kuaishou cookie, which is clear enough for the main use case. However, it does not explicitly state when to use it over alternatives (e.g., other check tools) or mention any preconditions like needing a logged-in account or cookie format. There is no exclusionary guidance.

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

kuaishou_upload_videoC

Upload and publish a Kuaishou video via sau CLI.

ParametersJSON Schema
NameRequiredDescriptionDefault
descNo
fileYes
tagsNo
titleYes
accountYes
headlessNodefault
scheduleNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

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 must carry the full burden of behavioral transparency. It only states 'upload and publish' and 'via sau CLI', offering no details on side effects, authentication requirements, or operational risks. The agent knows it is a write/publish operation but lacks deeper 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.

Conciseness4/5

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

The description is a single, direct sentence with no filler, which is concise. However, it is so brief that it sacrifices essential detail, making it minimally useful despite its efficiency.

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?

Given a tool with 7 parameters, 3 required, and a complex operation like uploading and publishing to a social platform, the one-sentence description is severely incomplete. It provides no guidance on parameter semantics, success/failure behavior, or return value, and the output schema does not compensate for the lack of explanatory context.

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

Parameters1/5

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

The schema has zero description coverage (0%), and the description adds no parameter-specific meaning. It does not explain what 'account', 'file', 'title', 'desc', 'tags', 'headless', or 'schedule' mean or how they should be used, leaving the agent with only parameter names to infer from.

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 action ('Upload and publish'), the target resource ('a Kuaishou video'), and the mechanism ('via sau CLI'). This is specific and distinct from sibling tools like douyin_upload_video or bilibili_upload_video by naming the platform.

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?

The description implies use for Kuaishou video uploads, which differentiates it from other platform upload tools, but it does not explicitly state when to use it versus alternatives or provide exclusions. The context from sibling names offers indirect guidance only.

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

sau_healthA

Check MCP wrapper config and whether sau --help runs.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.1/5.0
Behavior3/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. It mentions checking config and running a command, which implies a diagnostic read-only operation, but does not explicitly confirm safety, side effects, or return behavior.

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?

The description is a single, concise sentence with a clear action verb and objects. It is front-loaded and contains no filler.

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

Completeness5/5

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

For a zero-parameter diagnostic tool with an output schema, the description adequately covers the tool's behavior. It explains what is checked and the condition verified, which is complete for this simple tool.

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

Parameters4/5

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

The tool has zero parameters, and the schema is empty, providing complete coverage. No parameter explanation is needed, so the description does not need to compensate for schema gaps.

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 function: checking MCP wrapper config and verifying that `sau --help` runs. It distinguishes this tool from platform-specific upload/check siblings by focusing on the wrapper health check.

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. The intended use as a wrapper health check is implied, but the description does not state conditions for use or exclude other tools.

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

xiaohongshu_checkB

Check whether a Xiaohongshu account cookie is valid.

ParametersJSON Schema
NameRequiredDescriptionDefault
accountYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/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 disclosing behavioral traits. It only states that the tool 'checks' cookie validity, but does not explain whether this involves network requests, side effects, or what constitutes an invalid cookie. For a read-only check, this is minimal behavioral disclosure.

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?

The description is a single, clear sentence with no unnecessary words. It front-loads the action and resource, achieving maximum conciseness with zero filler.

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?

Despite having an output schema, the description lacks essential context such as parameter semantics and usage guidelines. It is minimal and leaves the user to infer the tool's role and input requirements. For a simple tool this is somewhat acceptable, but clear gaps remain.

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

Parameters1/5

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

Schema description coverage is 0%, and the description does not clarify the meaning or expected format of the 'account' parameter. The name 'account' could refer to an account ID or the cookie string itself, but the description does not disambiguate. This is a significant gap given the schema offers no help.

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 uses a specific verb ('Check') and identifies the exact resource ('Xiaohongshu account cookie') and the purpose ('is valid'). This clearly distinguishes the tool from sibling check tools like kuaishou_check and bilibili_check, 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 Guidelines3/5

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

The description implies the tool is used to validate a cookie before performing Xiaohongshu operations, but it does not explicitly state when to use it versus alternatives, nor does it mention any prerequisites. The context is implied rather than clearly stated.

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

xiaohongshu_upload_videoC

Upload and publish a Xiaohongshu video via sau CLI.

ParametersJSON Schema
NameRequiredDescriptionDefault
descNo
fileYes
tagsNo
titleYes
accountYes
headlessNodefault
scheduleNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.7/5.0
Behavior2/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure, but it only states the high-level action. It fails to disclose important traits such as authentication requirements, side effects of publishing, headless mode behavior, or scheduling semantics.

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 clear sentence and is front-loaded, containing no redundant filler. However, it is terse to the point of under-specification for a 7-parameter tool, which limits its usefulness but still maintains structural efficiency.

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?

For a tool with 7 parameters, 3 required, and an output schema, the one-sentence description is grossly incomplete. It omits parameter semantics, usage context, side effects, and any behavioral detail, making it inadequate for an agent to invoke correctly.

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

Parameters1/5

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

Schema description coverage is 0%, and the description compensates with zero parameter information. It does not clarify the meaning of required fields (account, file, title) or optional fields (desc, tags, headless, schedule), leaving the agent without any semantics beyond raw parameter names.

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 function with a specific verb ('Upload and publish') and resource ('Xiaohongshu video'), which distinguishes it from sibling check tools (e.g., xiaohongshu_check) and upload tools for other platforms (e.g., douyin_upload_video, bilibili_upload_video).

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 does not mention exclusions, prerequisites, or any comparison with other Xiaohongshu or upload tools, leaving the agent without context for tool 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. 10 tool updatesv0.1.0
    • First observedbilibili_check
    • First observedbilibili_upload_video
    • First observeddouyin_check
    • First observeddouyin_upload_note
    • First observeddouyin_upload_video
    • First observedkuaishou_check
    • First observedkuaishou_upload_video
    • First observedsau_health
    • First observedxiaohongshu_check
    • First observedxiaohongshu_upload_video

TDQS

B3.4/5.0

Scored across 10 tools

Disambiguation5/5

Each tool is uniquely identified by platform (douyin, kuaishou, xiaohongshu, bilibili) and action (check, upload_video, upload_note). No two tools overlap in purpose; check tools validate cookies while upload tools publish content.

Naming Consistency5/5

All tools follow a consistent pattern of platform_action (e.g., kuaishou_upload_video, bilibili_check), with douyin_upload_note as a logical variant. The utility sau_health also uses snake_case and fits the naming scheme.

Tool Count5/5

10 tools serve four platforms, each with a check and upload video action, plus an extra Douyin note upload and a health check. This is well-scoped and not excessive for the apparent purpose.

Completeness4/5

Core functionality (cookie validation and video upload) is covered for all platforms, and Douyin additionally supports image notes. Minor gaps exist, such as no note upload for other platforms and no management operations (list/delete), but these are not critical for the upload-focused domain.

Maintenance

ActivityStale
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables AI assistants to interact with Xiaohongshu to publish image notes, search content, and manage account details. It uses Playwright to securely handle session authentication and API signatures through the platform's internal network context.
    133 PyPI
    2
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    MCP server enabling AI assistants to search, analyze, and generate content for Xiaohongshu (RedNote), China's leading lifestyle social media platform.
    6
    9
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables LLMs to automatically upload videos to the Douyin (TikTok China) creator platform with features like automated login, smart upload, SMS verification, and flexible publishing.
    12 npm
    1
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    A lightweight MCP server that lets AI assistants publish notes to Xiaohongshu (Little Red Book) via browser automation. Supports login, image-text note publishing with up to 9 images, and search.
    4
    1
    -