# io.github.shotintoeternity/pocketnook (npm · @pocketnook/mcp)

Deploy repositories or local folders to private Pocketnook URLs from any MCP client.

- Trust score: 70/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-17

## Components

- npm · `@pocketnook/mcp`: 70/100 (this document), [markdown](https://verifymcp.io/servers/shotintoeternity-pocketnook/pocketnook-mcp.md), [page](https://verifymcp.io/servers/shotintoeternity-pocketnook/pocketnook-mcp)

## Channel facts

- Registry: `npm`
- Package: `@pocketnook/mcp`
- Version: `0.1.0`
- 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-17.

- **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**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 3 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 79/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 663 tokens (~132/item across 5 items; 5 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **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.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add shotintoeternity-pocketnook -- npx -y @pocketnook/mcp
```

### Codex

```bash
codex mcp add shotintoeternity-pocketnook -- npx -y @pocketnook/mcp
```

### opencode

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

### OpenClaw

```bash
openclaw mcp add shotintoeternity-pocketnook --command npx --arg -y --arg @pocketnook/mcp
```

### Hermes

```yaml
mcp_servers:
  shotintoeternity-pocketnook:
    command: "npx"
    args: ["-y", "@pocketnook/mcp"]
```

### Other

```json
{
  "mcpServers": {
    "shotintoeternity-pocketnook": {
      "command": "npx",
      "args": [
        "-y",
        "@pocketnook/mcp"
      ]
    }
  }
}
```

## 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-13 (score 70)

First indexed and scored.

## MCP tools (5)

### `deploy` (~143 tokens)

Deploy a GitHub repository to a private pocketnook URL and return that URL. With no arguments it deploys the repository the current directory belongs to. pocketnook clones the tip of the default branch from GitHub, so uncommitted or unpushed work is not included — the result says so when that is the case. Redeploying the same repository reuses its existing nook and URL.

Input parameters:

- `directory` (string): Working copy to read the remote from. Defaults to the current directory.
- `repo` (string): The repository to deploy, as "owner/repo" or a GitHub URL. Omit to use the current directory’s origin remote.

### `deploy_directory` (~162 tokens)

Deploy a directory exactly as it is on this machine to a private pocketnook URL, with no git repository required — this uploads the files from disk, including uncommitted work. Use this when there is no repository, or when the local files are what should be deployed; use `deploy` to build what is pushed to GitHub instead. Everything in the directory is sent apart from node_modules, .git and build caches, so any credentials sitting in it go too. Deploying the same nook name again replaces what is there.

Input parameters:

- `directory` (string): The project directory to upload. Defaults to the current directory.
- `name` (string): The nook to deploy to. Deploying the same name again updates that nook. Defaults to the directory name.

### `list_nooks` (~40 tokens)

List the nooks this account has deployed: name, URL, status, and whether each is private or link-visible. Reads only — it changes nothing.

### `nook_logs` (~74 tokens)

Show the build output for a nook — the first thing to read when a deploy failed or produced the wrong thing. Reads only — it changes nothing.

Input parameters:

- `lines` (number): How many trailing lines to show. Default 30.
- `nook` (string, required): A nook id, or the repository name like owner/repo.

### `stop_nook` (~52 tokens)

Stop serving a nook. The URL, its grants, and its secrets are kept, so deploying again brings it back.

Input parameters:

- `nook` (string, required): A nook id, or the repository name like owner/repo.

## Diagnostics

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

## Score history

- 2026-08-17: 70
- 2026-08-16: 70
- 2026-08-15: 70
- 2026-08-14: 70
- 2026-08-13: 70

## Links

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