Skills/PyPI/mcp-zen-of-docs

mcp-zen-of-docs@0.1.0

CAUTION· not started

Publisher claims: "FastMCP server for documentation generation and validation." Observed in sandbox: no network, touches nothing outside the project, writes no memory.

Registry PyPI (MCP server)Publisher pypi · publishing for 723 daysInstalls 12Last detonated 4d ago
What would fix thisWatchDispute verdict

Coverage

Not started: dependency install failed; the server itself was not observed.
Tested
the dependency install step · every file read, file written and host contacted by what ran
Not tested
server startup · the tool list · tool behavior

What this means for the label: Caution here covers what ran. The server's tools were not exercised with a real credential, so nothing about their behavior is asserted; the credential summary below says what to do with that.

Before you give it your token

It will ask for
CLOUDFLARE_API_TOKENNETLIFY_AUTH_TOKENVERCEL_TOKENConfiguration, not credentials: DOCS_DEPLOY_PATH, MCP_ZEN_OF_DOCS_REFERENCE_DIR
Where it talks to
no vendor host named in the codeAlso shields.io, zensical.org, vitepress.dev, docusaurus.io, astro.build, abseil.io, github.blog, unpkg.com, myproject.io, your-project.io, c4model.com, keepachangelog.com, semver.org, astral.sh, visualstudio.com — not the publisher's domain; check what for before connecting.
What the honeypot saw
no credential files read · no network
What we could not test
server startup · the tool list · tool behavior

Connect it with a scoped credential, under the guard, and read the third-party hosts first. The code names shields.io, zensical.org, vitepress.dev, docusaurus.io, astro.build, abseil.io, github.blog, unpkg.com, myproject.io, your-project.io, c4model.com, keepachangelog.com, semver.org, astral.sh, visualstudio.com as well as its own vendor. The guard injects CLOUDFLARE_API_TOKEN, NETLIFY_AUTH_TOKEN, VERCEL_TOKEN only into requests to the host you bind (and its subdomains) and refuses the rest.

$vet-skills run --net declared -- uvx mcp-zen-of-docs

Never paste a credential into a chat, a ticket or a report, including ours. How the guard holds it.

Is [email protected] safe to install?

KillerSkills ran it in the KillerSkills honeypot sandbox (2 scenarios; not started: dependency install failed; the server itself was not observed) on 2026-11-10 and scored it 70/100 (Caution). It is not known to be malicious, but it has behaviour or code a security policy should decide on before install. Notable findings: Access to sensitive file paths; Access to sensitive file paths; Pipe-to-shell pattern. Summary: no network, touches nothing outside the project, writes no memory.

Behavior trace

Honeypot run · 0 s · 2 scenarios · 0 deviations
t+CategoryObserved action
0.0sprocessno install scripts in bundle
0.1sprocessdependency install exit 1 ·
0.1sclaimednot started: dependency install failed (exit 1); the server itself was not observed
0.1sprocessscript backend runs setup only
0.1sprocessno install scripts to re-run

Static findings

