Skwirl is an MCP server published by io.github.Parthuss, hosted at skwirl.app. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 7 tools, including search_stash, get_stash_note, recent_stash, list_stash_topics, list_stash_mentions.
Search saved Instagram, YouTube and X reels and posts as notes from Claude and ChatGPT.
1 connections through 5 shared values. Tap any node.
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).
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Integer result count from 1 to 20; defaults to 5. Example: 5. |
| query * | string | 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. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
{
"name": "search_stash",
"description": "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).",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1,
"examples": [
5
],
"description": "Integer result count from 1 to 20; defaults to 5. Example: 5."
},
"query": {
"type": "string",
"examples": [
"weeknight pasta"
],
"maxLength": 200,
"minLength": 1,
"description": "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": {
"enum": [
"unused",
"used"
],
"type": "string",
"examples": [
"unused"
],
"description": "Optional exact status string: unused or used; omit for all saves. Example: unused."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Tool result as human-readable text or Markdown, including empty-result and operation status messages."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| note_id * | string | Nonempty string ID returned by search_stash, recent_stash or list_stash_mentions; use it verbatim. Example: a1b2c3d4e5f67890. |
{
"name": "get_stash_note",
"description": "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).",
"inputSchema": {
"type": "object",
"required": [
"note_id"
],
"properties": {
"note_id": {
"type": "string",
"examples": [
"a1b2c3d4e5f67890"
],
"minLength": 1,
"description": "Nonempty string ID returned by search_stash, recent_stash or list_stash_mentions; use it verbatim. Example: a1b2c3d4e5f67890."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Tool result as human-readable text or Markdown, including empty-result and operation status messages."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Integer result count from 1 to 20; defaults to 5. Example: 5. |
{
"name": "recent_stash",
"description": "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).",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1,
"examples": [
5
],
"description": "Integer result count from 1 to 20; defaults to 5. Example: 5."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Tool result as human-readable text or Markdown, including empty-result and operation status messages."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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).
No parameters.
{
"name": "list_stash_topics",
"description": "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).",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Tool result as human-readable text or Markdown, including empty-result and operation status messages."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| 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. |
{
"name": "list_stash_mentions",
"description": "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).",
"inputSchema": {
"type": "object",
"properties": {
"kind": {
"enum": [
"book",
"movie",
"show",
"podcast",
"place",
"product",
"person",
"other"
],
"type": "string",
"examples": [
"book"
],
"description": "Optional entity type string, one of book, movie, show, podcast, place, product, person, other; omit for all types. Example: book."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"examples": [
50
],
"description": "Integer result count from 1 to 200; defaults to 50. Example: 50."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Tool result as human-readable text or Markdown, including empty-result and operation status messages."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| url * | string | HTTPS URL string for a supported Instagram, Facebook, YouTube or X post. Example: https://www.instagram.com/reel/ABC123/. |
| 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. |
{
"name": "save_link",
"description": "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).",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"examples": [
"https://www.instagram.com/reel/ABC123/"
],
"description": "HTTPS URL string for a supported Instagram, Facebook, YouTube or X post. Example: https://www.instagram.com/reel/ABC123/."
},
"note": {
"type": "string",
"examples": [
"Try this recipe"
],
"maxLength": 500,
"description": "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."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Tool result as human-readable text or Markdown, including empty-result and operation status messages."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| note_id * | string | Nonempty string ID returned by search_stash, recent_stash or list_stash_mentions; use it verbatim. Example: a1b2c3d4e5f67890. |
{
"name": "mark_stash_used",
"description": "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).",
"inputSchema": {
"type": "object",
"required": [
"note_id"
],
"properties": {
"note_id": {
"type": "string",
"examples": [
"a1b2c3d4e5f67890"
],
"minLength": 1,
"description": "Nonempty string ID returned by search_stash, recent_stash or list_stash_mentions; use it verbatim. Example: a1b2c3d4e5f67890."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Tool result as human-readable text or Markdown, including empty-result and operation status messages."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Skwirl holds the reels and posts this person saved (Instagram, Facebook, YouTube, X) as notes: summary, next step, transcript, recipe steps, and the tools, books, movies, places and products named. They save things to use later and forget they exist, so search it without being asked at the start of work tasks (coding, design, building agents or automations, writing, client or therapy session planning, research) and when planning meals, trips, reading, workouts or purchases, before answering from general knowledge. Also search when they ask about something they saw or saved. Cite the note's title and link. If they paste a reel or post link and want to keep it, use save_link.
Names, descriptions and schemas were written by the server and are shown as data.