Instadram

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Instadram": {
      "url": "https://api.instadram.me/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (48)

• whoami read-only

  Return 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.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_my_bottles read-only

  List 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.

  Parameters:

  • limit — integer — Page size (max 50)
  • query — string — Filter by display name, distillery, or notes
  • cursor — string — Opaque pagination cursor from a previous response (numeric offset)
  • offset — integer — Number of items to skip
  • status — string — Bottle status or shelf group (active / wishlist / tried)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_my_bottle read-only

  Get one bottle from the signed-in user's collection by id. 404 if missing or not theirs.

  Parameters:

  • bottleId (required) — string — Bottle document id in the caller's collection

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_shelf_value read-only

  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 when no price was entered (msrpCount says how many used MSRP). msrp: every bottle at MSRP. excludedCount bottles have no usable price. totalCents is exact; total is dollars. Always scoped to the token uid.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• search_catalog read-only

  Search the public bottle catalog (expressions and distilleries). Does not return other users' collections.

  Parameters:

  • query (required) — string
  • limit — integer — Page size (max 50)
  • cursor — string — Opaque pagination cursor from a previous response (numeric offset)
  • offset — integer — Number of items to skip

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_expression read-only

  Get one public catalog expression by id, or by path distilleries/{id}/brands/{id}/expressions/{id}.

  Parameters:

  • expressionId (required) — string — Expression document id or nested catalog path

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_my_activity read-only

  List the signed-in user's own pours/activity. Never returns other users' activity.

  Parameters:

  • limit — integer — Page size (max 50)
  • cursor — string — Opaque pagination cursor from a previous response (numeric offset)
  • offset — integer — Number of items to skip

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_my_collections read-only

  List the signed-in user's shelf groups / collections.

  Parameters:

  • limit — integer — Page size (max 50)
  • cursor — string — Opaque pagination cursor from a previous response (numeric offset)
  • offset — integer — Number of items to skip

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• search_users read-only

  Search public Instadram profiles by exact username (usernames/{handle} or users.username) then displayName prefix. Returns uid, username, displayName, photoURL. Never email or billing fields.

  Parameters:

  • query (required) — string — Username or display-name prefix
  • limit — integer — Page size (max 50)
  • cursor — string — Opaque pagination cursor from a previous response (numeric offset)
  • offset — integer — Number of items to skip

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_user read-only

  Get one public profile by username or userId. Resolves handles via usernames/{handle}. Public fields only — no email, stripeCustomerId, or billing.

  Parameters:

  • userId — string — Firebase uid of the target user
  • username — string — Instadram handle (with or without @). Resolved via usernames/{handle}.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_user_bottles read-only

  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 missing; empty list if they have no bottles.

  Parameters:

  • limit — integer — Page size (max 50)
  • query — string — Filter by display name, distillery, or notes
  • cursor — string — Opaque pagination cursor from a previous response (numeric offset)
  • offset — integer — Number of items to skip
  • status — string — Bottle status or shelf group (active / wishlist / tried)
  • userId — string — Firebase uid of the target user
  • username — string — Instadram handle (with or without @). Resolved via usernames/{handle}.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_user_bottle read-only

  Get one bottle from another user's public collection. Requires username or userId plus bottleId. 404 if the user or bottle is missing.

  Parameters:

  • bottleId (required) — string — Bottle document id in the target user's collection
  • userId — string — Firebase uid of the target user
  • username — string — Instadram handle (with or without @). Resolved via usernames/{handle}.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_user_activity read-only

  List another user's pours/activity (authenticated feed read). Requires username or userId. Newest first. Same paging caps as list_my_activity.

  Parameters:

  • limit — integer — Page size (max 50)
  • cursor — string — Opaque pagination cursor from a previous response (numeric offset)
  • offset — integer — Number of items to skip
  • userId — string — Firebase uid of the target user
  • username — string — Instadram handle (with or without @). Resolved via usernames/{handle}.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_user_collections read-only

  List another user's public shelf groups. Requires username or userId.

  Parameters:

  • limit — integer — Page size (max 50)
  • cursor — string — Opaque pagination cursor from a previous response (numeric offset)
  • offset — integer — Number of items to skip
  • userId — string — Firebase uid of the target user
  • username — string — Instadram handle (with or without @). Resolved via usernames/{handle}.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• fetch_bottle_reviews read-only

  AI 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 + bottleId to resolve the display name then research. Returns reviews_found, msrp, general_consensus, summary, overall_rating, reviewers. Read/research only — does not write Firestore.

  Parameters:

  • userId — string — Firebase uid of the target user
  • bottleId — string — Resolve display name from a collection doc, then research
  • username — string — Instadram handle (with or without @). Resolved via usernames/{handle}.
  • bottleName — string — Bottle display name to research

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• lookup_bottle read-only

  Add-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 bottle or set expressionRef. Never generates art (transformImage is not used).

  Parameters:

  • query — string — Bottle name when no photo is available
  • imageData — string — Base64 bottle photo, same as analyzeBourbonImage

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_feed read-only

  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 plus you (scope following). Blocked and hidden accounts are removed.

  Parameters:

  • limit — integer
  • scope — string
  • cursor — string — nextCursor from a previous page
  • offset — integer

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• explore_catalog read-only

  The Explore tab's bottle deck: recent public shelf bottles with photos from other collectors, one per expression, blocked and hidden accounts removed.

  Parameters:

  • limit — integer

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• discover_users read-only

  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 follow them. Use follow_user to follow.

  Parameters:

  • limit — integer
  • query — string
  • cursor — string — nextCursor from a previous page

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• search_cocktails read-only

  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 known). Results note how many of the main liquors you already own. For browsing all drinks use explore_recipes.

  Parameters:

  • bottleName (required) — string — Bottle display name
  • limit — integer
  • proof — number
  • category — string
  • spiritType — string — e.g. bourbon, gin

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• explore_recipes read-only

  The Explore recipe feed: every drink, ordered by how few bottles you'd need to buy from your own shelf, then popularity. Paged with nextCursor.

  Parameters:

  • cursor — string — nextCursor from a previous page
  • pageSize — integer

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• check_username read-only

  Check whether an @handle is valid and free before set_username (same rules and messages as Edit Profile).

  Parameters:

  • username (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• export_shelf read-only

  Export 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.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• add_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 photo (1K) and the bottle is added with it. Free: 5 AI art a day; Pro: unlimited. Two steps: repeat with confirm_token after the user agrees.

  Parameters:

  • imageData (required) — string — Base64 JPEG/PNG photo of the bottle (or a data: URL)
  • name — string — Override the identified name
  • proof — number
  • style — string — Art style. Free: Elements. Pro: Elements, Dark, Blended, Heritage, Oak, Cheers.
  • rating — number
  • status — string
  • distillery — string
  • confirm_token — string — Omit first: you get a preview (and what it costs). Repeat with identical arguments plus this token after the user agrees.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• regenerate_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 credit (free 5/day, Pro unlimited). Two steps.

  Parameters:

  • bottle_id (required) — string
  • style — string — Art style. Free: Elements. Pro: Elements, Dark, Blended, Heritage, Oak, Cheers.
  • imageData — string — Base64 JPEG/PNG photo of the bottle (or a data: URL)
  • confirm_token — string — Omit first: you get a preview (and what it costs). Repeat with identical arguments plus this token after the user agrees.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• reidentify_bottle

  Think 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.

  Parameters:

  • bottle_id (required) — string
  • imageData — string — Base64 JPEG/PNG photo of the bottle (or a data: URL)
  • confirm_token — string — Omit first: you get a preview (and what it costs). Repeat with identical arguments plus this token after the user agrees.
  • update_identity — boolean

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• search_public_bottles read-only

  Search 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.

  Parameters:

  • query (required) — string
  • limit — integer
  • cursor — string — nextCursor from a previous page
  • offset — integer

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• add_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; Pro is unlimited. 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.

  Parameters:

  • name — string — Bottle name when it isn't in the catalog
  • notes — string — Your tasting notes
  • proof — number
  • rating — number
  • status — string — unopened/opened count toward the free 25-bottle shelf; finished, wishlist and tried don't
  • distillery — string
  • is_favorite — boolean
  • bottle_notes — string — Notes about this bottle (batch, gift, etc.)
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.
  • collection_ids — array — Your collection ids (list_my_collections)
  • purchase_price — number
  • purchased_from — string
  • expression_path — string — Catalog path from search_catalog (preferred)

  Hints: read-only no · destructive no · idempotent yes · open-world no

• update_bottle

  Edit 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 with confirm_token only after they agree.

  Parameters:

  • bottle_id (required) — string — Id from list_my_bottles
  • fields (required) — object
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• set_bottle_status

  Move 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 the user and repeat the call with confirm_token only after they agree.

  Parameters:

  • bottle_id (required) — string — Id from list_my_bottles
  • status (required) — string — unopened/opened count toward the free 25-bottle shelf; finished, wishlist and tried don't
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• rate_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 returns confirm_token; show the preview to the user and repeat the call with confirm_token only after they agree.

  Parameters:

  • bottle_id (required) — string — Id from list_my_bottles
  • rating (required) — number
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• remove_bottle destructive

  Permanently 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.

  Parameters:

  • bottle_id (required) — string — Id from list_my_bottles
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• 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 previews and returns confirm_token; show the preview to the user and repeat the call with confirm_token only after they agree.

  Parameters:

  • name — string — Bottle name when it isn't in the catalog
  • bottle_id — string — Id from list_my_bottles
  • distillery — string
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.
  • expression_path — string — Catalog path from search_catalog (preferred)

  Hints: read-only no · destructive no · idempotent yes · open-world no

• wishlist_remove destructive

  Delete 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.

  Parameters:

  • bottle_id (required) — string — Id from list_my_bottles
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• log_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 and returns confirm_token; show the preview to the user and repeat the call with confirm_token only after they agree.

  Parameters:

  • bottle_id (required) — string — Id from list_my_bottles
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• create_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 the call with confirm_token only after they agree.

  Parameters:

  • name (required) — string
  • description — string
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• rename_collection

  Rename 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 they agree.

  Parameters:

  • collection_id (required) — string — Id from list_my_collections
  • name (required) — string
  • description — string
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• delete_collection destructive

  Delete 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.

  Parameters:

  • collection_id (required) — string — Id from list_my_collections
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• 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 the user and repeat the call with confirm_token only after they agree.

  Parameters:

  • bottle_id (required) — string — Id from list_my_bottles
  • collection_id (required) — string — Id from list_my_collections
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• remove_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 returns confirm_token; show the preview to the user and repeat the call with confirm_token only after they agree.

  Parameters:

  • bottle_id (required) — string — Id from list_my_bottles
  • collection_id (required) — string — Id from list_my_collections
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• delete_my_activity destructive

  Delete one of your own feed posts (id from list_my_activity). 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_token only after they agree.

  Parameters:

  • activity_id (required) — string — Id from list_my_activity
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• follow_user

  Follow someone (username or userId from search_users). 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.

  Parameters:

  • userId — string — User id
  • username — string — Instadram handle (with or without @)
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• unfollow_user

  Stop following someone. 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.

  Parameters:

  • userId — string — User id
  • username — string — Instadram handle (with or without @)
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• block_user

  Block someone: hides their posts and profile from your feed, Explore and Discover (doesn't unfollow, 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 confirm_token only after they agree.

  Parameters:

  • userId — string — User id
  • username — string — Instadram handle (with or without @)
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• unblock_all_users destructive

  Unblock every user you've blocked (same as Profile → Unblock All Users). 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.

  Parameters:

  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• update_profile

  Edit your profile like Edit Profile in the app: displayName, bio, location, website, instagram, twitter, facebook, tiktok. Only fields you pass change; an empty string clears an optional field. Photos and handle aren't changed here (see set_username). 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.

  Parameters:

  • bio — string — Bio
  • tiktok — string — tiktok; empty string clears it
  • twitter — string — twitter; empty string clears it
  • website — string — website; empty string clears it
  • facebook — string — facebook; empty string clears it
  • location — string — location; empty string clears it
  • instagram — string — instagram; empty string clears it
  • displayName — string — Display name
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• set_username

  Change your @handle (3–20 characters: lowercase letters, numbers, underscore). Your old handle is released. Use check_username first. 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.

  Parameters:

  • username (required) — string — New handle, with or without @
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• send_feedback

  Send a bug report, feature idea or other feedback to the Instadram team as you (same as Profile → Send Feedback). 10–5000 characters. 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.

  Parameters:

  • kind (required) — string
  • message (required) — string
  • confirm_token — string — Omit on the first call to get a preview. After the user agrees, call again with identical arguments plus this token.

  Hints: read-only no · destructive no · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.