Integration

put.io integration

put.io is a cloud downloader and storage service: it fetches files from HTTP(S) URLs and magnet links into the user's private storage, where they can be streamed or downloaded. Add, retry, cancel and clear transfers; list, search, rename, move and delete files and folders; convert videos to MP4; list and download subtitles; build ZIP links; manage RSS feeds that add transfers automatically; share files with put.io friends and manage friend requests; and read the account, its settings and its event history. Not exposed: the deprecated file routes, the file upload route (served from another host), the per-IP download URL and HLS playlist routes (their answers carry an access token), the per-app config store, the device-login routes, and the archive extraction and video-position write routes. Authentication is a put.io OAuth token: create an app at app.put.io/oauth, click the key icon next to it and copy the token from its Secrets page; it is sent in the Authorization header as token followed by the value.

Connect put.io How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in put.io.Built from the 45 put.io tools below, on the connection you add once.

What you can do with put.io

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Each badge shows the default agent permission of an endpoint (allowed: an agent calls it without asking; ask first: you are asked before an agent calls it, when the agent or chat asks permission for sensitive actions; never: no agent may call it), which every user can change endpoint by endpoint in their credential settings.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

File, 7 operations

continue_file_listContinue file listPOSTAgents: ask firstReturns the next page of a list_files result, using the cursor that list_files (or the previous call) returned, and a new cursor while more files remain.
continue_file_searchContinue file searchPOSTAgents: ask firstReturns the next page of a search_files result, using the cursor that search_files (or the previous call) returned.
delete_filesDelete filesPOSTAgents: ask firstDeletes the given files and folders (a folder with everything in it). When trash is enabled in the account settings, deleted files go to the put.io trash first.
list_filesList filesGETAgents: ask firstLists the files in one folder (not recursive; root when parent_id is left out, every file with -1), with the parent folder and a cursor for continue_file_list when per_page is set.
move_filesMove filesPOSTAgents: ask firstMoves the given files and folders into another folder.
rename_fileRename filePOSTAgents: ask firstRenames a file or folder. The new name includes the file extension.
search_filesSearch filesGETAgents: ask firstSearches the files of the account and those its friends share with it, by name. Returns matching files, the total and a cursor for continue_file_search when more remain.

Rss feed, 7 operations

create_rss_feedCreate rss feedPOSTAgents: ask firstCreates an RSS feed that put.io polls: every new item whose title matches the keywords is added as a transfer into the chosen folder. Returns the created feed.
delete_rss_feedDelete rss feedPOSTAgents: ask firstDeletes an RSS feed so put.io stops polling it.
get_rss_feedGet rss feedGETAgents: ask firstReturns one RSS feed: title, source URL, target folder, keywords, whether old files are deleted, paused state and timestamps.
list_rss_feedsList rss feedsGETAgents: ask firstLists the account's RSS feeds: id, title, source URL, target folder, keywords, whether old files are deleted, paused state and timestamps.
pause_rss_feedPause rss feedPOSTAgents: ask firstPauses an RSS feed so it is no longer polled for new items.
resume_rss_feedResume rss feedPOSTAgents: ask firstResumes a paused RSS feed so it is polled for new items again.
update_rss_feedUpdate rss feedPOSTAgents: ask firstUpdates an RSS feed. The vendor's client sends every field on each update, so read the feed with get_rss_feed first and send every field you want to keep along with the change.

Transfer, 7 operations

add_transferAdd transferPOSTAgents: ask firstStarts downloading an HTTP(S) URL or a magnet link into put.io storage and returns the new transfer. Follow progress with get_transfer; name and type may change after adding.
cancel_transfersCancel transfersPOSTAgents: ask firstCancels the given transfers: a transfer that is seeding stops seeding, any other is removed from the transfer list. Downloaded files are kept.
clean_transfersClean transfersPOSTAgents: ask firstRemoves finished transfers from the transfer list (files are kept). Leave transfer_ids out to remove every completed transfer. Returns the removed ids.
get_transferGet transferGETAgents: ask firstReturns one transfer: status (IN_QUEUE to COMPLETED, or ERROR with error_message), percent done, speeds, peers, size, source and the file_id of the downloaded result once finished.
list_transfersList transfersGETAgents: ask firstLists the account's transfers with their status (IN_QUEUE, WAITING, PREPARING_DOWNLOAD, DOWNLOADING, COMPLETING, SEEDING, COMPLETED, ERROR), progress, speeds, size, source and resulting file id.
remove_transfersRemove transfersPOSTAgents: ask firstRemoves transfers: the given transfer_ids, or every completed (or every) transfer with remove_filter; one of the two is needed. The reference does not say whether downloaded files are kept.
retry_transferRetry transferPOSTAgents: ask firstRetries a failed transfer and returns it with its new status.

