symbols-mcp@3.14.786
CAUTIONPublisher claims: "Symbols.app MCP — docs, code generation, publishing, CLI/SDK reference" Observed in sandbox: no network, touches nothing outside the project, writes no memory.
Coverage
Server started and answered tools/list.- Tested
- MCP initialize and tools/list · every tool description, for hidden instructions · every file read, file written and host contacted by what ran
- Not tested
- what the tools do when called with real credentials
Before you give it your token
- It will ask for
SYMBOLS_TOKENConfiguration, not credentials: FRANK_AUDIT_BIN, FRANK_AUDIT_URL, MCP_HOST, MCP_PORT, MCP_TRANSPORT, SYMBOLS_API_URL, SYMBOLS_SKILLS_DIR- Where it talks to
- symbols.app (its own)Also esm.sh, symbo.ls — not the publisher's domain; check what for before connecting.
- What we saw when it ran
- no credential files read · no network
- What we could not test
- what the tools do when called with real credentials
Connect it with a scoped credential, under the guard, and read the third-party hosts first. The code names esm.sh, symbo.ls as well as its own vendor. The guard injects SYMBOLS_TOKEN only into requests to symbols.app (and its subdomains) and refuses the rest.
Never paste a credential into a chat, a ticket or a report, including ours. How the guard holds it.
What changed since 3.14.784
vet-skills diff symbols-mcp 3.14.784 3.14.786This version reaches for something 3.14.784 did not: 9 rewritten tool descriptors (audit_component, convert_html, convert_react, detect_environment, …). Compared from the two recorded runs, not from source.
- Rewritten tool descriptors
- audit_component, convert_html, convert_react, detect_environment, generate_component, generate_page, get_cli_reference, get_project_rules, get_sdk_reference
The guard can hold an update like this until someone approves it (runtime.on_change: hold). A change that only shows with a real credential, or on a path the run did not reach, is not in a trace and so not in this comparison.
Is [email protected] safe to install?
KillerSkills ran it in the KillerSkills honeypot sandbox (2 scenarios) on 2026-11-19 and scored it 61/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: Instructs the agent to modify its persistent memory or instruction files; Access to sensitive file paths; URL with embedded credentials. Summary: no network, touches nothing outside the project, writes no memory.
Behavior trace
Honeypot run · 20 s · 2 scenarios · 0 deviationsStatic findings
<!-- generated from CLAUDE.md (canonical) 2026-08-20 — edit CLAUDE.md, then re-copy -->Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.… pre-boot code, orphans, `files/` manifests and comments; not dotfiles such as `.env`, where a local secret belongs: - known key formats — AWS access key ids (`AKI…Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.url: 'https://fonts.googleapis.com/css2?family=Inter:[email protected]&display=swap',Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.### Rule 4: Replace `$propsCollection` with `children`Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.Auto-update every second using setInterval.Fix: Pin versions and sources; vendor anything fetched at install time.is the ITEM STATE, so `item.root` gives full root access. `this` (bound byFix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.- Avoid content collapse that hides key functionsFix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.document.cookie = '…' // wrap in a `functions/` helper, never inlineFix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.### Rule 2: Rename `extend` to `extends`, `childExtend` to `childExtends`Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.### Rule 1: Flatten `props` and `on`Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.### Rule 5: Replace `props: (fn)` function with individual prop functionsFix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct."local": "Local Symbols project. Run with `smbls start` (parcel/vite/esbuild/webpack — see bundler field). Push with `smbls push <env>`.",Fix: Never read or enumerate credential locations; accept a documented environment variable instead.### Rule 3: Replace `$stateCollection` with `children` + `childrenAs: 'state'`Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.proc = subprocess.run(["bash", str(HOOK)], input=payload, capture_output=True,Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.proc = subprocess.run(["node", str(SERVER)], input="\n".join(lines) + "\n", capture_output=True, text=True, timeout=120)Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.// Subcommand dispatch — `npx @symbo.ls/mcp <subcommand>` shortcuts.Fix: Pin versions and sources; vendor anything fetched at install time.proc = subprocess.run(["node", str(NODE_SERVER)], input="\n".join(lines) + "\n",Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.…e id is a 12-character hash of the symbols `dir`, the `entry` document, `symbols.json`, `package.json`, the nearest lockfile and the CLI version. An id that does not match `/^[A-Za-z0-9._-]{1,22}$/` stops the build before Parcel starts. Th…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why."`.claude/hooks/`, suggest the user run `npx @symbo.ls/mcp init-rules` (or equivalent) to drop "Fix: Pin versions and sources; vendor anything fetched at install time.… `brender.paths` lists addresses for them. Both run one route loop: the `symbols.json` `brender` settings (`context`, `exclude`, `paths`, `strict`, `eagerImages`, `timeout`, `stamp`), `file:` URLs mapped into the output, and the same diagn…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.proc = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.…e project loads are resolved; `"frank": { "importMetaUrls": "all" }` in `symbols.json` also resolves calls inside function bodies and in `app.js`. `smbls frank to-json` inlines such files as `data:` URLs and never uploads; `sync`, `collab`…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.console.log(` • PostToolUse runs frank-audit + FA-rule check after every JS edit`)Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.…out a verified project id (run `smbls push` or `smbls sync` first to stamp `lock.json`). Its websocket handshake then names the project by `projectId` **and** `owner` (from `symbols.json`'s `owner` field) as a backstop — never a bare key, …Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.proc = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.npx -y @symbo.ls/mcp init-rules --force # overwrite existing filesFix: Pin versions and sources; vendor anything fetched at install time.npx -y @symbo.ls/mcp init-rules # idempotent; project-levelFix: Pin versions and sources; vendor anything fetched at install time.proc = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.console.log(` Disable individually: SYMBOLS_MCP_REQUIRE_RULES=0 / SYMBOLS_MCP_REMINDER=0 / SYMBOLS_MCP_POST_AUDIT=0`)Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.proc = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.…r to explicit deps ``` Both `smbls init` and `smbls create` automatically run `npx -y @symbo.ls/mcp init-rules` at the end of scaffolding — drops `CLAUDE.md`, `AGENT…Fix: Pin versions and sources; vendor anything fetched at install time.npx -y @symbo.ls/mcp init-rules --global # user-global ~/.claude/ insteadFix: Pin versions and sources; vendor anything fetched at install time.### Admin overridesFix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.- Reverse with: \`smbls frank to-fs data.json -o ./output\` or \`toFS(data, './output')\`Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.npx -y -p @symbo.ls/mcp symbols-audit --json ./symbolsFix: Pin versions and sources; vendor anything fetched at install time.r = subprocess.run([server.FRANK_AUDIT_BIN, "help"], capture_output=True, text=True, timeout=60)Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.… `globalThis.`, `document.title`, `document.body`, `document.documentElement`, `document.cookie`, `document.createElement`, `document.querySelector`, `document.getElementById`…Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.…ll')` in a handler). A package nothing declares still fails to resolve (`package.json` dependencies never reach the platform's importmap), and a value computed from such a stub while the project loads fails the build (`FRANK_UNINSTALLED_…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.Then restart any active dev server. Don't kill the portless proxy onFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.npx -y -p @symbo.ls/mcp symbols-audit ./symbolsFix: Pin versions and sources; vendor anything fetched at install time.proc = subprocess.run(["node", str(SERVER)], input="\n".join(lines) + "\n",Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.proc = subprocess.run(["node", str(RUNNER), TREE], capture_output=True, text=True, timeout=300)Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.proc = subprocess.run(["node", str(NODE_SERVER)], input="\n".join(lines) + "\n",Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.npx @symbo.ls/cli <command>Fix: Pin versions and sources; vendor anything fetched at install time.result = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.chmod +x bin/symbols-mcp.jsFix: Request the narrowest permission that works; replace wildcards with the exact paths or hosts.proc = subprocess.run(["node", str(NODE_SERVER)], input="\n".join([json.dumps(init), *lines]) + "\n",Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.proc = subprocess.run(["node", str(NODE_SERVER)], input="\n".join(lines) + "\n",Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.r = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.> - From a shell (CI / pre-commit): `npx -y -p @symbo.ls/mcp symbols-audit ./symbols`Fix: Pin versions and sources; vendor anything fetched at install time.output += "- Reverse with: `smbls frank to-fs data.json -o ./output` or `toFS(data, './output')`\n"Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.proc = subprocess.run(["node", str(NODE_SERVER)], input="\n".join(lines) + "\n",Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.npx -y -p @symbo.ls/mcp symbols-audit --strict ./symbolsFix: Pin versions and sources; vendor anything fetched at install time.…--strict`, `--out-dir <dir>`, `--bundler`. `build` copies `public/` (or `symbols.json` `publicDir`) into the output root and never replaces a file the bundler wrote. With brender on, `build` pre-…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.├── after.snapshot.json # post-audit metrics (final iteration)Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.- `npx -y @symbo.ls/mcp init-rules` — (re)install these rules + skills for every detected agentFix: Pin versions and sources; vendor anything fetched at install time.npx -y -p @symbo.ls/mcp symbols-audit ./symbolsFix: Pin versions and sources; vendor anything fetched at install time.… installed package still bundles inline; an undeclared one still fails (`package.json` dependencies do not count); a value computed from the stub while the project loads fails with `FRANK_UNINSTALLED_DEPENDENC…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.npx runs the bin whose name is the package name without its scope (`mcp`);Fix: Pin versions and sources; vendor anything fetched at install time."""`npx @symbo.ls/mcp <subcommand>` needs a bin named after the package.Fix: Pin versions and sources; vendor anything fetched at install time.# restart only the app's direct Parcel port (NEVER kill :1355 — that's the shared portless proxy)Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.> If `symbols-mcp` is not registered in your MCP config, see the project's SETUP.md (or `npx @symbo.ls/mcp` to start the server). Without the MCP, every code suggestion is guesswork.Fix: Pin versions and sources; vendor anything fetched at install time.…`mcp__symbols-mcp__audit_project()` to get the multi-phase playbook, pair with `npx -y -p @symbo.ls/mcp symbols-audit ./symbols` (the CLI), iterate until convergence …Fix: Pin versions and sources; vendor anything fetched at install time.2. **Cloudflare Worker**: `npx wrangler deploy` (edge deployment)Fix: Pin versions and sources; vendor anything fetched at install time.("../../etc/passwd.js", "components/cardProps.js"),Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose../symbols` and `npx -y @symbo.ls/mcp init-rules`, as documented, failed.Fix: Pin versions and sources; vendor anything fetched at install time.smbls frank to-fs project.json -o ./outputFix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.… When editing any project whose published artifact is a frank-bundled JSON (`app.json` or the referenced data inside `symbols.json`), the compiled JSON becomes stale on every source edit. **Always run `frank` to recompile** after any edit …Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.5. Full audit: `audit_project()` playbook + `npx -y -p @symbo.ls/mcp symbols-audit ./symbols` CLI.Fix: Pin versions and sources; vendor anything fetched at install time.out = server.audit_component(COMPONENT_FILE, file_path="../../etc/passwd.js")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.…m '../<app>/symbols/context.js'` - `smbls libs link` reads the target's `symbols.json` to compute the right import path. Pre-3.14.35 CLI ignored `dir` and hardcoded `<targetRoo…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.User-facing reads + admin CRUD. Full recipes (kill switch, allowlist,Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.named bins stay for `npx -p @symbo.ls/mcp <bin>` and global installs.Fix: Pin versions and sources; vendor anything fetched at install time.…rocessed config and the global CSS). The build writes it once as `smbls-ds.<sha>.json` next to the bundles and puts `<link rel="preload" as="fetch" data-smbls="design-system">` into every page it pre-renders (their boot waits for it). The …Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.@pytest.mark.parametrize("bad", ["../../etc/passwd.js", "functions/../../x.js", ".."])Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.npx = bin_dir / "npx"Fix: Pin versions and sources; vendor anything fetched at install time.determine executable to run" — so `npx -y @symbo.ls/mcp symbols-auditFix: Pin versions and sources; vendor anything fetched at install time.Cost to the agent
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 symbols-mcp@3.14.786 as of 18 h ago. This is the package itself, not its dependencies.
What would make this Verified
19 points to 80 · weights: behavior 45%, static 25%, prompt 15%, publisher 15%- Text that tells the agent to ignore its instructions≈ +9 on the totalDelete phrases like "ignore previous instructions", "override", "bypass" from SKILL.md and tool descriptions. Describe what the skill does; do not instruct the agent about other rules.
- 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.
- 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.
- URL with embedded credentials≈ +4 on the totalStop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
- Auto-update or dynamic fetch configuration≈ +4 on the totalPin versions and sources; vendor anything fetched at install time.
- document.cookie access≈ +4 on the totalReplace encoded or assembled strings with plain literals and remove undeclared network calls.