# keyshroud (npm · keyshroud)

Agent-safe secrets from self-hosted Vaultwarden/Bitwarden: injected into commands, masked in output

- Trust score: 82/100 (high trust)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-18

## Components

- npm · `keyshroud`: 82/100 (this document), [markdown](https://verifymcp.io/servers/dinhkarate-keyshroud/keyshroud.md), [page](https://verifymcp.io/servers/dinhkarate-keyshroud/keyshroud)

## Channel facts

- Registry: `npm`
- Package: `keyshroud`
- Version: `0.6.2`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-18.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - No production dependencies, so there is no dependency health to assess.
- **Provenance & Transparency**: 100/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to dinhkarate/keyshroud).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 70/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 333 tokens (~83/item across 4 items; 4 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 10/100
  - Stability observed for 3 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 4 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 5 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the keyshroud MCP server?

keyshroud runs locally as an npm package, launched with npx -y keyshroud. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add dinhkarate-keyshroud -- npx -y keyshroud
```

### Cursor

```json
{
  "mcpServers": {
    "dinhkarate-keyshroud": {
      "command": "npx",
      "args": [
        "-y",
        "keyshroud"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "dinhkarate-keyshroud": {
      "command": "npx",
      "args": [
        "-y",
        "keyshroud"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add dinhkarate-keyshroud -- npx -y keyshroud
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dinhkarate-keyshroud": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "keyshroud"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add dinhkarate-keyshroud --command npx --arg -y --arg keyshroud
```

### Hermes

```yaml
mcp_servers:
  dinhkarate-keyshroud:
    command: "npx"
    args: ["-y", "keyshroud"]
```

### Netclaw

```json
{
  "McpServers": {
    "dinhkarate-keyshroud": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "keyshroud"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add dinhkarate-keyshroud -t stdio -c npx -a -y keyshroud
```

### Other

```json
{
  "mcpServers": {
    "dinhkarate-keyshroud": {
      "command": "npx",
      "args": [
        "-y",
        "keyshroud"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-18 (score 82, +15)

- [security regression] Stability: 0.07 → unverified
- [security regression] Tool safety: pass → unverified
- [security improvement] Malware scan: unverified → pass
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional] Package version: 0.6.0 → 0.6.1

### 2026-10-17 (score 67, −14)

- [security regression] Malware scan: pass → unverified
- [functional improvement] Stability: unverified → 0.07
- [functional] Package version: 0.5.3 → 0.6.0

### 2026-10-15 (score 81, +41)

- [security improvement] Injection markers: unverified → pass
- [security improvement] Provenance: fail → pass
- [security] First check of Judged manipulation: pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [security] The attested source repository moved: dinhkarate/keyshroud
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] MCP protocol: unverified → pass
- [functional] First check of Schema quality: fail
- [functional] First check of Destructive annotations: pass
- [functional] First check of Schema quality: pass
- [functional] First check of Schema quality: good
- [functional] First check of Tool coverage: 100
- [functional] Package version: 0.5.1 → 0.5.3
- [functional] Package version: 0.5.1 → 0.5.2

### 2026-10-14 (score 40)

First indexed and scored.

## MCP tools (4)

### `secrets_list` (~39 tokens)

List the names of secrets wired for this machine. Never returns values.

Input parameters:

- `env_file` (string): Optional dotenv file of bw:// references to include

### `secrets_run` (~121 tokens)

Run a shell command with vault secrets injected as environment variables. Secret values in stdout/stderr are replaced with <redacted:NAME>. Reference secrets as $NAME inside the command; never echo them.

Input parameters:

- `command` (string, required): Shell command run with /bin/sh -c
- `cwd` (string): Working directory
- `env_file` (string): Dotenv file of bw:// references to add
- `only` (array): Inject only these names
- `timeout_ms` (number): Kill the command after this many milliseconds (default 120000)

### `secrets_request` (~103 tokens)

Ask the human to store a new secret. Opens a native hidden-input dialog on the user's desktop and stores the value in the vault; where no dialog can be shown, returns a terminal command for the user to run instead. The value never passes through the conversation.

Input parameters:

- `env_name` (string, required): UPPER_SNAKE_CASE variable name
- `item_name` (string, required): Vault item name to create
- `purpose` (string): Short note stored with the item

### `vault_status` (~23 tokens)

Report vault lock state, server, and item count. Never returns values.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/dinhkarate-keyshroud/keyshroud#diagnostics

## Score history

- 2026-10-18: 82
- 2026-10-17: 67
- 2026-10-16: 81
- 2026-10-15: 81
- 2026-10-14: 40

## Common questions

### What is the keyshroud MCP server?

keyshroud is an MCP server listed in the public MCP registry as io.github.dinhkarate/keyshroud. Agent-safe secrets from self-hosted Vaultwarden/Bitwarden: injected into commands, masked in output. This page covers its npm package (keyshroud).

### Is the keyshroud MCP server safe to use?

keyshroud scores 82 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 18 October 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the keyshroud MCP server expose?

keyshroud exposes 4 tools: secrets_list, secrets_run, secrets_request, vault_status. Their descriptions and schemas cost roughly 286 tokens of context every time the server is loaded.

### Is the keyshroud MCP server still maintained?

keyshroud is still listed as active in the MCP registry. We last reached this channel on 18 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the keyshroud MCP server under?

keyshroud declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/keyshroud
- Socket report: https://socket.dev/npm/package/keyshroud
- Repository: https://github.com/dinhkarate/keyshroud
- Website: https://keyshroud.dev/
- Changelog RSS feed: https://verifymcp.io/servers/dinhkarate-keyshroud/keyshroud.xml
- Changelog JSON feed: https://verifymcp.io/servers/dinhkarate-keyshroud/keyshroud.json
- HTML version of this page: https://verifymcp.io/servers/dinhkarate-keyshroud/keyshroud