Skwirl
Search saved Instagram, YouTube and X reels and posts as notes from Claude and ChatGPT.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"skwirl": {
"url": "https://skwirl.app/mcp"
}
}
}Puntos de conexión remotos
https://skwirl.app/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (7)
🟢search_stash(query, status, limit)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"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.",
"examples": [
"weeknight pasta"
]
},
"status": {
"type": "string",
"enum": [
"unused",
"used"
],
"description": "Optional exact status string: unused or used; omit for all saves. Example: unused.",
"examples": [
"unused"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 5,
"description": "Integer result count from 1 to 20; defaults to 5. Example: 5.",
"examples": [
5
]
}
},
"required": [
"query"
]
}Esquema de salida
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Tool result as human-readable text or Markdown, including empty-result and operation status messages."
}
},
"required": [
"text"
],
"additionalProperties": false
}🟢get_stash_note(note_id)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"note_id": {
"type": "string",
"minLength": 1,
"description": "Nonempty string ID returned by search_stash, recent_stash or list_stash_mentions; use it verbatim. Example: a1b2c3d4e5f67890.",
"examples": [
"a1b2c3d4e5f67890"
]
}
},
"required": [
"note_id"
]
}Esquema de salida
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Tool result as human-readable text or Markdown, including empty-result and operation status messages."
}
},
"required": [
"text"
],
"additionalProperties": false
}🟢recent_stash(limit)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 5,
"description": "Integer result count from 1 to 20; defaults to 5. Example: 5.",
"examples": [
5
]
}
}
}Esquema de salida
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Tool result as human-readable text or Markdown, including empty-result and operation status messages."
}
},
"required": [
"text"
],
"additionalProperties": false
}🟢list_stash_topics
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).
Esquema de entrada
{
"type": "object",
"properties": {}
}Esquema de salida
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Tool result as human-readable text or Markdown, including empty-result and operation status messages."
}
},
"required": [
"text"
],
"additionalProperties": false
}🟢list_stash_mentions(kind, limit)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"book",
"movie",
"show",
"podcast",
"place",
"product",
"person",
"other"
],
"description": "Optional entity type string, one of book, movie, show, podcast, place, product, person, other; omit for all types. Example: book.",
"examples": [
"book"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"default": 50,
"description": "Integer result count from 1 to 200; defaults to 50. Example: 50.",
"examples": [
50
]
}
}
}Esquema de salida
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Tool result as human-readable text or Markdown, including empty-result and operation status messages."
}
},
"required": [
"text"
],
"additionalProperties": false
}🟡save_link(url, note)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "HTTPS URL string for a supported Instagram, Facebook, YouTube or X post. Example: https://www.instagram.com/reel/ABC123/.",
"examples": [
"https://www.instagram.com/reel/ABC123/"
]
},
"note": {
"type": "string",
"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.",
"examples": [
"Try this recipe"
]
}
},
"required": [
"url"
]
}Esquema de salida
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Tool result as human-readable text or Markdown, including empty-result and operation status messages."
}
},
"required": [
"text"
],
"additionalProperties": false
}🔴mark_stash_used(note_id)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"note_id": {
"type": "string",
"minLength": 1,
"description": "Nonempty string ID returned by search_stash, recent_stash or list_stash_mentions; use it verbatim. Example: a1b2c3d4e5f67890.",
"examples": [
"a1b2c3d4e5f67890"
]
}
},
"required": [
"note_id"
]
}Esquema de salida
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Tool result as human-readable text or Markdown, including empty-result and operation status messages."
}
},
"required": [
"text"
],
"additionalProperties": false
}Comunidad
Evidencia