Instadram

me.instadramPublished by instadram.meOfficial publisherv1.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleProductivity & WorkflowData & Analytics

Overview

AI-generated overview

Instadram connects an assistant to a whisky and bourbon collection app: search the bottle catalog, read shelves and manage your own bottles.

What you can do
Search the public bottle catalog, expressions and other collectors' public shelves, and look up profiles and people to follow, plus the home feed and Explore deck and recipe suggestions for a bottle or your shelf. Read your own collection, shelf value, activity, collections and pours, and export your shelf as CSV. Add, edit, rate, move, remove and wishlist bottles, and log pours, with two-step preview and confirm. Create, rename and delete collections and add or remove bottles from them. Identify a bottle from a photo or text, regenerate AI art and re-identify a bottle, and fetch community reviews.
When to use it
Useful if you keep a whisky or bourbon shelf in Instadram and want an assistant to look up bottles, value your collection, find cocktails you can make, or make changes to your shelf and collections after you approve them.
Requirements
A remote streamable HTTP endpoint at api.instadram.me; no packages, environment variables or headers are declared. Access is tied to a signed-in Instadram account via a Bearer token, and some features (CSV export, unlimited bottles and AI art) require Instadram Pro.
Before you install
Many tools change data: adding, editing, rating, moving, removing and deleting bottles, logging pours to followers' feeds, and creating or deleting collections. Each write is two-step, so review the preview before confirming. Free accounts are limited to 25 unopened/opened bottles and 5 AI art generations a day. Reads of other users' shelves and activity are authenticated feed reads; only public profile fields are returned.

Installation

In SourceWeft

  1. Open Instadram in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/me.instadram%2Finstadram/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

Tools

48

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 only. Available to free users.

Takes no parameters.

list_my_bottles

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.

Parameterslimitquerycursoroffsetstatus

get_my_bottle

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

ParametersbottleIdrequired

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

Takes no parameters.

search_catalog

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

Parameterslimitqueryrequiredcursoroffset

get_expression

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

ParametersexpressionIdrequired

list_my_activity

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

Parameterslimitcursoroffset

list_my_collections

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

Parameterslimitcursoroffset

search_users

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.

Parameterslimitqueryrequiredcursoroffset

get_user

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

ParametersuserIdusername

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

ParameterslimitquerycursoroffsetstatususerIdusername

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

ParametersuserIdbottleIdrequiredusername

list_user_activity

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

ParameterslimitcursoroffsetuserIdusername

list_user_collections

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

ParameterslimitcursoroffsetuserIdusername

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

ParametersuserIdbottleIdusernamebottleName

lookup_bottle

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

ParametersqueryimageData

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

Parameterslimitscopecursoroffset

explore_catalog

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

Parameterslimit

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

Parameterslimitquerycursor

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

ParameterslimitproofcategorybottleNamerequiredspiritType

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

ParameterscursorpageSize

check_username

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

Parametersusernamerequired

export_shelf

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.

Takes no parameters.

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.

ParametersnameproofstyleratingstatusimageDatarequireddistilleryconfirm_token

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.

Parametersstylebottle_idrequiredimageDataconfirm_token

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.

Parametersbottle_idrequiredimageDataconfirm_tokenupdate_identity

search_public_bottles

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.

Parameterslimitqueryrequiredcursoroffset

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.

Parametersnamenotesproofratingstatusdistilleryis_favoritebottle_notesconfirm_tokencollection_idspurchase_pricepurchased_from+1 more

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.

Parametersfieldsrequiredbottle_idrequiredconfirm_token

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.

Parametersstatusrequiredbottle_idrequiredconfirm_token

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.

Parametersratingrequiredbottle_idrequiredconfirm_token

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

Parametersbottle_idrequiredconfirm_token

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.

Parametersnamebottle_iddistilleryconfirm_tokenexpression_path

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

Parametersbottle_idrequiredconfirm_token

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.

Parametersbottle_idrequiredconfirm_token

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.

Parametersnamerequireddescriptionconfirm_token

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.

Parametersnamerequireddescriptioncollection_idrequiredconfirm_token

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

Parameterscollection_idrequiredconfirm_token

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.

Parametersbottle_idrequiredcollection_idrequiredconfirm_token

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.

Parametersbottle_idrequiredcollection_idrequiredconfirm_token

delete_my_activity

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.

Parametersactivity_idrequiredconfirm_token

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.

ParametersuserIdusernameconfirm_token

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.

ParametersuserIdusernameconfirm_token

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.

ParametersuserIdusernameconfirm_token

unblock_all_users

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.

Parametersconfirm_token

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.

ParametersbiotiktoktwitterwebsitefacebooklocationinstagramdisplayNameconfirm_token

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.

Parametersusernamerequiredconfirm_token

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.

Parameterskindrequiredmessagerequiredconfirm_token

Version history

1
  1. v1.0.0LatestOct 15, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.