Nexlev Logo

Docs

Search documentation

Search docs by page title or heading

Swipefile

Save, organise, and manage your YouTube research directly from your AI assistant. The Swipefile tools let you create folders, save channels, videos, shorts, thumbnails, and video clips, and manage them — all through natural language without leaving your chat.

Prerequisites

  • Connected AI assistant — Claude or ChatGPT with NexLev MCP connected
  • Active NexLev accountConnect to your AI assistant to get started

Requires Lite, Pro, or Premium plan. Swipefile is not available on the Free plan.

Recommended workflow: Start by calling list_swipefile_folders to find an existing folder. If none fits, use create_swipefile_folder. Then use save_to_swipefile, forwarding rich fields (title, thumbnail, views, channel data) from other NexLev tool responses so your saved items display fully in the Swipefile UI.

Tools

list_swipefile_folders

List all swipefile folders you own or have been shared into. Use this as the first step before saving anything — pick an existing folder rather than creating a new one each time.

Example prompts:

List my swipefile folders
Show me all my research folders
Do I have a folder for finance channel research?

What it returns:

FieldDescription
id, nameFolder identity
privacySettingsPublic / private setting
savedItemsTotal number of items saved in the folder
isOwnerWhether you are the owner or a shared collaborator

Parameters: None required. Returns all accessible folders for the authenticated user.

Troubleshooting

ACCESS DENIED on every call

  • Swipefile requires LITE plan or higher. Upgrade your plan in the dashboard.
  • API key callers are blocked — swipefile is OAuth-only. Make sure you're connected via OAuth (see Quickstart).

Saved item not showing in the UI

  • You likely saved a video/short/thumbnail without a ytChannelId. The listing aggregation joins items through their parent channel — items with no channel record are silently dropped from listings.
  • Re-save with ytChannelId included. Call youtube_video_details or channel_resolver to get the channel ID if you don't have it.

You can only modify swipefile items you created yourself

  • Update, move, and delete are restricted to the creator of each item. Ask the item's creator to make the change, or use list_swipefile_items to confirm ownership.

AUTH_REQUIRED error

  • Your OAuth session has expired. Re-authenticate by running /mcp → select nexlevAuthenticate in your CLI, or reconnect via the AI assistant's connector settings.

Quota limit reached

Rate Limits

Swipefile is available on Lite, Pro, and Premium plans only — Free plan users do not have access.

Tool & DescriptionFreeLitePro
List swipefile folderslist_swipefile_folders0200500
List swipefile itemslist_swipefile_items0200500
Get folder insightsget_swipefile_folder_insights0100300
Save to swipefilesave_to_swipefile0100300
Update swipefile itemupdate_swipefile_item050200
Move swipefile itemmove_swipefile_item030100
Delete swipefile itemdelete_swipefile_item030100
Create swipefile foldercreate_swipefile_folder02050

Per user · resets every 24 hours

Upgrade to Pro →

What's Next?