AI agents

Tools and limits

Updated

A read-only token sees the first eight tools. The three writes appear only when writing was allowed.

ToolAccessWhat it does
library_overviewreadWhose library this is, how many photos and videos, the phones and their folders, and what the token may do.
find_assetsreadLists the library newest first, up to 100 at a time, filtered by favourites, trash, photos or videos, album, device, dates, camera, file name, or GPS position.
count_assetsreadHow many items find_assets would list.
get_assetreadEverything about one item: when and where it was taken, the camera and exposure, its files, its albums.
get_previewreadJPEGs to look at: up to 8 items at 360 px, or up to 2 at 1600 px.
list_albumsreadThe phones' folders, with how many items each holds.
list_devicesreadThe phones that back up to this library, and when each last did.
get_download_urlreadA link to one of an item's files, good for ten minutes.
set_favoritewriteMarks an item as a favourite, or takes the mark off.
trash_assetwriteMoves an item to the trash. It stays recoverable.
restore_assetwriteTakes an item out of the trash.

Limits

LimitValue
Calls per token300 a minute
Reads that carry bytes (previews, files, download links)60 a minute
Items per page100
An original read whole32 MiB; above it, a download link
A download link10 minutes
Refused tokens from one address30 in 15 minutes

Not in this version

No folders or drives (only the phones' backups), no uploads, no album changes, no emptying the trash, no text search, people or places, and no tokens made by members themselves.

Search the manual

Search page titles and guides