# sh.objekt/mcp-upload (npm · @objekt.sh/mcp-upload)

Public file storage for AI agents. Upload files and get a permalink back.

- Trust score: 76/100 (medium)
- Change this week: +30
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@objekt.sh/mcp-upload`: 76/100 (this document), [markdown](https://verifymcp.io/servers/sh-objekt-mcp-upload/objekt-sh-mcp-upload.md), [page](https://verifymcp.io/servers/sh-objekt-mcp-upload/objekt-sh-mcp-upload)

## Channel facts

- Registry: `npm`
- Package: `@objekt.sh/mcp-upload`
- Version: `0.1.5`
- 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-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 84/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to 0xLighthouse/objekt-mcp-upload).
  - License check failed: no license is declared.
  - Actively maintained (last published 121 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 71/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 654 tokens (~109/item across 6 items; 6 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 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.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add sh-objekt-mcp-upload -- npx -y @objekt.sh/mcp-upload
```

### Codex

```bash
codex mcp add sh-objekt-mcp-upload -- npx -y @objekt.sh/mcp-upload
```

### opencode

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

### OpenClaw

```bash
openclaw mcp add sh-objekt-mcp-upload --command npx --arg -y --arg @objekt.sh/mcp-upload
```

### Hermes

```yaml
mcp_servers:
  sh-objekt-mcp-upload:
    command: "npx"
    args: ["-y", "@objekt.sh/mcp-upload"]
```

### Other

```json
{
  "mcpServers": {
    "sh-objekt-mcp-upload": {
      "command": "npx",
      "args": [
        "-y",
        "@objekt.sh/mcp-upload"
      ]
    }
  }
}
```

## 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-08-03 (score 76, +4)

- [functional improvement] Stability: unverified → 0.23

### 2026-08-02 (score 72, +67)

- [security improvement] Install scripts: unverified → pass
- [security improvement] Provenance: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [security] The attested source repository moved: 0xLighthouse/objekt-mcp-upload
- [functional regression] License: unverified → fail
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → good
- [functional improvement] Dependency health: unverified → partial

### 2026-08-01 (score 5, −16)

- [functional regression] Tool coverage: 100 → unverified

### 2026-07-31 (score 21, −7)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 28, +4)

- [security regression] Malware scan: pass → unverified
- [functional improvement] Tool coverage: unverified → 100

### 2026-07-28 (score 24, −22)

- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified

### 2026-07-27 (score 46)

First indexed and scored.

## MCP tools (6)

### `upload_file` (~252 tokens)

Upload File

Upload a file to objekt.sh storage. Accepts a host file path OR base64/raw content.

For files on the HOST filesystem (e.g. /Users/name/photo.png): use 'path' — reads from disk, fastest.
For files you have in memory: use 'content' + 'content_type'.
For files at CONTAINER paths (e.g. /mnt/user-data/): use the upload_from_sandbox tool instead.

Input parameters:

- `content` (string): File content — base64-encoded for binaries, raw UTF-8 for text. Use this when the file path is not accessible from the host filesystem.
- `content_type` (string): MIME type (required with content, e.g. 'image/png'). Auto-detected when using path.
- `encoding` (string): Content encoding. Default 'base64'. Use 'raw' for text types like SVG, HTML, CSS, JSON.
- `name` (string): Filename for the upload. Auto-detected from 'path'. Required when using 'content'.
- `path` (string): Absolute path to the file on the HOST filesystem (e.g. /Users/you/photo.png). Do NOT use container paths like /mnt/user-data/.

### `upload_from_sandbox` (~100 tokens)

Upload from Sandbox

Upload a file from a sandbox/container path (e.g. /mnt/user-data/, /home/claude/) that the host cannot access. Reads the file and uploads it directly — single tool call, no shell commands needed.

Input parameters:

- `name` (string): Custom name for the uploaded file. Defaults to the filename.
- `sandbox_path` (string, required): Path to the file inside the sandbox (e.g. /mnt/user-data/uploads/photo.png)

### `get_file` (~45 tokens)

Get File

Get a file from objekt.sh by name. Returns a link to the file without downloading the content.

Input parameters:

- `name` (string, required): File name/key (e.g. 'photo.png')

### `get_pricing` (~19 tokens)

Get Pricing

Get current storage pricing and limits from objekt.sh.

### `check_connection` (~53 tokens)

Check Connection

Test connectivity to api.objekt.sh. Use this to diagnose sandbox egress issues. If it fails, the user needs to add api.objekt.sh to their domain allowlist (Settings → Capabilities → Domain Allowlist).

### `get_version` (~19 tokens)

Get Version

Returns the installed version of the Objekt.sh MCP server.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/sh-objekt-mcp-upload/objekt-sh-mcp-upload#diagnostics

## Score history

- 2026-08-03: 76
- 2026-08-02: 72
- 2026-08-01: 5
- 2026-07-31: 21
- 2026-07-30: 28
- 2026-07-28: 24
- 2026-07-27: 46

## Links

- npm package: https://www.npmjs.com/package/@objekt.sh/mcp-upload
- Socket report: https://socket.dev/npm/package/@objekt.sh/mcp-upload
- Repository: https://github.com/0xLighthouse/objekt-mcp-upload
- Changelog RSS feed: https://verifymcp.io/servers/sh-objekt-mcp-upload/objekt-sh-mcp-upload/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/sh-objekt-mcp-upload/objekt-sh-mcp-upload/changelog.json
- HTML version of this page: https://verifymcp.io/servers/sh-objekt-mcp-upload/objekt-sh-mcp-upload
