Categories › Business & Finance › E-commerce & marketplaces
Whisky & bourbon collection in AI: search the catalog, read and manage your shelf (OAuth).
Remote server: your requests and data go to api.instadram.me. Claude Code: claude mcp add --transport http instadram https://api.instadram.me/mcp · Claude app: Settings → Connectors → Add custom connector.
The tools this server listed when we connected to it, in its own words.
whoami — Return the signed-in user's public profile (uid, username, display name) plus pro (paid or gifted Instadram Pro). Uses the Bearer token uid list_my_bottles — List bottles in the signed-in user's collection. Filters: status (unopened|opened|consumed|excluded|wishlist|active|tried) and optional textget_my_bottle — Get one bottle from the signed-in user's collection by id. 404 if missing or not theirs.get_shelf_value — Value of the signed-in user's active shelf (opened + unopened) in USD, the same number as the app's Stats. paid: purchase price, or MSRP whesearch_catalog — Search the public bottle catalog (expressions and distilleries). Does not return other users' collections.get_expression — Get one public catalog expression by id, or by path distilleries/{id}/brands/{id}/expressions/{id}.list_my_activity — List the signed-in user's own pours/activity. Never returns other users' activity.list_my_collections — List the signed-in user's shelf groups / collections.search_users — Search public Instadram profiles by exact username (usernames/{handle} or users.username) then displayName prefix. Returns uid, username, diget_user — Get one public profile by username or userId. Resolves handles via usernames/{handle}. Public fields only — no email, stripeCustomerId, or blist_user_bottles — List bottles on another user's public shelf. Requires username or userId. Same status/query/paging as list_my_bottles. 404 if the user is miget_user_bottle — Get one bottle from another user's public collection. Requires username or userId plus bottleId. 404 if the user or bottle is missing.list_user_activity — List another user's pours/activity (authenticated feed read). Requires username or userId. Newest first. Same paging caps as list_my_activitlist_user_collections — List another user's public shelf groups. Requires username or userId.fetch_bottle_reviews — AI community-review research for a bottle (fetchBottleReviews). Not a user tasting-note form. iOS may have this flagged off; the tool still lookup_bottle — Add-bottle AI identify (analyzeBourbonImage). Photo (imageData) or text (query). Returns distillery, location, spirit.brand + expressions (nget_feed — The Home feed as the app shows it: recent pours, adds and ratings from everyone (scope global, the app default) or only people you follow plexplore_catalog — The Explore tab's bottle deck: recent public shelf bottles with photos from other collectors, one per expression, blocked and hidden accountdiscover_users — Discover people like the app's People list: everyone (empty query) or a name/handle match, ranked like the app, with badge and whether you fsearch_cocktails — Cocktails to make with a bottle, like the app's recipe rail on a bottle page. Pass the bottle's name (plus spiritType, category, proof when explore_recipes — The Explore recipe feed: every drink, ordered by how few bottles you'd need to buy from your own shelf, then popularity. Paged with nextCurscheck_username — Check whether an @handle is valid and free before set_username (same rules and messages as Edit Profile).export_shelf — Export your whole collection as CSV (Pro, like Profile → Export Collection): the same columns and values as the app's file. Returns filenameadd_bottle_from_photo — Add a bottle from a photo, like Add Bottle → photo in the app: the preview identifies it; after the user agrees, AI art is made from the phoregenerate_art — Make new AI art for one of your bottles from its stored photo (or a new photo), like Think harder → Only regenerate the art. Uses 1 AI art creidentify_bottle — Think harder about one of your bottles: identify it again from its photo and research fresh reviews. Reviews are saved when found; pass updasearch_public_bottles — Search bottles like the app's Search tab: other collectors' shelf bottles (with owner username and display name) plus public catalog bottlesadd_bottle — Add a bottle to your shelf, wishlist or Tried list (same as the app's Add Bottle form). Free accounts can hold 25 unopened/opened bottles; Pupdate_bottle — Edit your bottle: notes, price, store, custom name/distillery/proof, batch, barrel details, favorite. Two steps: the first call only previewset_bottle_status — Move a bottle between unopened, opened, finished, wishlist and tried. Moving into unopened/opened re-checks the free 25-bottle limit. Two strate_bottle — Rate one of your bottles 0-5 in steps of 0.25 (0 clears). Posts a 'rated' update like the app. Two steps: the first call only previews and rremove_bottle — Permanently delete one of your bottles. Two steps: the first call only previews and returns confirm_token; show the preview to the user and wishlist_add — Put a bottle on your wishlist: a new one (expression_path or name), or move an existing bottle_id there. Two steps: the first call only prevwishlist_remove — Delete a bottle from your wishlist. Two steps: the first call only previews and returns confirm_token; show the preview to the user and repelog_pour — Log that you're drinking one of your bottles (posts to your followers' feed, like the app's Pour). Two steps: the first call only previews acreate_collection — Create one of your collections. Two steps: the first call only previews and returns confirm_token; show the preview to the user and repeat trename_collection — Rename one of your collections (and optionally change its description). Two steps: the first call only previews and returns confirm_token; sdelete_collection — Delete one of your collections. Its bottles stay on your shelf. Two steps: the first call only previews and returns confirm_token; show the add_to_collection — Add one of your bottles to one of your collections. Two steps: the first call only previews and returns confirm_token; show the preview to tremove_from_collection — Take one of your bottles out of one of your collections (the bottle stays on your shelf). Two steps: the first call only previews and returnNot tested by KitScout yet. When our harness runs it, pros, cons and the tasks we tried appear here, with the date and evidence.