io.github.solsolettidev/nats-trail

What we checked

Six static checks, weighted by risk. Every result reflects only what could be observed in the published package and repository — never intent.

• Injection surface

  pass25% of grade

  Tool descriptions/manifest scanned for instruction-injection patterns (imperatives at the model, hidden text, 'ignore previous', data-exfil URLs).

  Scanned 229 text field(s); no instruction-injection patterns found. PASS = no static red flag. A server can serve different tool descriptions at runtime (the rug-pull class), which static scanning cannot see.

• Supply chain

  warn25% of grade

  Package provenance: namespace verification, repo linkage, maintainer count, account age, postinstall scripts, typosquat distance.

  package name "@nats-trail/mcp" is edit-distance 2 from popular package "yup" (typosquat candidate); dependency "@nats-trail/core" is edit-distance 1 from popular package "cors" (typosquat candidate)

• Credential hygiene

  pass15% of grade

  How the server takes secrets (env vs plaintext config vs hardcoded); secrets appearing in tool schemas.

  No hardcoded secrets, secret-shaped tool parameters, or leaked keys found. PASS = no static red flag; static analysis cannot prove the code honors env-based secret handling at runtime.

• Permission scope

  pass15% of grade

  Declared tools vs. breadth (filesystem, network, exec); flags shell-exec and unbounded filesystem access.

  No shell-exec, unbounded/sensitive filesystem, or download-and-run primitives found in scanned source. PASS = no static red flag. Static scanning is blind to code fetched or executed at runtime.

• Version behavior

  warn10% of grade

  Diff of tool definitions between versions; new permissions or changed descriptions in a patch release (the postmark-mcp class).

  vs prior 0.4.0 (minor bump): new tool "natstrail.list_contexts" appeared; new tool "natstrail.get_connection_status" appeared; new tool "natstrail.list_audit" appeared; new tool "natstrail.list_filters" appeared; new tool "natstrail.run_filter" touches a sensitive surface (email/exec/net/fs); new tool "natstrail.list_streams" appeared; new tool "natstrail.get_stream_info" appeared; new tool "natstrail.list_consumers" appeared; new tool "natstrail.search_messages" appeared; new tool "natstrail.trace_by_key" touches a sensitive surface (email/exec/net/fs); new tool "natstrail.list_correlation_keys" appeared; new tool "natstrail.suggest_correlation_keys" appeared; new tool "natstrail.trace_by_request_id" appeared; new tool "natstrail.trace_by_correlation_id" appeared; new tool "natstrail.search_dlq" appeared; new tool "natstrail.enrich_sentry" appeared; new tool "natstrail.get_message_detail" appeared; new tool "natstrail.list_kv_buckets" touches a sensitive surface (email/exec/net/fs); new tool "natstrail.list_kv_keys" appeared; new tool "natstrail.get_kv_history" touches a sensitive surface (email/exec/net/fs); new tool "natstrail.list_object_buckets" appeared; new tool "natstrail.list_objects" appeared; new tool "natstrail.get_server_health" appeared; new tool "natstrail.list_server_connections" appeared; new tool "natstrail.discover_subjects" appeared; new tool "natstrail.reconstruct_flow" appeared; new tool "natstrail.enrich_incident" appeared; new tool "natstrail.get_health_summary" appeared.

• Transport config

  unscannable10% of grade

  Remote servers: TLS and auth mode (none/token/OAuth). Local servers: whether the manifest indicates it phones home.

  local stdio server: no remote transport or auth surface, and no phone-home/telemetry signal found in source. Absence of transport findings is NOT a safety guarantee — phone-home hosts can be constructed at runtime and defeat static analysis.