yuque-ai-mcp
Full-featured Yuque MCP server with 65 tools across 13 domains, mixing Yuque OpenAPI and Cookie-based Web APIs for reading, writing, searching, organizing, exporting, and managing Yuque content.
Read and manage users, groups, members, roles, and group statistics.
Search docs/repos/users via general search, RAG-enhanced search, and Cookie web search with advanced syntax.
CRUD documents, notes, repos, and TOC/catalog nodes, including batch operations and safety confirms for deletion.
Work with document versions: list history, get version details, and diff versions line-by-line.
Batch get docs/repos, copy single docs or whole repos across books, and import from URLs or local files.
Export docs/repos to Markdown with TOC structure, images/resources, INDEX.md, and GRAPH.md.
Manage recycle bin items: list, restore, and permanently delete.
Upload attachments/images/videos to Yuque CDN.
Create and update boards: mindmaps, flowcharts, and architecture diagrams.
Manage personal book stacks and editor-center data via Cookie APIs.
Use Cookie-based web-doc tools to get/list docs and repos, get TOC, delete docs, and move/copy/batch-move catalog nodes, including cross-repo moves.
A full-featured Yuque (语雀) MCP Server built on the Model Context Protocol. Provides 65 fine-grained tools across 13 domains — 45 Yuque OpenAPI endpoints plus 20 web-API tools requiring a browser session cookie.
Why
19 → 65 tools — 3x more coverage than the official yuque-mcp-server
Dual transport — stdio + HTTP SSE, shared registry, zero downtime on reload
Modular architecture — 13 domains, barrel exports, single source of truth registry
Full API coverage — group, recycle, upload, statistics, versions, boards — all the missing pieces
Skill layer — 67 usage guides for AI agents
Related MCP server: WikiJS MCP Server
Table of Contents
Quick Start
cd server
npm install
npm run build
# Copy config template
cp config/config.example.json config/config.json
# Edit config.json with your Yuque API token
# Run
npm start # stdio mode
npm run dev:http # HTTP SSE mode (http://localhost:3099)Note:
npm run dev:httpusestsxfor hot-reload during development.
Tool Overview
Domain | Tools | Highlights |
doc | 15 | CRUD, versions, diff, batch get, import URL/file, cross-book copy, export, resource download |
repo | 8 | CRUD, batch get, cross-book copy, full export (TOC-structure + INDEX/GRAPH) |
toc | 3 | Get, update, batch update (createTitle/appendNode/removeNode/moveNode) |
search | 3 | General search + RAG-enhanced search + Cookie web search |
user | 3 | User info, heartbeat, group list |
group | 3 | Member list, role change, delete member |
statistic | 4 | Group/member/repo/doc statistics |
note | 4 | CRUD + soft-delete/restore |
recycle | 3 | List, restore, destroy (Cookie auth) |
upload | 1 | File upload to Yuque CDN (Cookie auth) |
board | 3 | Mindmap, flowchart, architecture diagram |
mine | 7 | Book stacks, editor center, update/sort book stack (Cookie auth) |
web_doc | 8 | Web API: get/list docs, repos, TOC, move/copy/delete catalog nodes (Cookie auth) |
Total | 65 |
Auth split: 45 tools use the OpenAPI (X-Auth-Token); 20 are Web API requiring Cookie + x-csrf-token — web_doc (8), mine (7), recycle (3), upload (1), web_search (1).
All 65 Tools
Tool | Domain | Description |
| user | 心跳检测,验证 Token 有效性 |
| user | 获取当前 Token 的用户详情 |
| user | 获取用户所属的团队列表 |
| search | 通用搜索文档/知识库 |
| search | RAG 检索增强搜索 + 自动获取文档内容 |
| search | Cookie 态 Web 搜索,返回完整文档对象 + 精确总数 + 高亮摘要 |
| group | 获取团队成员列表 |
| group | 变更团队成员角色 |
| group | 删除团队成员 |
| doc | 获取知识库文档列表 |
| doc | 创建文档 |
| doc | 获取文档详情(支持 ID 或 slug) |
| doc | 更新文档 |
| doc | 删除文档 |
| doc | 批量获取文档详情(max 20) |
| doc | 获取文档历史版本列表 |
| doc | 获取文档历史版本详情 |
| doc | 对比两个版本的行级差异 |
| doc | 单文档跨库复制 |
| doc | 导出单篇文档为 Markdown 文件 |
| doc | 下载文档中的图片/附件到本地 |
| doc | 从网页 URL 导入文档 |
| doc | 从本地文件导入文档 |
| doc | 生成文档嵌入阅读器 URL |
| toc | 获取知识库目录 |
| toc | 更新知识库目录 |
| toc | 批量更新目录(createTitle/appendNode/removeNode/moveNode/prependDoc) |
| repo | 获取知识库列表(用户/团队) |
| repo | 创建知识库 |
| repo | 获取知识库详情 |
| repo | 更新知识库 |
| repo | 删除知识库 |
| repo | 批量获取知识库详情(max 20) |
| repo | 批量跨库复制(LLM 分类 + 目录重建) |
| repo | 批量导出知识库为 Markdown(按 TOC 目录结构) |
| statistic | 获取团队汇总统计数据 |
| statistic | 获取团队成员统计数据 |
| statistic | 获取团队知识库统计数据 |
| statistic | 获取团队文档统计数据 |
| note | 获取小记列表 |
| note | 获取小记详情 |
| note | 创建小记 |
| note | 更新小记 |
| recycle | 列出回收站项目(Cookie) |
| recycle | 恢复回收站项目(Cookie) |
| recycle | 彻底删除回收站项目(Cookie) |
| upload | 上传文件到语雀 CDN(Cookie) |
| board | 获取文档中的画板资源 |
| board | 在文档中创建画板资源 |
| board | 更新文档中的画板资源 |
| mine | 获取知识库分组(书架)列表(Cookie) |
| mine | 获取个人编辑中心全景数据(Cookie) |
| mine | 创建知识库分组(书架),内部 create 后自动改名(Cookie) |
| mine | 重命名知识库分组(书架)(Cookie) |
| mine | 移动知识库到指定分组(书架)(Cookie) |
| mine | 排序知识库分组(书架)(Cookie) |
| mine | 删除知识库分组(书架),需 confirm='DELETE'(Cookie) |
| web_doc | Cookie 态读文档正文(含 body/content),不受会员过期限流; |
| web_doc | Cookie 态列文档列表,更丰富的字段 |
| web_doc | Cookie 态列知识库列表,含权限信息 |
| web_doc | Cookie 态获取知识库目录 TOC |
| web_doc | Cookie 态删除文档(移入回收站,v2 被限流时的备用通道) |
| web_doc | Cookie 态移动目录节点 |
| web_doc | Cookie 态复制目录节点 |
| web_doc | Cookie 态批量移动目录节点 |
See SKILL.md or yuque-ai-skills for full tool documentation with parameters and examples.
vs Official
Feature | Official yuque-mcp-server | yuque-ai-mcp |
Tools | 19 | 65 |
Granularity | Coarse | Fine-grained (1 tool / endpoint) |
Group, Recycle, Upload, Statistics | ❌ | ✅ |
Versions, Diff, Cross-book Copy | ❌ | ✅ |
Transport | stdio only | stdio + HTTP SSE |
Config | Env var | config.json (token + cookie) |
Skill Layer | ❌ | ✅ 67 guides |
Architecture
server/src/
├── common/ # Shared: config, errors, types, format, validate,
│ # api-client, web-request, register-tools, copy/export common,
│ # toc-cache (configurable TTL), text-utils
├── user/ search/ group/ doc/ toc/ repo/ statistic/
├── note/ recycle/ upload/ board/ mine/ web-doc/
├── index.ts # stdio entry
└── http.ts # HTTP SSE entry (port 3099)Configuration
{
"token": "Your Yuque API Token",
"api_base": "https://www.yuque.com/api/v2",
"cookie": "Optional, for recycle/upload features",
"ctoken": "Optional, extracted from Cookie"
}toc_cache_ttl_minutes: TOC cache TTL in minutes (default 60). Set higher to reduce API calls, lower for fresher data.
Error Handling
Unified error handling with structured responses (HTTP status + message + response summary). All tools share the same error pipeline.
Key errors:
book_full— Auto-expands by creating a new repo and appending to thebook_idarray401/403— Token/permission issues429— Rate limit with automatic retry
See references/api/errors.md for the full error code reference.
Contributing
git clone https://github.com/yehuoshun/yuque-ai-mcp.git
cd yuque-ai-mcp/server
npm install
npm run build
# New tool checklist:
# 1. Create server/src/{domain}/{tool}.ts
# 2. Export in {domain}/index.ts + append to tools array
# 3. npx tsc
# 4. Restart HTTP server + curl health
# 5. Sync yuque-ai-skills
# 6. Update README
# 7. Sync awesome-list entries when tool/domain count changesBoth yuque-ai-mcp and yuque-ai-skills are kept in sync.
Maintenance
This project is listed in these directories. When the tool count or domain count changes, sync the entries (they mention "65 tools" / "13 domains"):
Tech Stack
TypeScript + Node.js
@modelcontextprotocol/sdk v1.x
Zod (validation)
Yuque OpenAPI v2 / Web API
License
MIT
Available Tools
65 toolsyuque_batch_get_docsB
Batch get document details (concurrent GET, read-only, max 20). 详见 references/api/doc_api.md
Inputs: ids (required), book_id (required), raw.
yuque_batch_get_reposB
Batch get repo details (concurrent GET, read-only, max 20). 详见 references/api/repo_api.md
Inputs: ids (required).
yuque_batch_update_tocA
Batch update repo TOC. Agent provides ops plan, tool executes only. Supported actions: createTitle, appendNode, removeNode, moveNode, prependDoc. createTitle auto-reuses existing dirs. appendNode/moveNode support target_title. ⚠️ Remove/move ops require confirm='RESTRUCTURE'. For cross-book copy, use yuque_copy_doc instead.
Inputs: ops (required), book_id (required), confirm (required).
yuque_copy_docA
Copy a single document to another repo. Agent fetches source via yuque_get_doc, cleans content, then calls this tool with title/body/format/paths. 详见 references/api/extended_api.md
Inputs: body (required), paths (required), title (required), format (required), +3 more.
yuque_copy_repoC
Batch copy documents to another repo. Agent provides cleaned documents array (title/body/format/paths). Tool creates TOC dirs and copies. 详见 references/api/extended_api.md
Inputs: documents (required), target_book_id (required), raw.
yuque_create_boardC
Create a board resource (mindmap/flowchart/architecture diagram) in a document. POST /yfm/boards. 详见 references/api/board_api.md
Inputs: dsl (required), type (required), url, doc_id, +1 more.
yuque_create_book_stackA
创建知识库分组(书架)并设定名称。需要 cookie+ctoken 认证。语雀 create 不能直接指定名字,本工具内部 create 后自动 edit 改名。body {name, target_rank}。
Inputs: name (required), target_rank.
yuque_create_docC
Create a document in a repo. 传 parent_uuid 则挂到指定节点下,不传默认挂根目录。POST /repos/:id/docs. 详见 references/api/doc_api.md
Inputs: body (required), book_id (required), raw, slug, +4 more.
yuque_create_noteB
Create a note (short memo). Returns id, slug, note_url. POST /notes. 详见 references/api/note_api.md
Inputs: body (required), raw.
yuque_create_repoB
Create a repo, auto-detects user vs group endpoint. POST /users|groups/:login/repos. 详见 references/api/repo_api.md
Inputs: name (required), login (required), raw, slug, +3 more.
yuque_delete_book_stackA
删除知识库分组(书架)。⚠️ 不可恢复!需传 confirm='DELETE' 二次确认。DELETE /api/book_stacks/{stack_id}。分组内须先清空知识库。
Inputs: confirm (required), stack_id (required).
yuque_delete_docB
Delete a document (moves to recycle bin). ⚠️ Requires confirm='DELETE'. DELETE /repos/:id/docs/:id. 详见 references/api/doc_api.md
Inputs: id (required), book_id (required), confirm (required), raw.
yuque_delete_group_userB
Remove a member from a group. ⚠️ Requires confirm='DELETE'. DELETE /groups/:login/users/:id. 详见 references/api/group_api.md
Inputs: id (required), login (required), confirm (required), raw.
yuque_delete_repoA
Delete a repo (⚠️ irreversible). Requires confirm='DELETE'. DELETE /repos/:id. 详见 references/api/repo_api.md
Inputs: book_id (required), confirm (required), raw.
yuque_destroy_recycleA
Permanently delete a recycle bin item (⚠️ irreversible, requires cookie+ctoken). Requires confirm='DELETE'. DELETE /mine/recycles/:id. 详见 references/api/recycle_api.md
Inputs: confirm (required), recycle_id (required).
yuque_diff_doc_versionsB
Compare two document versions and show line-level diff (added/removed/unchanged). Computes diff locally. 详见 references/api/doc_api.md
Inputs: version_id_1 (required), version_id_2 (required), max_lines, context_lines.
yuque_embed_urlB
Generate a Yuque embed reader URL from a document link or doc_id+book_id. 详见 references/api/extended_api.md
Inputs: from (required), url, title, doc_id, +3 more.
yuque_export_docA
Export a single document as Markdown file. Fetches doc → converts body_html to Markdown → adds frontmatter → writes to disk. Resource download is separate (yuque_export_resources). 详见 references/api/extended_api.md
Inputs: id (required), output_dir (required), book_id, raw_body.
yuque_export_repoA
Export all docs in a repo as Markdown files organized by TOC dir structure, with images downloaded and INDEX.md+GRAPH.md generated. 详见 references/api/extended_api.md
Inputs: book_id (required), raw_body, output_dir, download_images.
yuque_export_resourcesA
Download images/attachments from a document to local directory. Extracts resource URLs from body_html, downloads to <output_dir>/images/ and <output_dir>/attachments/, returns URL→local_path mapping. 详见 references/api/extended_api.md
Inputs: id (required), output_dir (required), book_id.
yuque_get_boardC
Get board resource JSON DSL and summary stats from a document. GET /yfm/boards. 详见 references/api/board_api.md
Inputs: resource_id (required), url, doc_id.
yuque_get_book_stacksA
获取当前用户的知识库分组(书架)列表,含每个分组下的知识库。需要 cookie+ctoken 认证。GET /api/mine/book_stacks
Inputs: no named parameters.
yuque_get_book_statisticsC
Get group repo statistics. GET /groups/:login/statistics/books. 详见 references/api/statistic_api.md
Inputs: login (required), name, page, limit, +3 more.
yuque_get_docA
Get document detail (body/body_html). Sheet/Table docs and body_lake/body_draft need raw=true. Supports id or slug. GET /repos/docs/:id. 详见 references/api/doc_api.md
Inputs: id (required), raw, page, book_id, +1 more.
yuque_get_doc_statisticsC
Get group document statistics. GET /groups/:login/statistics/docs. 详见 references/api/statistic_api.md
Inputs: login (required), name, page, limit, +4 more.
yuque_get_doc_version_detailA
Get version detail (format/body/body_md/body_html/body_asl/diff + meta). Fields over 20000 chars are truncated — pass raw=true for the full payload. GET /doc_versions/:id. 详见 references/api/doc_api.md
Inputs: id (required), raw.
yuque_get_doc_versionsA
List document version history (last 100 published versions). GET /doc_versions?doc_id=:id. 详见 references/api/doc_api.md
Inputs: doc_id (required), raw.
yuque_get_editor_centerB
获取个人编辑中心全景数据:知识库数、文档数、总字数、编辑次数、活跃天数、互动用户排行、最多字的知识库等。需要 cookie+ctoken 认证。GET /api/mine/editor_center
Inputs: no named parameters.
yuque_get_group_statisticsC
Get group summary statistics. GET /groups/:login/statistics. 详见 references/api/statistic_api.md
Inputs: login (required).
yuque_get_group_usersA
List group members (page size 100). Supports role filter (0=admin,1=member,2=readonly). GET /groups/:login/users. 详见 references/api/group_api.md
Inputs: login (required), raw, role, offset.
yuque_get_member_statisticsC
Get group member statistics. GET /groups/:login/statistics/members. 详见 references/api/statistic_api.md
Inputs: login (required), name, page, limit, +3 more.
yuque_get_noteC
Get note detail. GET /notes/:id. 详见 references/api/note_api.md
Inputs: note_id (required), raw.
yuque_get_repoB
Get repo detail including toc_yml (TOC tree in YAML), namespace, items_count, full metadata. GET /repos/:id. 详见 references/api/repo_api.md
Inputs: book_id (required), raw.
yuque_get_tocB
Get repo TOC tree (flat array, navigable via uuid/parent_uuid/child_uuid). GET /repos/:id/toc. 详见 references/api/toc_api.md
Inputs: book_id (required), raw.
yuque_get_userA
Get current user profile (id,login,name,avatar_url,books_count,description,created_at). GET /user. 详见 references/api/user_api.md
Inputs: raw.
yuque_get_user_groupsB
List groups the user belongs to. GET /users/:id/groups. 详见 references/api/user_api.md
Inputs: id (required), raw, role, offset.
yuque_helloA
Health check — verify Yuque API token validity. GET /hello. 详见 references/api/user_api.md
Inputs: no named parameters.
yuque_import_fileC
Import a local Markdown/HTML file into Yuque. 3 modes: direct / upload_assets / embed_assets. 详见 references/api/extended_api.md
Inputs: paths (required), book_id (required), file_path (required), mode, +3 more.
yuque_import_urlB
Import content from a web URL into Yuque. Fetches page, extracts readable content, creates doc. 详见 references/api/extended_api.md
Inputs: url (required), paths (required), book_id (required), title, +1 more.
yuque_list_docsB
List documents in a repo, sorted by updated_at desc. limit ≤ 100. Supports deleted (recycle view) and changed_at_gte (incremental sync). GET /repos/:id/docs. 详见 references/api/doc_api.md
Inputs: book_id (required), raw, limit, offset, +3 more.
yuque_list_notesB
List current user's notes. GET /notes. 详见 references/api/note_api.md
Inputs: page, limit, status.
yuque_list_recyclesB
List recycle bin items (requires cookie+ctoken). GET /mine/recycles. 详见 references/api/recycle_api.md
Inputs: limit, offset, target_type.
yuque_list_reposC
List repos for a user or group. GET /users|groups/:login/repos. 详见 references/api/repo_api.md
Inputs: login (required), raw, type, limit, +2 more.
yuque_rag_searchB
RAG-enhanced search: accepts LLM-generated keywords, runs concurrent multi-path searches, deduplicates by doc_id, fetches top-N full doc content. 详见 references/api/search_api.md
Inputs: keywords (required), scope, creator, fetch_docs, +1 more.
yuque_rename_book_stackA
重命名知识库分组(书架)。需要 cookie+ctoken 认证。PUT /api/book_stacks/{stack_id},body {name, type:'user_books'}。
Inputs: name (required), stack_id (required).
yuque_restore_recycleB
Restore an item from recycle bin (requires cookie+ctoken). PUT /mine/recycles/:id/restore. 详见 references/api/recycle_api.md
Inputs: recycle_id (required).
yuque_searchC
General search across Yuque docs and repos. GET /search?q=:q&type=:type. 详见 references/api/search_api.md
Inputs: q (required), type (required), page, scope, +1 more.
yuque_sort_book_stackA
排序分组(书架)内知识库顺序。需要 cookie+ctoken 认证。PUT /api/mine/book_stack/move,传有序 targetBookIds(数组顺序即最终排序)。常用于把分组内知识库按期望顺序重排。
Inputs: book_ids (required), stack_id (required).
yuque_update_boardC
Update a board resource (text or dsl, choose one). PUT /yfm/boards. 详见 references/api/board_api.md
Inputs: resource_id (required), dsl, url, text, +1 more.
yuque_update_book_stackA
移动知识库到指定分组(书架)。需要 cookie+ctoken 认证。PUT /api/mine/book_stack/move。常用于将知识库从一个分组(如预废弃)移到另一个分组(如废弃)。
Inputs: book_id (required), stack_id (required).
yuque_update_docC
Update a document title/body/slug/format/public. PUT /repos/:id/docs/:id. 详见 references/api/doc_api.md
Inputs: id (required), book_id (required), raw, body, +4 more.
yuque_update_group_userC
Change a group member role (0=admin,1=member,2=readonly). PUT /groups/:login/users/:id. 详见 references/api/group_api.md
Inputs: id (required), login (required), raw, role.
yuque_update_noteB
Update or delete a note. ⚠️ Deleting (status=9) requires confirm='DELETE'. PUT /notes/:id. 详见 references/api/note_api.md
Inputs: note_id (required), raw, body, status, +1 more.
yuque_update_repoC
Update repo name/description/slug/public. PUT /repos/:id. 详见 references/api/repo_api.md
Inputs: book_id (required), raw, toc, name, +3 more.
yuque_update_tocA
Update repo TOC (create/move/edit/delete nodes). ⚠️ Deleting requires confirm='DELETE'. For removeNode: action_mode=sibling deletes only the node, child deletes the node and all its children. PUT /repos/:id/toc. 详见 references/api/toc_api.md
Inputs: action (required), book_id (required), action_mode (required), url, +8 more.
yuque_upload_attachmentA
Upload a file to Yuque CDN (image≤50MB, attachment/video≤2GB, requires cookie+ctoken). Extension pre-check: only Yuque-supported formats allowed (official list: https://www.yuque.com/yuque/gpvawt/ca13hg), unsupported extensions rejected with a friendly error (pack into zip first). POST /upload/attach. 详见 references/api/upload_api.md
Inputs: file_path (required), type, user_id.
yuque_web_batch_move_catalog_nodesB
Cookie-based: Batch move document nodes to a target catalog node. PUT /api/catalog_nodes/batch. Supports cross-repo move (target_book_id may differ from book_id). No membership required. Moves the specified node_uuids under the target_uuid directory as children. 详见 references/api/web_doc_api.md
Inputs: book_id (required), node_uuids (required), target_uuid (required), target_book_id.
yuque_web_copy_catalog_nodeA
Cookie-based: Copy a catalog node (doc or dir) to a target catalog node / target repo, server-side with attachment re-upload. PUT /api/catalog_nodes/copy. The source node is kept; a copy is created in the target repo and attachments re-uploaded there (preserves file cards). node_uuid must be from the web catalog (/api/catalog_nodes), not the v2 TOC. 详见 references/api/web_doc_api.md
Inputs: book_id (required), node_uuid (required), target_book_id (required), action, +3 more.
yuque_web_delete_docA
Cookie-based: Delete a document (moves to recycle bin). DELETE /api/docs/{id}?book_id={book_id}. No membership required, alternative to v2 delete_doc when Token is rate-limited/expired. ⚠️ Requires confirm='DELETE'. 详见 references/api/doc_api.md
Inputs: id (required), book_id (required), confirm (required), raw.
yuque_web_get_docA
Cookie-based: Get full document detail with body/content. Supports markdown/lake/lakesheet formats. Returns richer fields than v2 get_doc (54 fields including abilities, joinToken, etc.). No membership required, no Token rate limiting. GET /api/docs/{id}?book_id={book_id}. id supports doc slug; book_id supports namespace/slug (e.g. yehuoshun/utuif2) or numeric. 详见 references/api/doc_api.md
Inputs: id (required), book_id (required), raw.
yuque_web_get_tocA
Cookie-based: Get repo TOC tree (flat array, navigable via uuid/parent_uuid/child_uuid). Same structure as v2 get_toc, but no membership required. GET /api/catalog_nodes?book_id={book_id}. 详见 references/api/toc_api.md
Inputs: book_id (required), raw.
yuque_web_list_docsA
Cookie-based: List documents in a repo. Returns richer fields than v2 list_docs (draft_version, editor_meta, read_status, etc.). No membership required. GET /api/docs?book_id={book_id}. 详见 references/api/doc_api.md
Inputs: book_id (required), raw, limit, offset.
yuque_web_list_reposA
Cookie-based: List repos for current user. Returns richer fields than v2 list_repos (abilities, cover_color, scene, etc.). Includes permission info (abilities.create_doc, modify_setting, destroy). No membership required. GET /api/books. 详见 references/api/repo_api.md
Inputs: raw, limit, offset, user_id.
yuque_web_move_catalog_nodeA
Cookie-based: Move a single catalog node to a target catalog node / target repo. PUT /api/catalog_nodes/move. Supports cross-repo move (target_book_id may differ from book_id) and moving the whole subtree (with_children). No membership required. 详见 references/api/web_doc_api.md
Inputs: book_id (required), node_uuid (required), action, target_uuid, +3 more.
yuque_web_searchA
Cookie-based web search across Yuque docs/books/users. Returns full document objects (_record) without needing a second get_doc call. Supports scope filtering (repo/group), type filtering (content/book/user), pagination, AND advanced search syntax: "phrase", in:title, NOT/AND/OR, updated:>YYYY-MM-DD, url:scope, is:related/public. Requires cookie+ctoken in config. GET /api/zsearch?q=:q&type=:type&scope=:scope&p=:p. ⚠️ Cookie-based API — QPS unknown, avoid concurrent calls. 详见 references/api/search_api.md
Inputs: q (required), p, type, scope.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 65 tools
The server exposes two parallel API surfaces (v2 token-based and cookie-based `web_*`) that largely duplicate each other: `yuque_list_docs`/`yuque_web_list_docs`, `yuque_get_doc`/`yuque_web_get_doc`, `yuque_get_toc`/`yuque_web_get_toc`, and `yuque_delete_doc`/`yuque_web_delete_doc` do the same job with slightly different payloads. Similarly, TOC restructuring is split across `yuque_update_toc`, `yuque_batch_update_toc`, `yuque_web_move_catalog_node`, and `yuque_web_batch_move_catalog_nodes`, and search is split across `yuque_search`, `yuque_rag_search`, and `yuque_web_search`. Descriptions hint at the differences (no membership required, richer fields, batch vs single), but an agent must read carefully to avoid picking the wrong twin.
Almost all tools follow `yuque_verb_noun` snake_case (`yuque_create_doc`, `yuque_list_repos`, `yuque_update_toc`), with a consistent `yuque_web_` prefix marking the cookie-based variants. Minor deviations exist (`yuque_hello` has no verb, `yuque_rag_search` inserts a modifier), but the pattern is predictable and readable overall.
65 tools is far beyond a comfortable surface for an agent to navigate, and the count is inflated by the duplicate v2/web API pairs plus four separate TOC-manipulation tools. The domain (docs, repos, TOC, notes, groups, boards, search, recycle, statistics, book stacks) is genuinely broad, so some size is justified, but this many tools with this much redundancy is heavy.
Coverage is unusually thorough: full CRUD for docs, repos, notes, boards, and book stacks, plus TOC editing, recycle bin lifecycle, version history/diff, export/import, group member management, and statistics. Gaps are minor and peripheral — no comment/discussion tools and no explicit permission/share management for documents or repos.
Maintenance
Related MCP Connectors
Collaborative engineering KB for a mile-high city. 9 tools, 8 domains, 32 entries.
62 real-world tools for agents: search, scraping, social, enrichment, image, video, voice.
Enterprise memory, search, and context for frontier AI. 38 tools for business intelligence.
VaultCrux Platform — 60 tools: retrieval, proof, intel, economy, watch, org
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables working with large documents of any size by intelligently segmenting them and using TF-IDF search to retrieve only relevant fragments, preventing context window saturation. Provides 31 domain-agnostic tools for document ingestion, semantic analysis, epistemological validation, and extraction verification across formats like PDF, EPUB, and HTML.31MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables comprehensive management of WikiJS instances through tools for searching, creating, updating, and deleting wiki pages. It supports advanced features like knowledge graph exploration, page summaries, and content exporting for documentation workflows.-
- AlicenseNot gradedqualityBmaintenanceEnd-to-end agent-managed company brain. Humans and any MCP agent co-author living docs (Markdown + extensions), 40+ visual diagrams (Mermaid, BPMN, D2, PlantUML, ELK, Excalidraw), plans, and a self-learning Knowledge Graph. 163 tools across 16 categories. Auth: OAuth 2.1 or API key. Lean, secure, affordable — from individuals to enterprise.MIT
- FlicenseNot gradedqualityDmaintenanceProvides tools for indexing documents, creating notes, searching content, and extracting metadata to enable document processing and knowledge management.-