# MCP 工具参考

端点：`https://mcp.redcao.com/mcp`  
鉴权：控制台概览中的个人令牌（Bearer）。  
产品连接器名：`wechat-publisher`。

## 查询

- `list_wechat_accounts`：已绑定公众号；含 appid、`verified`、默认模板、选题说明 `topic_brief`、发布频率 `publish_cadence`（仅供参考，不自动排期）、`auto_publish` / `auto_publish_delay_min`
- `set_auto_publish`：设置认证号的延迟自动正式发表（开关 + 间隔）；未认证号开启会被拒绝
- `list_theme_styles`：可用样式主题
- `get_credits`：剩余额度
- `list_articles`：本站文章列表；可按 `info_id` 精确取一篇；含 `media_id`
- `list_upstream_services` / `call_upstream_service`：已配置的上游服务

## 写稿与发布

- `create_article`：创建本地草稿；`dry_run=true` 只预检不落库。返回 `quality`（`blockers` 必须修，`warnings` 为建议）
- `update_article`：按 `info_id` 改已有稿，勿为改错字再建一篇
- `delete_article`：删除本地废稿（不删微信侧已写入的草稿素材）
- `validate_article`：发布硬条件检查（封面、号、额度等）；不管文风建议
- `preview_article`：按公众号模板预览 HTML + 结构化质检
- `publish_article`：写入指定公众号草稿箱；成功扣 1 次额度。建议传 `idempotency_key`，超时用同一 key 重试可拿回 `media_id` 且不重复写入。若该号已用 `set_auto_publish` 或控制台开启自动发表，会在设定间隔后正式发表；否则需后台手动操作

## 图片

- `search_stock_images`：按关键词搜图（公共/私有随公众号配图来源），给封面和正文配插图；返回可直接写入稿件的地址。建议（非强制）一次传 ≥2 个关键词（逗号/顿号分隔），结果通常更准
- `get_upload_channel`：手里只有图片文件时，换成稿内可用地址

## 素材库

- `save_material`：入库
- `search_materials`：按类型、分类、标签或关键词检索，方便复用
- `mark_material_used`：标记已用
- `delete_material`：标记不再使用

## Agent 使用提示

1. **未绑定公众号不禁止写稿与搜图。** `create_article` / `update_article` / `search_stock_images` / `get_upload_channel` / `preview_article` / `get_credits` 等均可照常调用。只有 `publish_article`（以及为发布做的 `validate_article`）需要已绑定公众号；未绑定时引导打开 https://mcp.redcao.com/console/accounts 完成接入后再发布。
2. 多号时发布必须指定 `appid`。
3. 选题与标题应遵守该号的 `topic_brief`（若非空）；未绑号时可先按用户意图写稿。
4. 不要根据 `publish_cadence` 自动触发发布。
5. 改稿用 `update_article`；试写用 `create_article(dry_run=true)`。
6. 人读文档入口：https://mcp.redcao.com/llms.txt
