addCollectionItems
ChatGPTAdd existing saved extracts or imports to one accessible Albo collection.
connectXAccount
ChatGPTGet a one-time link (valid 10 minutes) for the signed-in user to connect their X (Twitter) account to Albo with X's official API. Connecting imports nothing. After they approve on X, use scanXAccount to show what is on their account, then importXLists for the lists they pick. Also returns whether an X account is already connected and which lists auto-sync (current.syncing; imported lists sync every 5 minutes). Give the user the link to open; never open it for them.
createCollection
ChatGPTCreate one Albo collection with a title and optional description and visibility. Visibility defaults to friends; use private for a private collection.
createDocument
ChatGPTCreate one Markdown document in the signed-in user's Albo library, optionally adding it to an accessible collection. Use for a new note or itinerary.
deleteCollection
ChatGPTPermanently delete one Albo collection the signed-in user owns. The saved items in it stay in their library. Only call this when the user asks to delete that collection.
deleteCollectionMemory
ChatGPTPermanently delete one memory key from an accessible collection.
disconnectXAccount
ChatGPTStop syncing the signed-in user's X account: revokes Albo's access at X and deletes the stored connection. Posts already saved stay in their library. Only call this when the user asks to disconnect X.
geocodeLocation
ChatGPTConvert a place name (city, neighbourhood, address) into coordinates. Call before searchPlacesNearby for a named area.
getAvailableFilters
ChatGPTList the valid extract types and import sources for searchExtracts and searchImports filters.
getCollection
ChatGPTRead one accessible Albo collection and its saved items by collection ID. This tool never changes data.
getImport
ChatGPTRead one accessible saved URL import or Markdown document by its ID. This tool never changes data.
getRecommendations
ChatGPTGet personalized content suggestions from the user's interest profile and similar users' saves — extracts or imports this user hasn't saved yet. Call whenever they ask for something new.
getTasteHistory
ChatGPTEverything the user has finished (watched, read, played, cooked, visited) or rated — likes AND dislikes — with their rating out of 5, review label and a review excerpt, plus what they've saved but not yet logged (onTheirList, with deep links). Call first for 'based on what I've liked / watched, what should I…' asks, then recommend NEW titles from your own knowledge that fit what they rated highly and avoid what they disliked, naming the logged items each pick builds on.
importXLists
ChatGPTImport the X lists the user picked from scanXAccount into their Albo library, each into a private collection named as on X, and keep those lists syncing new posts from then on. Uses credits like a bulk import. Only call this with lists the user chose. Returns at once; posts appear over the next few minutes.
listCollections
ChatGPTList the signed-in user's Albo collections. This tool never changes data.
pickXPosts
ChatGPTGive the signed-in user a link (valid 30 minutes) to a page that shows their scanned X posts as a grid of covers, one tab per list (Likes, Bookmarks, each bookmark folder, Posts, Reposts), like the app's bulk import board. They tap the posts they want and Import; only those come into Albo, and those lists keep syncing. Use this when the user wants to choose single posts or see covers. Needs a finished scanXAccount first. Give the user the link to open; never open it for them.
readCollectionMemory
ChatGPTRead the AI memories saved for one Albo collection, such as trip constraints or the user's preferences.
removeCollectionItems
ChatGPTUnlink saved items from one accessible Albo collection. This leaves the items in the user's library and preserves their independent pins.
saveCollectionMemory
ChatGPTStore one memory key and value for an accessible collection. If that key exists, its value is overwritten.
saveUrl
ChatGPTSave one URL to the signed-in user's Albo library with an optional note. Existing saved URLs may be reused. Content extraction can continue asynchronously.
saveUrls
ChatGPTSave a list of URLs, such as the links in a CSV or spreadsheet, to the signed-in user's Albo library in one call, at most 50 per call; send a longer list in several calls. Use this instead of calling saveUrl once per link: it is a bulk import, charged one bulk import credit per link it saves or starts analysing instead of counting against the daily import limit, and links already saved and analysed cost nothing. Every link is analysed, even if the user turned automatic analysis off. Returns the saved import IDs, any links that failed with the reason, and any not saved because credits ran out or an error stopped the run. Content extraction continues asynchronously.
scanXAccount
ChatGPTShow what is on the signed-in user's connected X account, the same as the app's bulk import scan: Likes, Bookmarks, each bookmark folder by its name, Posts and Reposts, with how many posts each has and a few titles. Pass list (and page) to open one list and see its posts, 25 a page. Reading imports nothing. A big account takes a little while: while status is 'scanning', call again in a few seconds. Then let the user pick and call importXLists with the list ids.
searchImports
ChatGPTSearch the signed-in user's saved URL imports and Markdown documents. This tool never changes data.
searchPlacesNearby
ChatGPTSearch the user's saved places near coordinates — from geocodeLocation for a named area, or getCurrentLocation for 'near me'. Filters: category, collection, wishlist, done.
searchTags
ChatGPTSearch tag names in the user's library, optionally by extract type or collection. Use returned names with the searchExtracts tagNames filter.
syncXAccount
ChatGPTPull new posts now on the X lists the signed-in user has imported (the ones imported with importXLists or the app's bulk import), instead of waiting for the automatic sync every few minutes. Lists they never imported are not read. Returns at once; new posts appear within a minute or two.
unsaveItems
ChatGPTRemove saved items from the signed-in user's Albo library and from all their collections, like removing them in the app. They can restore them from Recently deleted. Only items the user saved; other ids come back in notFound. Only call this when the user asks to remove those items.
updateCollection
ChatGPTRename one Albo collection, change its description, or change who can see it (private, friends or public). Pass only the fields to change. Renaming needs the owner or an editor; visibility needs the owner.
updateDocument
ChatGPTReplace the title and full Markdown content of one existing document the signed-in user may edit. Existing content is overwritten.
updateSavedItem
ChatGPTAdd or remove the signed-in user's tags on one saved item, or replace their private note on it. Tags are by name; a new name creates the tag. Notes replace the whole note. Only for items the user saved.