MCP server

Instadram Official

me.instadram/instadram

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website

At a glance

Type

MCP server

Publisher

instadram.me (verified by the MCP Registry)

Status

Working at last check

Tools

48

Token cost

About 9,372 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http instadram https://api.instadram.me/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.instadram]
url = "https://api.instadram.me/mcp"

Gemini CLI

{"mcpServers":{"instadram":{"httpUrl":"https://api.instadram.me/mcp"}}}

Cursor

{"mcpServers":{"instadram":{"url":"https://api.instadram.me/mcp"}}}

VS Code

{"servers":{"instadram":{"type":"http","url":"https://api.instadram.me/mcp"}}}

Antigravity

agy mcp add instadram https://api.instadram.me/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"instadram","server_url":"https://api.instadram.me/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"instadram","server_url":"https://api.instadram.me/mcp"}

Tools

• add_bottle ~420 tokens
  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 aft
• add_bottle_from_photo ~334 tokens
  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.
• add_to_collection ~197 tokens
  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.
• block_user ~197 tokens
  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.
• check_username ~84 tokens
  Check whether an @handle is valid and free before set_username (same rules and messages as Edit Profile).
• create_collection ~163 tokens
  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.
• delete_collection Deletes data · ~177 tokens
  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.
• delete_my_activity Deletes data · ~184 tokens
  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.
• discover_users ~137 tokens
  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.
• explore_catalog ~96 tokens
  The Explore tab's bottle deck: recent public shelf bottles with photos from other collectors, one per expression, blocked and hidden accounts removed.
• explore_recipes ~116 tokens
  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.
• export_shelf ~78 tokens
  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.
• fetch_bottle_reviews ~290 tokens
  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, gene
• follow_user ~180 tokens
  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.
• get_expression ~106 tokens
  Get one public catalog expression by id, or by path distilleries/{id}/brands/{id}/expressions/{id}.
• get_feed ~164 tokens
  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.
• get_my_bottle ~101 tokens
  Get one bottle from the signed-in user's collection by id. 404 if missing or not theirs.
• get_shelf_value ~133 tokens
  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 i
• get_user ~146 tokens
  Get one public profile by username or userId. Resolves handles via usernames/{handle}. Public fields only — no email, stripeCustomerId, or billing.
• get_user_bottle ~188 tokens
  Get one bottle from another user's public collection. Requires username or userId plus bottleId. 404 if the user or bottle is missing.
• list_my_activity ~141 tokens
  List the signed-in user's own pours/activity. Never returns other users' activity.
• list_my_bottles ~262 tokens
  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.
• list_my_collections ~134 tokens
  List the signed-in user's shelf groups / collections.
• list_user_activity ~231 tokens
  List another user's pours/activity (authenticated feed read). Requires username or userId. Newest first. Same paging caps as list_my_activity.
• list_user_bottles ~326 tokens
  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.
• list_user_collections ~211 tokens
  List another user's public shelf groups. Requires username or userId.
• log_pour ~181 tokens
  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.
• lookup_bottle ~182 tokens
  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).
• rate_bottle ~203 tokens
  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.
• regenerate_art ~239 tokens
  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.
• reidentify_bottle ~204 tokens
  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.
• remove_bottle Deletes data · ~165 tokens
  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.
• remove_from_collection ~209 tokens
  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.
• rename_collection ~202 tokens
  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.
• search_catalog ~170 tokens
  Search the public bottle catalog (expressions and distilleries). Does not return other users' collections.
• search_cocktails ~203 tokens
  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.
• search_public_bottles ~167 tokens
  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.
• search_users ~207 tokens
  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.
• send_feedback Sends messages · ~208 tokens
  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.
• set_bottle_status ~251 tokens
  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.
• set_username ~193 tokens
  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.
• unblock_all_users ~149 tokens
  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.
• unfollow_user ~172 tokens
  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.
• update_bottle ~391 tokens
  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.
• update_profile ~398 tokens
  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 retu
• whoami ~81 tokens
  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.
• wishlist_add ~236 tokens
  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.
• wishlist_remove ~165 tokens
  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.

Browse

• Spreadsheets
• Email
• Mobile apps
• Food and recipes

Related MCP servers

• Apis Io
  Discover, rate and compare APIs and providers in the APIs.io catalog; manage a listing you own.
• BAM Kaarsen catalog
  Search and browse the BAM Kaarsen candle catalog and white-label offering. Read-only, no auth.
• SofiaStage Events
  Read-only tools for current SofiaStage events, venues, cities, performers, and editorial.
• GitBook MCP by usefulapi
  Read spaces, collections, pages and content; search docs and manage GitBook organization spaces.
• smry Product
  Read public sources and manage a smry library, feeds, notes, highlights, files, and page monitors.
• aicoolies
  Search and read the aicoolies catalog of AI and developer tools via a remote MCP knowledge graph.
• LabTestSuperstore
  Read-only U.S. lab-test catalog, collection-site search, and reference-range context.
• 25karats — Made-to-Order Wedding & Engagement Rings
  Search and price made-to-order rings, jewelry, and lab-grown diamonds from the 25karats catalog.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/me.instadram/instadram.svg)](https://aptlynx.net/servers/me.instadram/instadram)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents