Skills/PyPI/brain-core-mcp

brain-core-mcp@0.16.1

CAUTION· not started

Publisher claims: "A memory for your Claude Code agent that survives the session: one local MCP server, five tools, a markdown vault, an eval." Observed in sandbox: no network, touches nothing outside the project, writes no memory.

Registry PyPI (MCP server)Publisher xy-claude · publishing for 21 daysInstalls 6,664Last detonated 26 min ago

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
no credential variables read in the code
Where it talks to
no vendor host named in the codeAlso githubusercontent.com, astral.sh — 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
server startup · the tool list · tool behavior

Connect it under the guard. Not started: dependency install failed; the server itself was not observed. The code names no credential variable; the guard pins the network to what the honeypot saw and logs every call.

$vet-skills run --net declared -- uvx brain-core-mcp

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

What changed since 0.13.0

vet-skills diff brain-core-mcp 0.13.0 0.16.1

In the sandbox, this version reached for nothing 0.13.0 did not. Compared from the two recorded runs, not from source.

0.13.0 was not run in the sandbox (install failed); the comparison covers what static analysis recorded only.

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; not started: dependency install failed; the server itself was not observed) on 2026-11-22 and scored it 69/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: Collects environment variables by secret-like names; URL with embedded credentials; 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.2sprocessdependency install exit 1 ·
0.2sclaimednot started: dependency install failed (exit 1); the server itself was not observed
0.2sprocessscript backend runs setup only
0.2sprocessno install scripts to re-run

Static findings

HIGH
Collects environment variables by secret-like namessrc/brain_core/models.py:79 · Collects environment variables by secret-like namesenv = {k: v for k, v in os.environ.items() if k != "ANTHROPIC_API_KEY"}Fix: Never read or enumerate credential locations; accept a documented environment variable instead.
AST03
HIGH
URL with embedded credentialssrc/brain_core/stores/vault.py:137 · URL with embedded credentials — may be phishing or credential leaking# user:password@ in a URL; a comma is not in one ("http://localhost:8080,[email protected]")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST07
MEDIUM
Python subprocess execution detectedsrc/brain_core/cron.py:510 · Python subprocess execution detectedcp = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/cli/main.py:347 · Python subprocess execution detectedcp = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/cron.py:618 · Python subprocess execution detectedcp = subprocess.run(["crontab", "-l"], capture_output=True, text=True)Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/cron.py:794 · Python subprocess execution detectedsubprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/cron.py:797 · Python subprocess execution detectedsubprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/cron.py:620 · Python subprocess execution detectedsubprocess.run(["crontab", "-"], input=merged, text=True, check=True)Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
CRITICAL
Pipe-to-shell patternsrc/brain_core/installer.py:229 · Pipe-to-shell pattern — downloads and immediately executes remote coderaise RuntimeError("uv is required: curl -LsSf https://astral.sh/uv/install.sh | sh")Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST06
MEDIUM
Python subprocess execution detectedsrc/brain_core/distill.py:152 · Python subprocess execution detectedmd = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
File type combined with upload actionsrc/brain_core/knowledge/rules.py:2 · File type combined with upload action — agent may exfiltrate local data filesmodel. A raw row keeps names as written; brain.db resolves them to entities when it computesFix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.
AST07
MEDIUM
Python subprocess execution detectedsrc/brain_core/cron.py:842 · Python subprocess execution detectedsubprocess.run(["crontab", "-"], input=after, text=True, check=True)Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Remote installer piped to shellsrc/brain_core/installer.py:229 · Remote installer piped to shellraise RuntimeError("uv is required: curl -LsSf https://astral.sh/uv/install.sh | sh")Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST07
MEDIUM
Python subprocess execution detectedsrc/brain_core/installer.py:287 · Python subprocess execution detectedsubprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Process kill commandsrc/brain_core/recall.py:350 · Process kill command — agent can terminate processesexcept Exception as e: # a broken graph net must not kill recallFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/distill.py:160 · Python subprocess execution detectedjs = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/models.py:82 · Python subprocess execution detectedp = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
LOW
Instructs the agent to modify its persistent memory or instruction filessrc/brain_core/cli/main.py:60 · Instructs the agent to modify its persistent memory or instruction files · informational: not an instruction file"""Write a whole agent: brain.yaml, CLAUDE.md, rules, skills, hooks, .mcp.json, vault."""Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
MEDIUM
Process kill commandsrc/brain_core/recall.py:229 · Process kill command — agent can terminate processesexcept Exception as e: # a dead store must not kill recallFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.
AST05
MEDIUM
npx invocation of non-well-known packagesrc/brain_core/distill.py:29 · npx invocation of non-well-known package — may execute untrusted code# an exact version: `npx -y` with a bare name runs whatever npm resolves that dayFix: Pin versions and sources; vendor anything fetched at install time.
AST06
MEDIUM
File type combined with upload actionsrc/brain_core/knowledge/reconcile.py:1 · File type combined with upload action — agent may exfiltrate local data files"""The claims tier in brain.db (M3, audit G.2): raw rows per source, and the claims computedFix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.
AST07
MEDIUM
File type combined with upload actionsrc/brain_core/knowledge/reconcile.py:205 · File type combined with upload action — agent may exfiltrate local data filesrow = self.db.fetchone("SELECT dirty, inputs FROM claims_state WHERE id = 1")Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.
AST07
MEDIUM
Python subprocess execution detectedsrc/brain_core/distill.py:214 · Python subprocess execution detectedinfo = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/installer.py:230 · Python subprocess execution detectedsubprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/installer.py:162 · Python subprocess execution detectedsubprocess.Popen( # outlives this command; the Run key starts it again at the next logonFix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/installer.py:299 · Python subprocess execution detectedsubprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/cron.py:839 · Python subprocess execution detectedcp = subprocess.run(["crontab", "-l"], capture_output=True, text=True)Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/installer.py:298 · Python subprocess execution detectedsubprocess.run(["launchctl", "bootout", f"gui/{os.getuid()}", str(p)], capture_output=True)Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/installer.py:153 · Python subprocess execution detectedsubprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/installer.py:138 · Python subprocess execution detectedsubprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/cron.py:816 · Python subprocess execution detectedcp = subprocess.run(["crontab", "-l"], capture_output=True, text=True)Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/installer.py:267 · Python subprocess execution detectedsubprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/embed.py:118 · Python subprocess execution detectedsubprocess.Popen(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/installer.py:266 · Python subprocess execution detectedsubprocess.run(["systemctl", "--user", "daemon-reload"], capture_output=True)Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
Python subprocess execution detectedsrc/brain_core/cron.py:849 · Python subprocess execution detectedsubprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05

Cost to the agent

Instructions loaded
≈277 tok
2 files · 81 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

Not checked against OSV yet; the weekly check has not reached this version.

What would make this Verified

11 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 xy-claude: a verified publisher gets +50 on publisher trust. It is free and usually instant with GitHub sign-in.
  3. Collects environment variables by secret-like names≈ +4 on the totalNever read or enumerate credential locations; accept a documented environment variable instead.
  4. 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.
  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. File type combined with upload action≈ +2 on the totalRemove the call, or declare the host in frontmatter and explain in the README what is sent and why.
Publish a new version to PyPI, then queue it here. Not your skill? Claim the handle to get verdict changes by email.Claim xy-claudePropose a patch to the maintainer