General Tools
instadram.me
Provides general-purpose tools through the Model Context Protocol.
ENDPOINT 1
https://api.instadram.me/mcp
MCP server metadata
- Name
- instadram
- Version
- 1.0.0
Instadram tools for the signed-in user's whisky collection, other users' public shelves and activity, and the public bottle catalog. Authorization is a verified OAuth or Firebase ID token. Look up people with search_users or get_user, then list_user_bottles. Identify a bottle with lookup_bottle (add-bottle analyzeBourbonImage fields; photo or text — never the art generator). Research community reviews with fetch_bottle_reviews even if the iOS flag is off. Reading shelves, people, activity, the catalog and bottle reviews is free, as in the app. lookup_bottle requires Instadram Pro (paid or gifted); whoami includes pro. AI tools need the ai.use scope and count toward daily limits. Write tools exist for the shelf, collections, social and profile; each needs its optional scope (shelf.write, collections.write, social.write or profile.write) granted at sign-in. Every write works in two steps: call it first to get a preview, then call it again with the confirm_token from that preview to apply the change.
Known tools 47
whoamiReturn the signed-in user's public profile (uid, username, display name) plus pro (paid or gifted Instadram Pro).
Inferred read-onlyget_expressionGet one public catalog expression by id, or by path distilleries/{id}/brands/{id}/expressions/{id}.
Inferred read-onlysearch_usersSearch public Instadram profiles by exact username (usernames/{handle} or users.
Inferred read-onlyfetch_bottle_reviewsAI community-review research for a bottle (fetchBottleReviews).
Inferred read-onlyget_feedThe 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).
Inferred read-onlyexplore_catalogThe Explore tab's bottle deck: recent public shelf bottles with photos from other collectors, one per expression, blocked and hidden accounts removed.
Inferred read-onlydiscover_usersDiscover 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.
Inferred read-onlysearch_cocktailsCocktails to make with a bottle, like the app's recipe rail on a bottle page.
Inferred read-onlyexplore_recipesThe Explore recipe feed: every drink, ordered by how few bottles you'd need to buy from your own shelf, then popularity.
Inferred read-onlycheck_usernameCheck whether an @handle is valid and free before set_username (same rules and messages as Edit Profile).
Potential side effectsexport_shelfExport your whole collection as CSV (Pro, like Profile → Export Collection): the same columns and values as the app's file.
Inferred read-onlyadd_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.
Inferred read-onlyregenerate_artMake new AI art for one of your bottles from its stored photo (or a new photo), like Think harder → Only regenerate the art.
Inferred read-onlyreidentify_bottleThink harder about one of your bottles: identify it again from its photo and research fresh reviews.
Inferred read-onlysearch_public_bottlesSearch 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.
Inferred read-onlyadd_bottleAdd a bottle to your shelf, wishlist or Tried list (same as the app's Add Bottle form).
Inferred read-onlyupdate_bottleEdit your bottle: notes, price, store, custom name/distillery/proof, batch, barrel details, favorite.
Potential side effectsset_bottle_statusMove a bottle between unopened, opened, finished, wishlist and tried.
Inferred read-onlywishlist_addPut a bottle on your wishlist: a new one (expression_path or name), or move an existing bottle_id there.
Inferred read-onlylog_pourLog that you're drinking one of your bottles (posts to your followers' feed, like the app's Pour).
Inferred read-onlyrename_collectionRename one of your collections (and optionally change its description).
Inferred read-onlyremove_from_collectionTake one of your bottles out of one of your collections (the bottle stays on your shelf).
Inferred read-onlydelete_my_activityDelete one of your own feed posts (id from list_my_activity).
Potential side effectsblock_userBlock someone: hides their posts and profile from your feed, Explore and Discover (doesn't unfollow, like the app).
Inferred read-onlyunblock_all_usersUnblock every user you've blocked (same as Profile → Unblock All Users).
Inferred read-onlyupdate_profileEdit your profile like Edit Profile in the app: displayName, bio, location, website, instagram, twitter, facebook, tiktok.
Potential side effectsset_usernameChange your @handle (3–20 characters: lowercase letters, numbers, underscore).
Inferred read-onlysend_feedbackSend a bug report, feature idea or other feedback to the Instadram team as you (same as Profile → Send Feedback).
Potential side effectsCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.instadram]
url = "https://api.instadram.me/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"instadram": {
"type": "http",
"url": "https://api.instadram.me/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: instadram
Remote MCP URL: https://api.instadram.me/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"instadram": {
"url": "https://api.instadram.me/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"instadram": {
"type": "http",
"url": "https://api.instadram.me/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "instadram",
"transport": "streamable-http",
"url": "https://api.instadram.me/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.