Agents Index

Instadram

Online

Whisky & bourbon collection in AI: search the catalog, read and manage your shelf (OAuth).

Visit publisherConnectJSON

What it can do: 48 tools

  • whoami read-onlyReturn the signed-in user's public profile (uid, username, display name) plus pro (paid or gifted Instadram Pro). Uses the Bearer token uid only. Available to free users.
  • list_my_bottles read-onlyList bottles in the signed-in user's collection. Filters: status (unopened|opened|consumed|excluded|wishlist|active|tried) and optional text query. Always scoped to the token uid — a userId argument is ignored.
  • get_my_bottle read-onlyGet one bottle from the signed-in user's collection by id. 404 if missing or not theirs.
  • get_shelf_value read-onlyValue 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 when no price was entered (msrpCount says how many used MSRP). msrp: every bottle a
  • search_catalog read-onlySearch the public bottle catalog (expressions and distilleries). Does not return other users' collections.
  • get_expression read-onlyGet one public catalog expression by id, or by path distilleries/{id}/brands/{id}/expressions/{id}.
  • list_my_activity read-onlyList the signed-in user's own pours/activity. Never returns other users' activity.
  • list_my_collections read-onlyList the signed-in user's shelf groups / collections.
  • search_users read-onlySearch public Instadram profiles by exact username (usernames/{handle} or users.username) then displayName prefix. Returns uid, username, displayName, photoURL. Never email or billing fields.
  • get_user read-onlyGet one public profile by username or userId. Resolves handles via usernames/{handle}. Public fields only — no email, stripeCustomerId, or billing.
  • list_user_bottles read-onlyList bottles on another user's public shelf. Requires username or userId. Same status/query/paging as list_my_bottles. 404 if the user is missing; empty list if they have no bottles.
  • get_user_bottle read-onlyGet 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 read-onlyList another user's pours/activity (authenticated feed read). Requires username or userId. Newest first. Same paging caps as list_my_activity.
  • list_user_collections read-onlyList another user's public shelf groups. Requires username or userId.
  • fetch_bottle_reviews read-onlyAI community-review research for a bottle (fetchBottleReviews). Not a user tasting-note form. iOS may have this flagged off; the tool still works. Pass bottleName, or bottleId (own collection), or username/userId + bottl
  • lookup_bottle read-onlyAdd-bottle AI identify (analyzeBourbonImage). Photo (imageData) or text (query). Returns distillery, location, spirit.brand + expressions (name, proof, msrp, tasting_notes, etc.), success, confidence. Does not write a bo
  • get_feed read-onlyThe Home feed as the app shows it: recent pours, adds and ratings from everyone (scope global, the app default) or only people you follow plus you (scope following). Blocked and hidden accounts are removed.
  • explore_catalog read-onlyThe Explore tab's bottle deck: recent public shelf bottles with photos from other collectors, one per expression, blocked and hidden accounts removed.
  • discover_users read-onlyDiscover people like the app's People list: everyone (empty query) or a name/handle match, ranked like the app, with badge and whether you follow them. Use follow_user to follow.
  • search_cocktails read-onlyCocktails 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 known). Results note how many of the main liquors you already own. For browsing
  • explore_recipes read-onlyThe Explore recipe feed: every drink, ordered by how few bottles you'd need to buy from your own shelf, then popularity. Paged with nextCursor.
  • check_username read-onlyCheck whether an @handle is valid and free before set_username (same rules and messages as Edit Profile).
  • export_shelf read-onlyExport your whole collection as CSV (Pro, like Profile → Export Collection): the same columns and values as the app's file. Returns filename and csv text.
  • add_bottle_from_photoAdd 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 photo (1K) and the bottle is added with it. Free: 5 AI art a day; Pro: unlimited. T
  • regenerate_artMake 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 credit (free 5/day, Pro unlimited). Two steps.
  • reidentify_bottleThink harder about one of your bottles: identify it again from its photo and research fresh reviews. Reviews are saved when found; pass update_identity to also replace the name, distillery and proof. Two steps.
  • search_public_bottles read-onlySearch bottles like the app's Search tab: other collectors' shelf bottles (with owner username and display name) plus public catalog bottles, ranked like the app. Paged with nextCursor/hasMore/total.
  • add_bottleAdd 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; Pro is unlimited. Two steps: the first call only previews and returns confirm_tok
  • update_bottleEdit your bottle: notes, price, store, custom name/distillery/proof, batch, barrel details, favorite. Two steps: the first call only previews and returns confirm_token; show the preview to the user and repeat the call wi
  • set_bottle_statusMove a bottle between unopened, opened, finished, wishlist and tried. Moving into unopened/opened re-checks the free 25-bottle limit. Two steps: the first call only previews and returns confirm_token; show the preview to
  • rate_bottleRate 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 returns confirm_token; show the preview to the user and repeat the call with conf
  • remove_bottlePermanently delete one of your bottles. Two steps: the first call only previews and returns confirm_token; show the preview to the user and repeat the call with confirm_token only after they agree.
  • wishlist_addPut 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 previews and returns confirm_token; show the preview to the user and repeat the call
  • wishlist_removeDelete a bottle from your wishlist. Two steps: the first call only previews and returns confirm_token; show the preview to the user and repeat the call with confirm_token only after they agree.
  • log_pourLog 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 and returns confirm_token; show the preview to the user and repeat the call with
  • create_collectionCreate one of your collections. Two steps: the first call only previews and returns confirm_token; show the preview to the user and repeat the call with confirm_token only after they agree.
  • rename_collectionRename one of your collections (and optionally change its description). Two steps: the first call only previews and returns confirm_token; show the preview to the user and repeat the call with confirm_token only after th
  • delete_collectionDelete one of your collections. Its bottles stay on your shelf. Two steps: the first call only previews and returns confirm_token; show the preview to the user and repeat the call with confirm_token only after they agree
  • add_to_collectionAdd one of your bottles to one of your collections. Two steps: the first call only previews and returns confirm_token; show the preview to the user and repeat the call with confirm_token only after they agree.
  • remove_from_collectionTake one of your bottles out of one of your collections (the bottle stays on your shelf). Two steps: the first call only previews and returns confirm_token; show the preview to the user and repeat the call with confirm_t

…and 8 more.

Connect it

Claude Code
claude mcp add --transport http instadram https://api.instadram.me/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://api.instadram.me/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "instadram": {
      "url": "https://api.instadram.me/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "instadram": {
      "type": "http",
      "url": "https://api.instadram.me/mcp"
    }
  }
}

Questions

What does Instadram do?

Whisky & bourbon collection in AI: search the catalog, read and manage your shelf (OAuth). It exposes 48 tools to AI assistants.

What tools does Instadram provide?

48 tools, including whoami, list_my_bottles, get_my_bottle, get_shelf_value, search_catalog, get_expression, list_my_activity, list_my_collections, search_users, get_user, list_user_bottles, get_user_bottle….

How do I connect Instadram to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://api.instadram.me/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does Instadram require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is Instadram online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes Instadram?

instadram.me. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in Web Search & Scraping