docusaurus-plugin-mcp-serverBLOCK
Docusaurus plugin that publishes your documentation as an MCP server
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://badge.fury.io/js/docusaurus-plugin-mcp-server) [](https://github.com/scalvert/docusaurus-plugin-mcp-server/blob/main/LICENSE)
[Documentation](https://docusaurus-plugin-mcp-server.vercel.app) · Getting started · Deploy guides · Reference
A Docusaurus plugin that exposes an MCP (Model Context Protocol) server endpoint, allowing AI agents like Claude, Cursor, and other MCP-compatible tools to search and retrieve your documentation.
The server speaks MCP 2026-07-28 and still serves clients on 2025-era revisions (the initialize handshake) from the same endpoint. It can also serve Agent Skills that teach agents how to use your docs tools.
The documentation site is built with this plugin. Connect your agent to it:
claude mcp add --transport http docusaurus-plugin-mcp-server https://docusaurus-plugin-mcp-server.vercel.app/mcp
Installation
npm install docusaurus-plugin-mcp-server
Quick Start
1. Add the Plugin
// docusaurus.config.js
module.exports = {
plugins: [
[
'docusaurus-plugin-mcp-server',
{
se750c0bf3e951OBSERVED · 2026-10-12Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add docusaurus-plugin-mcp-server-website --env GLEAN_API_TOKEN=${GLEAN_API_TOKEN} -- npx -y [email protected]{
"mcpServers": {
"docusaurus-plugin-mcp-server-website": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"GLEAN_API_TOKEN": "${GLEAN_API_TOKEN}"
}
}
}
}Exposed tools (4)
3 read · 1 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
docs_fetch | read | Fetch the complete content of a documentation page. Use this after searching to get the full markdown content of a specific page. |
docs_search | read | Search the documentation for relevant pages. Returns matching documents ranked by relevance, with URLs, snippets, and matching sections. Use this to find information across all documentation. |
refunds | read | Does refunds things |
widget-setup | write | Set up the widget toolkit. Use when installing widgets. |
Trust audit
BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | FAIL |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (5 observation(s))
- Network
- declared (1 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (25)
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="api-keys">API Keys<a href="#api-keys" class="hash-link" aria-label="Direct link to API Keys" title="Direct link to API Keys" translate="no"></a></h
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="creating-an-api-key">Creating an API Key<a href="#creating-an-api-key" class="hash-link" aria-label="Direct link to Creating an API Key" title="Dir
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="key-types">Key Types<a href="#key-types" class="hash-link" aria-label="Direct link to Key Types" title="Direct link to Key Types" translate="no"></
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="using-api-keys">Using API Keys<a href="#using-api-keys" class="hash-link" aria-label="Direct link to Using API Keys" title="Direct link to Using AP
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="oauth-configuration">OAuth Configuration<a href="#oauth-configuration" class="hash-link" aria-label="Direct link to OAuth Configuration" title="Dir
Does refunds things
Set up the widget toolkit. Use when installing widgets.
.markdown-coderc.json
.mise.toml
.prettierignore
import type { ProcessedDoc, SkillFile } from '../../types/index.js';import { renderDocument } from '../../agent-view/render.js';import type { SearchResult } from '../../types/index.js';import type { McpServerToolsConfig, SearchResult } from '../../types/index.js';import type { SearchOptions } from '../../providers/types.js';const url = `http://127.0.0.1:${typeof addr === 'object' && addr ? addr.port : 0}/mcp`;baseURL = `http://127.0.0.1:${port}/mcp`;return `http://127.0.0.1:${typeof addr === 'object' && addr ? addr.port : 0}/mcp`;const url = `http://127.0.0.1:${typeof addr === 'object' && addr ? addr.port : 0}/mcp`;url = `http://127.0.0.1:${(server.address() as AddressInfo).port}/mcp`;@docusaurus/core, @docusaurus/preset-classic, prism-react-renderer, react, react-dom, @docusaurus/module-type-aliases, @docusaurus/types
@gleanwork/mcp-config-schema, @modelcontextprotocol/server, fs-extra, hast-util-select, hast-util-to-html, hast-util-to-string, mdast-util-to-string, minisearch
@docusaurus/core, @docusaurus/faster, @docusaurus/preset-classic, @mdx-js/react, clsx, prism-react-renderer, react, react-dom
<div class="language-json codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-cod
<div class="language-json codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-cod
Gates applied: no_behavioural_pass.
750c0bf3e951full audit observations/trust-audit/mcp-server/scalvert__docusaurus-plugin-mcp-server.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-12 | 750c0bf3e951 | BLOCK | D | 69 | first audit |
Questions
What is the docusaurus-plugin-mcp-server MCP server?
Docusaurus plugin that publishes your documentation as an MCP server
What tools does docusaurus-plugin-mcp-server expose?
4 in total: 3 read-only, 1 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is docusaurus-plugin-mcp-server safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (69/100) and found 5 critical or high issues in the source. Each one is listed on this page with the file and line it is on.
What credentials does docusaurus-plugin-mcp-server need?
It reads GLEAN_API_TOKEN from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does docusaurus-plugin-mcp-server run?
It speaks streamable-http, so it runs as a service you connect to over the network. It is published on npm as docusaurus-plugin-mcp-server-website at 0.0.0.
How current is this page?
The grade is for one exact copy of the source (750c0bf3e951), read on 2026-10-12. The repository is watched and re-audited when it changes.