Grades are a hygiene check, not a security guarantee.

MCP, MCP server

dev.forgesworn/402-mcp

Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

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 fc1f3da77d0d.

SECRETS_PATH_CREDENTIAL

Why this grade

  • SECRETS_PATH_CREDENTIAL Medium

    Mentions a credential store path (~/.ssh, id_rsa, .npmrc, .aws/credentials, credentials.json, .netrc).

    examples/programmatic-usage.ts, line 21 const store = new CredentialStore('~/.402-mcp/credentials.json')

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

    Pass

    No shell or command execution found, and no extra permission was declared.

  • 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

    examples/programmatic-usage.ts, line 34

    // --- Resilient fetch (SSRF-guarded, retry, timeout) ---

    src/fetch/hns-resolve.ts, line 163

    const response = await fetch(url, {

    src/fetch/resilient-fetch.ts, line 60

    * that `fetch()` connects to the same IP that passed SSRF validation. This

    Show more

    AGENTS.md, line 117

    All outbound HTTP uses resilient fetch (timeout, retry, SSRF guard). Money-mutating POSTs pass `{ retries: 0 }` to disable retry. Polling fetches (pay.ts) also disable retry (the p

    README.md, line 101

    C --> D["4. l402-buy-credits()<br/>or l402-fetch(autoPay)"]

    README.md, line 102

    E["5. l402-fetch(url)<br/>with stored credential"]

    docs/architecture.md, line 67

    Agent->>MCP: l402-fetch(url, autoPay: true)

    docs/security.md, line 33

    For plain HTTP URLs, the resolved IP address is pinned into the fetch URL itself, so `fetch()` connects to the same IP that passed SSRF validation. This closes the DNS rebinding TO

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_CREDENTIAL SECRETS_PATH_DOTENV

    src/config.ts, line 124

    const rawHttpToken = process.env.HTTP_AUTH_TOKEN

    src/config.ts, line 125

    const httpTokenFile = process.env.HTTP_AUTH_TOKEN_FILE

    examples/programmatic-usage.ts, line 21

    const store = new CredentialStore('~/.402-mcp/credentials.json')

    Show more

    src/config.ts, line 126

    delete process.env.HTTP_AUTH_TOKEN

    src/config.ts, line 127

    delete process.env.HTTP_AUTH_TOKEN_FILE

    src/config.ts, line 156

    cashuTokensPath: process.env.CASHU_TOKENS,

    src/config.ts, line 161

    credentialStorePath: process.env.CREDENTIAL_STORE ?? defaultCredentialStore,

    src/config.ts, line 108

    const defaultCredentialStore = resolve(homedir(), '.402-mcp', 'credentials.json')

    AGENTS.md, line 34

    | `CREDENTIAL_STORE` | `~/.402-mcp/credentials.json` | Path to credential store (must be within home dir) |

    README.md, line 142

    | `CREDENTIAL_STORE` | `~/.402-mcp/credentials.json` | Persistent macaroon/credential storage. Must be within your home directory |

    README.md, line 276

    402-mcp stores credentials locally on your machine only (`~/.402-mcp/credentials.json`, encrypted at rest with AES-256-GCM). The encryption key lives in the OS keychain when one is

    REGULATORY.md, line 37

    | Credentials (macaroons, preimages) | `~/.402-mcp/credentials.json` | AES-256-GCM encryption at rest |

    .gitignore, line 13

    .env

  • Agent instructions

    Pass

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

  • Obfuscation

    Pass

    No encoded or minified payload found.

  • 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 fc1f3da77d0d. can reach a host that is not written as a fixed address. reads a credential or environment file.

Date and source

Date checked:

View source

github.com

Commit graded: fc1f3da77d0dd6d8c2aa6781ee2cfab73655a679

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