Grades are a hygiene check, not a security guarantee.

MCP, MCP server

io.github.JKHeadley/moltbridge

Professional network intelligence for AI agents.

Compatibility: Not stated.

Grade C

One Medium finding. Read the findings before installing.

Graded by PlugVetRubric v2

Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.

Rescanned at commit fed7f64ef439, unchanged since the check below.

PERMISSION_SHELL_UNDECLARED

Why this grade

  • PERMISSION_SHELL_UNDECLARED Medium

    Runs shell commands that the manifest or description does not mention.

    scripts/simulation.py, line 866 subprocess.check_call([sys.executable, "-m", "pip", "install", "--user", "--break-system-packages", "neo4j", "-q"])

Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.

Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.

What was checked

Plain notes from the hygiene checks.

  • Permissions

    Concern

    requests shell access. No manifest field names shell or command execution.

    PERMISSION_SHELL_UNDECLARED

    scripts/simulation.py, line 866

    subprocess.check_call([sys.executable, "-m", "pip", "install", "--user", "--break-system-packages", "neo4j", "-q"])

  • Install and update

    Pass

    No install-time script found, and dependencies are pinned or absent.

  • Network

    Concern

    can reach a host that is not written as a fixed address.

    NETWORK_NO_FIXED_HOST

    scripts/deploy.sh, line 37

    if curl -s -o /dev/null -w "" --max-time 5 http://localhost:3040/health 2>/dev/null; then

    scripts/deploy.ts, line 242

    const req = http.request({

    scripts/health-check.sh, line 74

    http_code=$(curl -s -o /dev/null -w "%{http_code}" --max-time "$timeout" "$url" 2>/dev/null) || http_code="000"

    Show more

    scripts/health-check.sh, line 155

    live=$(curl -s --max-time 5 http://127.0.0.1:3040/version 2>/dev/null | python3 -c "import sys,json; print(json.load(sys.stdin).get('source_commit',''))" 2>/dev/null || true)

    sdk/js/src/client.ts, line 126

    const response = await fetch(`${this._baseUrl}${path}`, {

    src/index.ts, line 101

    const response = await fetch(url, {

    src/mcp/server.ts, line 209

    const req = http.request(options, (res) => {

    public/dashboard/index.html, line 424

    const res = await fetch(API_BASE + path, opts);

    public/docs.html, line 69

    fetch('/health')

    public/index.html, line 368

    fetch('/health')

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    contracts/hardhat.config.ts, line 6

    dotenv.config({ path: path.resolve(__dirname, "../.env") });

    contracts/hardhat.config.ts, line 28

    accounts: process.env.DEPLOYER_PRIVATE_KEY ? [process.env.DEPLOYER_PRIVATE_KEY] : [],

    contracts/hardhat.config.ts, line 35

    accounts: process.env.DEPLOYER_PRIVATE_KEY ? [process.env.DEPLOYER_PRIVATE_KEY] : [],

    Show more

    contracts/scripts/deploy.ts, line 76

    console.log(` 2. Set MOLTBRIDGE_SPLITTER_ADDRESS=${address} in your .env`);

    scripts/bootstrap-schema.ts, line 10

    dotenv.config({ path: path.join(__dirname, '..', '.env') });

    scripts/deploy.sh, line 25

    cp "$PROJECT_DIR/.env" "$DEPLOY_DIR/.env"

    scripts/deploy.ts, line 64

    return { name: 'Neo4j', passed: false, message: 'NEO4J_URI not set in .env', fatal: true };

    scripts/deploy.ts, line 70

    const key = process.env.MOLTBRIDGE_SIGNING_KEY;

    scripts/deploy.ts, line 110

    const envPath = path.join(ROOT, '.env');

    scripts/deploy.ts, line 113

    name: '.env file',

    scripts/deploy.ts, line 115

    message: 'No .env file. Create from .env.example',

    scripts/simulation.py, line 882

    password = env.get("NEO4J_PASSWORD", os.environ.get("NEO4J_PASSWORD", ""))

    sdk/js/src/cli.ts, line 26

    if (process.env.MOLTBRIDGE_AGENT_ID && process.env.MOLTBRIDGE_SIGNING_KEY) {

    sdk/js/src/cli.ts, line 29

    signingKey: process.env.MOLTBRIDGE_SIGNING_KEY,

    sdk/js/src/client.ts, line 80

    const signingKey = config.signingKey ?? process.env.MOLTBRIDGE_SIGNING_KEY;

    sdk/python/moltbridge/async_client.py, line 74

    _signing_key = signing_key or os.environ.get("MOLTBRIDGE_SIGNING_KEY")

  • Agent instructions

    Pass

    No instruction to ignore earlier instructions or to hide a step.

  • Obfuscation

    Note

    a file was over the read cap and was not fully read.

    OBFUSCATION_FILE_OVER_READ_CAP

    agent-learning-registry.json, line 1

    {

  • Licence

    Pass

    A licence file is present (LICENSE).

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Note

Hygiene check of commit fed7f64ef439. requests shell access. No manifest field names shell or command execution. can reach a host that is not written as a fixed address. reads a credential or environment file. a file was over the read cap and was not fully read.

Date and source

Date checked:

View source

github.com

Commit graded: fed7f64ef439a7139f5956d4e0c228b0b113e3ce

This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.

Read how this letter is chosen