Skwirl

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

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "skwirl": {
      "url": "https://skwirl.app/mcp"
    }
  }
}

원격 엔드포인트

https://skwirl.app/mcpstreamable-http

할 수 있는 일

도구 목록

도구 (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).

입력 스키마

{
  "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"
  ]
}

출력 스키마

{
  "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).

입력 스키마

{
  "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"
  ]
}

출력 스키마

{
  "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).

입력 스키마

{
  "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
      ]
    }
  }
}

출력 스키마

{
  "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).

입력 스키마

{
  "type": "object",
  "properties": {}
}

출력 스키마

{
  "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).

입력 스키마

{
  "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
      ]
    }
  }
}

출력 스키마

{
  "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).

입력 스키마

{
  "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"
  ]
}

출력 스키마

{
  "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).

입력 스키마

{
  "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"
  ]
}

출력 스키마

{
  "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
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 7개