File share, 4 operations

list_file_sharesList file sharesGETAgents: ask firstLists the friends a file is shared with: each friend's user name, avatar URL and the share id that unshare_file takes.
list_shared_filesList shared filesGETAgents: ask firstLists the files the account shares with friends: each file's id, name, size and who it is shared with.
share_filesShare filesPOSTAgents: ask firstShares files with put.io friends: they appear in each friend's folder of shared files. Use everyone to share with all friends.
unshare_fileUnshare filePOSTAgents: ask firstStops sharing a file with some friends, or with everyone. Friends lose access to it.

Friend request, 4 operations

approve_friend_requestApprove friend requestPOSTAgents: ask firstAccepts an incoming friend request: the two users become friends and can share files with each other.
deny_friend_requestDeny friend requestPOSTAgents: ask firstDeclines an incoming friend request from the given user.
list_friend_requestsList friend requestsGETAgents: ask firstLists the incoming friend requests waiting for an answer: each requester's id, user name and avatar URL.
send_friend_requestSend friend requestPOSTAgents: ask firstSends a friend request to another put.io user, who is notified and can accept or decline it.

Zip, 3 operations

create_zipCreate zipPOSTAgents: ask firstStarts building a ZIP archive of the given files and returns its zip_id. Call get_zip with that id until it returns a download url.
get_zipGet zipGETAgents: ask firstReturns a ZIP job: zip_status (NEW, PROCESSING, DONE, ERROR), and once DONE its private download url, size and the files left out. Call again until DONE or ERROR.
list_zipsList zipsGETAgents: ask firstLists the ZIP archives being built: each one's id and creation time.

Event, 2 operations

clear_eventsClear eventsPOSTAgents: ask firstClears the whole event history of the account (transfer, upload, share and RSS notifications). Irreversible.
list_eventsList eventsGETAgents: ask firstLists the account's event history: each event's id, creation time and type (upload, transfer_completed, file_shared, transfer_error, zip_created, RSS errors and more).

Friend, 2 operations

list_friendsList friendsGETAgents: ask firstLists the account's put.io friends: each friend's id, user name and avatar URL.
remove_friendRemove friendPOSTAgents: ask firstRemoves a friend. Files shared with all friends are removed from the former friend's folder.

Mp4 conversion, 2 operations

convert_file_to_mp4Convert file to mp4POSTAgents: ask firstStarts converting a video file to MP4 (H.264 video and AAC audio) so it can be streamed on more devices. Follow progress with get_mp4_status.
get_mp4_statusGet mp4 statusGETAgents: ask firstReturns the MP4 conversion status of a video: status (IN_QUEUE, CONVERTING, COMPLETED, ERROR, NOT_AVAILABLE), percent done and the converted size. Call again until COMPLETED or ERROR.

Subtitle, 2 operations

download_subtitleDownload subtitleGETAgents: ask firstDownloads one subtitle of a video as text, in SRT or WebVTT format. Take the key from list_subtitles.
list_subtitlesList subtitlesGETAgents: ask firstLists the subtitles available for a video in the user's preferred language: key, language, name and source (opensubtitles, mkv or folder). Needs a default subtitle language in the account settings.

Account, 1 operation

get_account_infoGet account infoGETAgents: ask firstReturns the signed-in put.io account: user id, username, email address (personal data) and the bandwidth used this month.

Account settings, 1 operation

get_account_settingsGet account settingsGETAgents: ask firstReturns the account settings: default download folder id, invisible mode, subtitle languages, sort orders, locale, theme, and whether trash, history and two-factor login are on.

Extraction, 1 operation

list_extractionsList extractionsGETAgents: ask firstLists the account's archive extractions in progress: id, archive name, status (IN_QUEUE, EXTRACTING, EXTRACTED, PASSWORD, ERROR), message, part count and resulting file ids.

Folder, 1 operation

create_folderCreate folderPOSTAgents: ask firstCreates a folder with the given name under a parent folder (0 is the root) and returns the new folder's file object.

Video position, 1 operation

get_video_positionGet video positionGETAgents: ask firstReturns the saved playback position of a video, in seconds (start_from), so playback can resume where it stopped.

Use put.io from Claude Code, Cursor or Codex

Connect put.io in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its put.io operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect put.io

Create your workspace
Sign up free. Nothing to install.
Connect put.io once
Add your put.io connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.