HIGH
Access to sensitive file pathssrc/mcp_zen_of_docs/templates/boilerplate.py:555 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files"should be documented in a `.env.example` file.\n"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
HIGH
Access to sensitive file pathssrc/mcp_zen_of_docs/domain/copilot_artifact_spec.py:241 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system filesapply_to="**/.env*",Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
MEDIUM
Python subprocess execution detectedsrc/mcp_zen_of_docs/generators.py:3637 · Python subprocess execution detectedresult = subprocess.run( # noqa: S603Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/mcp_zen_of_docs/generators.py:3577 · Python subprocess execution detectedresult = subprocess.run( # noqa: S603Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
CRITICAL
Pipe-to-shell patternsrc/mcp_zen_of_docs/templates/boilerplate.py:420 · Pipe-to-shell pattern — downloads and immediately executes remote code"(install via `curl -LsSf https://astral.sh/uv/install.sh | sh`)\n"Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST06
HIGH
Access to sensitive file pathssrc/mcp_zen_of_docs/templates/boilerplate.py:759 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files"should be documented in a `.env.example` file.\n"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
MEDIUM
npx invocation of non-well-known packagesrc/mcp_zen_of_docs/generators.py:2394 · npx invocation of non-well-known package — may execute untrusted codeThis implements the "npx / uvx tmp-and-copy" pattern:Fix: Pin versions and sources; vendor anything fetched at install time.
AST06
MEDIUM
Python subprocess execution detectedsrc/mcp_zen_of_docs/generators.py:373 · Python subprocess execution detectedcompleted = subprocess.run( # noqa: S603Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
npx invocation of non-well-known packagesrc/mcp_zen_of_docs/generators.py:2344 · npx invocation of non-well-known package — may execute untrusted code# Ephemeral uvx/npx install-in-tmp-and-copyFix: Pin versions and sources; vendor anything fetched at install time.
AST06
MEDIUM
Python subprocess execution detectedsrc/mcp_zen_of_docs/generators.py:2414 · Python subprocess execution detectedresult = subprocess.run( # noqa: S603Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/mcp_zen_of_docs/asset_conversion.py:231 · Python subprocess execution detectedresult = subprocess.run( # noqa: S603Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
HIGH
Access to sensitive file pathssrc/mcp_zen_of_docs/templates/copilot_assets.py:227 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files"- Keep naming consistent across `.env*` files and deployment configs.\n"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
MEDIUM
npx invocation of non-well-known packagesrc/mcp_zen_of_docs/domain/tool_surface_migration_map.py:383 · npx invocation of non-well-known package — may execute untrusted code"New tool exposing the uvx/npx tmp-and-copy pattern as a first-class MCP tool."Fix: Pin versions and sources; vendor anything fetched at install time.
AST06
MEDIUM
Python subprocess execution detectedsrc/mcp_zen_of_docs/asset_conversion.py:145 · Python subprocess execution detectedresult = subprocess.run( # noqa: S603Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
npx invocation of non-well-known packagesrc/mcp_zen_of_docs/templates/init_specs.py:11 · npx invocation of non-well-known package — may execute untrusted code- Docusaurus: ``npx create-docusaurus@latest site classic --typescript --skip-install``Fix: Pin versions and sources; vendor anything fetched at install time.
AST06
MEDIUM
npx invocation of non-well-known packagesrc/mcp_zen_of_docs/generators.py:3558 · npx invocation of non-well-known package — may execute untrusted code"`npm install -g @mermaid-js/mermaid-cli` or `npx mmdc ...`"Fix: Pin versions and sources; vendor anything fetched at install time.
AST06
LOW
Unpinned dependencysrc/mcp_zen_of_docs/templates/docs_deploy_workflows.py:152 · Unpinned dependency" run: npm install --global vercel@latest\n"Fix: Pin the exact version (`[email protected]`, `==1.2.3`) so every install gets the bytes that were reviewed.
AST06
MEDIUM
npx invocation of non-well-known packagesrc/mcp_zen_of_docs/templates/init_specs.py:12 · npx invocation of non-well-known package — may execute untrusted code- VitePress: ``npx vitepress@latest init docs`` (piped newlines for defaults)Fix: Pin versions and sources; vendor anything fetched at install time.
AST06
MEDIUM
Python subprocess execution detectedsrc/mcp_zen_of_docs/infrastructure/process_adapter.py:36 · Python subprocess execution detectedcompleted = subprocess.run( # noqa: S603Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
npx invocation of non-well-known packagesrc/mcp_zen_of_docs/generators.py:2397 · npx invocation of non-well-known package — may execute untrusted code2. ``uvx install <package>`` (or ``npx --yes <package>``) into that directory.Fix: Pin versions and sources; vendor anything fetched at install time.
AST06
LOW
Unpinned dependencysrc/mcp_zen_of_docs/templates/docs_deploy_workflows.py:199 · Unpinned dependency" run: npm install --global wrangler@latest\n"Fix: Pin the exact version (`[email protected]`, `==1.2.3`) so every install gets the bytes that were reviewed.
AST06
MEDIUM
npx invocation of non-well-known packagesrc/mcp_zen_of_docs/models.py:1068 · npx invocation of non-well-known package — may execute untrusted code"""Input contract for ephemeral uvx/npx install-in-tmp-and-copy runs."""Fix: Pin versions and sources; vendor anything fetched at install time.
AST06
MEDIUM
npx invocation of non-well-known packagesrc/mcp_zen_of_docs/models.py:1132 · npx invocation of non-well-known package — may execute untrusted code"""Output contract for ephemeral uvx/npx install-in-tmp-and-copy runs."""Fix: Pin versions and sources; vendor anything fetched at install time.
AST06
MEDIUM
Remote installer piped to shellsrc/mcp_zen_of_docs/templates/boilerplate.py:420 · Remote installer piped to shell"(install via `curl -LsSf https://astral.sh/uv/install.sh | sh`)\n"Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST07
MEDIUM
Python subprocess execution detectedsrc/mcp_zen_of_docs/visual_assets.py:303 · Python subprocess execution detectedresult = subprocess.run(cmd, capture_output=True, timeout=30, check=False) # noqa: S603Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05

Cost to the agent

Instructions loaded
≈53 tok
1 file · 64 in bundle
Tool list per prompt
≈0 tok
0 tools · 0 per tool
Handshake
no reply
launch to tools/list, stdio
Undocumented tools
0
description under 20 chars · avg 0

Tokens estimated at four characters each. The tool list is re-read by the agent on every turn, so it is the number to compare between servers that do the same job: ranked across the index.

Known vulnerabilities

No advisories in OSV for mcp-zen-of-docs@0.1.0 as of 4d ago. This is the package itself, not its dependencies.

What would make this Verified

10 points to 80 · weights: behavior 45%, static 25%, prompt 15%, publisher 15%
  1. Pipe-to-shell pattern≈ +9 on the totalBuild commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
  2. Unclaimed publisher≈ +8 on the totalClaim pypi: a verified publisher gets +50 on publisher trust. It is free and usually instant with GitHub sign-in.
  3. Access to sensitive file paths≈ +4 on the totalStop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
  4. Unpinned dependencies≈ +3 on the totalPin exact versions (and ideally hashes) in package.json, requirements or the install script so the bundle cannot change under you.
  5. Python subprocess execution detected≈ +2 on the totalBuild commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
  6. npx invocation of non-well-known package≈ +2 on the totalPin versions and sources; vendor anything fetched at install time.
Publish a new version to PyPI, then queue it here. Not your skill? Claim the handle to get verdict changes by email.Claim pypiPropose a patch to the maintainer