# Skwirl (remote · skwirl.app)

Search saved Instagram, YouTube and X reels and posts as notes from Claude and ChatGPT.

- Trust score: 74/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `skwirl.app`: 74/100 (this document), [markdown](https://verifymcp.io/servers/parthuss-skwirl/skwirl.md), [page](https://verifymcp.io/servers/parthuss-skwirl/skwirl)

## Channel facts

- Endpoint: `https://skwirl.app/mcp`
- Transports: `streamable-http`
- Auth: `required`
- Version: `0.2.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, 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-11-21.

- **Endpoint Security**: 83/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS enforcement could not be verified: the plaintext port answered with HTTP 401, which proves neither a plaintext path nor enforcement.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 69/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1533 tokens (~219/item across 7 items; 7 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 check failed: schema churn in the 5 days we've observed: 0 tool removals, 3 breaking changes, 0 auth/transport breaks, 0 additions.
- **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.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 7 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 8 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 Skwirl MCP server?

Skwirl is a hosted endpoint at https://skwirl.app/mcp, so there is nothing to install locally. 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 --transport http parthuss-skwirl 'https://skwirl.app/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "parthuss-skwirl": {
      "url": "https://skwirl.app/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "parthuss-skwirl": {
      "type": "http",
      "url": "https://skwirl.app/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.parthuss-skwirl]
url = "https://skwirl.app/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "parthuss-skwirl": {
      "type": "remote",
      "url": "https://skwirl.app/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add parthuss-skwirl --url 'https://skwirl.app/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  parthuss-skwirl:
    url: "https://skwirl.app/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "parthuss-skwirl": {
      "Transport": "http",
      "Url": "https://skwirl.app/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add parthuss-skwirl -t streamable-http -u 'https://skwirl.app/mcp'
```

### Other

```json
{
  "mcpServers": {
    "parthuss-skwirl": {
      "type": "http",
      "url": "https://skwirl.app/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## 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-11-19 (score 74, +3)

- [security regression] Stability: 0.07 → fail
- [security regression] A breaking change shipped without a version bump: still 0.2.1
- [security improvement] HSTS header: fail → pass
- [security] Tool “get_stash_note” rewrote its description, which is the text the model reads
- [security] Tool “list_stash_mentions” rewrote its description, which is the text the model reads
- [security] Tool “list_stash_topics” rewrote its description, which is the text the model reads
- [security] Tool “mark_stash_used” rewrote its description, which is the text the model reads
- [security] Tool “recent_stash” rewrote its description, which is the text the model reads
- [security] Tool “save_link” rewrote its description, which is the text the model reads
- [security] Tool “search_stash” rewrote its description, which is the text the model reads
- [security] Tool “mark_stash_used” is now declared destructive
- [functional regression] Schema quality: pass → fail
- [functional regression] “list_stash_mentions” changed the type of “limit”: number → integer
- [functional regression] “recent_stash” changed the type of “limit”: number → integer
- [functional regression] “search_stash” changed the type of “limit”: number → integer
- [functional improvement] Tool coverage: 60% → 100%
- [functional improvement] Tool “get_stash_note” now declares an output schema
- [functional improvement] Tool “list_stash_mentions” now declares an output schema
- [functional improvement] Tool “list_stash_topics” now declares an output schema
- [functional improvement] Tool “mark_stash_used” now declares an output schema
- [functional improvement] Tool “recent_stash” now declares an output schema
- [functional improvement] Tool “save_link” now declares an output schema
- [functional improvement] Tool “search_stash” now declares an output schema
- [functional] First check of Tool coverage: 100
- [functional] Schema quality: good → excellent
- [cosmetic] “get_stash_note” reworded the description of “note_id”
- [cosmetic] “list_stash_mentions” reworded the description of “kind”
- [cosmetic] “list_stash_mentions” reworded the description of “limit”
- [cosmetic] “mark_stash_used” reworded the description of “note_id”
- [cosmetic] “recent_stash” reworded the description of “limit”
- [cosmetic] “save_link” reworded the description of “note”
- [cosmetic] “save_link” reworded the description of “url”
- [cosmetic] “search_stash” reworded the description of “limit”
- [cosmetic] “search_stash” reworded the description of “query”
- [cosmetic] “search_stash” reworded the description of “status”

### 2026-11-17 (score 71, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-11-16 (score 70)

First indexed and scored.

## MCP tools (7)

### `search_stash` (~252 tokens)

Search the connected user's Skwirl saves by keyword and meaning before work or planning, or to recover something they saved. Read-only: returns relevance-ordered compact hits with title, summary (up to 140 characters), note ID, date, topic, status and tools, or 'No matching saves.' Use concept words in query; limit is 1–20 (default 5), and optional status is unused or used. Open a relevant ID with get_stash_note; use recent_stash for newest saves or list_stash_mentions for named entities. Usage examples: search_stash({"query":"weeknight pasta","limit":5}); search_stash({"query":"agent memory","status":"unused"}). Returns text (also in structuredContent.text).

Input parameters:

- `limit` (integer): Integer result count from 1 to 20; defaults to 5. Example: 5.
- `query` (string, required): Nonempty string of concept words, names or the underlying problem, up to 200 characters. Try a second query if the first is weak. Example: weeknight pasta.
- `status` (string): Optional exact status string: unused or used; omit for all saves. Example: unused.

Output parameters:

- `text` (string): Tool result as human-readable text or Markdown, including empty-result and operation status messages.

### `get_stash_note` (~193 tokens)

Read one Skwirl note by its exact note_id from search_stash, recent_stash or list_stash_mentions. Returns stored Markdown including summary, next step, transcript and source permalink when available; a missing or inaccessible ID returns a no-match message. Each successful call increments the note's open counter, so repeated reads have an additional side effect. Use search_stash to find relevant notes, recent_stash to browse newest saves, or list_stash_mentions to find named entities before opening one. Usage examples: get_stash_note({"note_id":"a1b2c3d4e5f67890"}). Returns text (also in structuredContent.text).

Input parameters:

- `note_id` (string, required): Nonempty string ID returned by search_stash, recent_stash or list_stash_mentions; use it verbatim. Example: a1b2c3d4e5f67890.

Output parameters:

- `text` (string): Tool result as human-readable text or Markdown, including empty-result and operation status messages.

### `recent_stash` (~166 tokens)

List the connected user's newest Skwirl saves, newest creation date first. Recent means the latest limit notes across all time, with no time window: limit is 1–20, default 5. Read-only; returns compact hits with title, summary (up to 140 characters), note ID, date, topic, status and tools, or 'No matching saves.' Use for browsing recent additions; use search_stash for relevance, list_stash_mentions for named entities, and get_stash_note for a full note. Usage examples: recent_stash({"limit":5}); recent_stash({}). Returns text (also in structuredContent.text).

Input parameters:

- `limit` (integer): Integer result count from 1 to 20; defaults to 5. Example: 5.

Output parameters:

- `text` (string): Tool result as human-readable text or Markdown, including empty-result and operation status messages.

### `list_stash_topics` (~109 tokens)

List topics in the connected user's Skwirl library with note counts, highest count first; ties have no guaranteed order. Read-only and takes no parameters. Returns text lines in topic: count form, or 'No saves yet.' Use to understand the library's subject mix before search_stash; use list_stash_mentions for named books, places or other entities, or recent_stash for newest notes. Usage examples: list_stash_topics({}). Returns text (also in structuredContent.text).

Output parameters:

- `text` (string): Tool result as human-readable text or Markdown, including empty-result and operation status messages.

### `list_stash_mentions` (~223 tokens)

List named entities across the connected user's Skwirl saves, rather than the posts' main topics. Read-only; optionally filter kind and set limit from 1–200 (default 50). Returns text entries with name, type, done flag when present, newest source-note title/ID and repeat count when present. Entities are deduplicated by type/name and ordered by newest source note first; ties have no guaranteed order. Returns an empty-result message if none. Use for saved books, places or people; use search_stash for concepts and get_stash_note for source details. Usage examples: list_stash_mentions({"kind":"book","limit":50}); list_stash_mentions({}). Returns text (also in structuredContent.text).

Input parameters:

- `kind` (string): Optional entity type string, one of book, movie, show, podcast, place, product, person, other; omit for all types. Example: book.
- `limit` (integer): Integer result count from 1 to 200; defaults to 50. Example: 50.

Output parameters:

- `text` (string): Tool result as human-readable text or Markdown, including empty-result and operation status messages.

### `save_link` (~231 tokens)

Queue a supported Instagram, Facebook, YouTube or X link in Skwirl. Requires an authenticated Skwirl connection and the user's intent to save the link; do not use just to read it. Writes a capture for asynchronous processing; success says the note should be ready in a few minutes, not that it is ready now. An existing normalized link in this account returns 'Already saved.' without replacing its reminder. Unsupported links, permission/plan restrictions or queue limits return explanatory failure text. Use search_stash or recent_stash to find a processed note later. Usage examples: save_link({"url":"https://www.instagram.com/reel/ABC123/","note":"Try this recipe"}). Returns text (also in structuredContent.text).

Input parameters:

- `note` (string): Optional free-text string, up to 500 characters, explaining why the user wants to save this link; omit if not supplied. Example: Try this recipe.
- `url` (string, required): HTTPS URL string for a supported Instagram, Facebook, YouTube or X post. Example: https://www.instagram.com/reel/ABC123/.

Output parameters:

- `text` (string): Tool result as human-readable text or Markdown, including empty-result and operation status messages.

### `mark_stash_used` (~208 tokens)

Record that a Skwirl note shaped the user's work, decision or action; call after applying it, rather than merely reading it. Uses an exact note_id from search_stash, recent_stash or list_stash_mentions. Sets status to used and replaces used_at with the current timestamp; tracks use and changes status-filter results, with no search-ranking boost. Repeating keeps status used but refreshes the timestamp, so it is not fully idempotent. Returns 'Marked as used.' or a no-match message for a missing or inaccessible ID; note content is retained. Usage examples: mark_stash_used({"note_id":"a1b2c3d4e5f67890"}). Returns text (also in structuredContent.text).

Input parameters:

- `note_id` (string, required): Nonempty string ID returned by search_stash, recent_stash or list_stash_mentions; use it verbatim. Example: a1b2c3d4e5f67890.

Output parameters:

- `text` (string): Tool result as human-readable text or Markdown, including empty-result and operation status messages.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/parthuss-skwirl/skwirl#diagnostics

## Score history

- 2026-11-21: 74
- 2026-11-20: 74
- 2026-11-19: 74
- 2026-11-18: 71
- 2026-11-17: 71
- 2026-11-16: 70

## Common questions

### What is the Skwirl MCP server?

Skwirl is an MCP server listed in the public MCP registry as io.github.Parthuss/skwirl. Search saved Instagram, YouTube and X reels and posts as notes from Claude and ChatGPT. This page covers its hosted endpoint (https://skwirl.app/mcp).

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

Skwirl scores 74 out of 100 on VerifyMCP. 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 Skwirl MCP server expose?

Skwirl exposes 7 tools: search_stash, get_stash_note, recent_stash, list_stash_topics, list_stash_mentions, and 2 more. Their descriptions and schemas cost roughly 1,382 tokens of context every time the server is loaded.

### Does the Skwirl MCP server require authentication?

Yes. Skwirl asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

### Is the Skwirl MCP server still maintained?

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

### What did VerifyMCP test on the Skwirl MCP server?

VerifyMCP ran 12 checks on Skwirl, covering TLS certificate, Authorization, HSTS header, DNSSEC and 8 more. One item could not be completed, a gap on our side rather than a finding about Skwirl: HTTPS. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://skwirl.app/mcp
- Repository: https://github.com/Parthuss/stash
- Website: https://skwirl.app/
- Changelog RSS feed: https://verifymcp.io/servers/parthuss-skwirl/skwirl.xml
- Changelog JSON feed: https://verifymcp.io/servers/parthuss-skwirl/skwirl/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/parthuss-skwirl/skwirl.json
- HTML version of this page: https://verifymcp.io/servers/parthuss-skwirl/skwirl
