sf-mm-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PUTIO_TOKEN | No | Use a token directly, skipping sign-in | |
| PUTIO_CLIENT_ID | No | put.io OAuth app id (public); override to use your own app | 9525 |
| SF_MM_AUTH_FLOW | No | oob or loopback | oob |
| SF_MM_LOG_LEVEL | No | debug/info/warn/error/silent | info |
| SF_MM_TOKEN_STORE | No | auto/keychain/file/none; none disables persistence | auto |
| SHOWFEED_BASE_URL | No | Point at a dev instance | https://showfeed.site |
| PUTIO_API_BASE_URL | No | https://api.put.io/v2 | |
| PUTIO_REDIRECT_URI | No | Only for loopback | http://127.0.0.1:41830/callback |
| PUTIO_CLIENT_SECRET | No | Only for loopback | |
| MOVIEMAGNET_BASE_URL | No | Point at a dev instance | https://moviemagnet.site |
| SF_MM_CONFIRM_TRANSFERS | No | Require confirm=true on putio_add_transfer | false |
| SF_MM_TORRENT_CACHE_TTL | No | Torrent result cache, seconds | 900 |
| SF_MM_METADATA_CACHE_TTL | No | Metadata cache, seconds | 3600 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| putio_loginA | Starts the put.io sign-in flow and returns instructions for the user to complete it in a browser. Call putio_auth_status afterwards to confirm completion. Required before searching torrents or creating transfers. |
| putio_auth_statusA | Reports whether a valid put.io token is stored, and the progress of any sign-in started by putio_login. |
| putio_logoutA | Deletes the stored put.io token from the OS keychain or credential file. |
| movies_searchA | Searches moviemagnet.site for movies by title. Returns IMDb ids to pass to movies_get or movies_find_torrents. No sign-in required. |
| movies_getA | Fetches full details for a single movie by IMDb id from moviemagnet.site. No sign-in required. |
| movies_popularA | Returns the movies most viewed on moviemagnet.site recently. No sign-in required. |
| movies_find_torrentsA | Searches torrent indexers for a movie by IMDb id and returns magnet links sorted by seeder count. Requires a put.io sign-in. Pass a magnet to putio_add_transfer to start downloading. |
| shows_searchA | Searches showfeed.site for TV shows by title. Returns IMDb ids to pass to shows_get or shows_find_torrents. No sign-in required. |
| shows_getA | Fetches details for a single show by IMDb id, including its full episode list. No sign-in required. |
| shows_popularA | Returns the shows most viewed on showfeed.site recently. No sign-in required. |
| shows_find_torrentsA | Searches torrent indexers for a show by IMDb id and returns magnet links sorted by seeder count. Filter to a specific season and episode to find a single airing. Requires a put.io sign-in. |
| putio_add_transferA | Starts a download on put.io from a magnet link or HTTP URL, typically one returned by movies_find_torrents or shows_find_torrents. This spends the account's bandwidth and storage, so confirm the choice with the user first. |
| putio_list_transfersA | Lists current and recent transfers on the signed-in put.io account, with download progress. |
| putio_get_transferA | Fetches up-to-date details for a single transfer, useful for checking download progress. |
| putio_cancel_transfersA | Cancels or removes transfers by id. Stops seeding if the transfer is seeding, otherwise removes the transfer entry. Downloaded files are not deleted. |
| putio_clean_transfersA | Removes all completed transfer entries from the transfer list. Downloaded files are not deleted. |
| putio_accountA | Returns the signed-in put.io username and remaining disk space. |
| putio_list_filesA | Lists files and folders in the put.io account. Pass a folder id to browse into it. |
| favorites_listA | Lists the IMDb ids favorited in the put.io account config. This is the same list shown on showfeed.site and moviemagnet.site. |
| favorites_updateA | Adds or removes an IMDb id from the favorites list stored in the put.io account config. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 20 tools
Tools are cleanly namespaced by domain (movies_, shows_, putio_, favorites_) and each targets a distinct resource or action. The only potential source of confusion is putio_clean_transfers versus putio_cancel_transfers, but their descriptions clearly separate bulk cleanup of completed entries from targeted cancellation/removal.
Most tools follow a consistent [resource]_[action] pattern, with actions like get, search, add, list, cancel, update. A few outliers use adjectives or nouns for the suffix (movies_popular, putio_account, putio_auth_status), which breaks the verb_noun convention, but the overall prefix scheme remains predictable.
With 20 tools, the server is at the heavy end of the scale, but the count is justified by the multiple subdomains (movies, shows, put.io, favorites). It borders on feeling bloated, yet each tool serves a distinct function and the logical grouping helps manageability.
The tool surface covers the core lifecycle for discovering media, finding torrents, managing put.io transfers, and maintaining favorites. Notable minor gaps include no direct file deletion or transfer pause/resume, but these are workarounds.