Koskamo

Instadram MCP

An official MCP server for Instadram that allows AI agents to manage a whisky and bourbon collection. It supports searching the catalog, reading and writing shelf data, managing collections, and accessing community reviews via OAuth 2.1 authentication.

Endpoint and access

No sign-in: your client connects and lists tools immediately, with no account or key.

Instadram MCP logo, by InstadramNo sign-inEndpoint checked 2026-10-18Operated by Instadram
MCP endpoint (Streamable HTTP)
https://api.instadram.me/mcp
Vendor documentation

What you can do with it

  • Search the whisky bottle catalog
  • Read and manage personal shelf inventory
  • Browse community reviews and public shelves
  • Add or edit bottles and collections
Tools advertised by the last live check:
  • 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
  • list_user_activity
  • list_user_collections
  • fetch_bottle_reviews
  • lookup_bottle
  • get_feed
  • explore_catalog
  • discover_users
  • search_cocktails
  • explore_recipes
  • check_username
  • export_shelf
  • add_bottle_from_photo
  • regenerate_art
  • reidentify_bottle
  • search_public_bottles
  • add_bottle
  • update_bottle
  • set_bottle_status
  • rate_bottle
  • remove_bottle
  • wishlist_add
  • wishlist_remove
  • log_pour
  • create_collection
  • rename_collection
  • delete_collection
  • add_to_collection
  • remove_from_collection
  • delete_my_activity
  • follow_user
  • unfollow_user
  • block_user
  • unblock_all_users
  • update_profile
  • set_username
  • send_feedback

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers a Streamable HTTP server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http instadram-mcp https://api.instadram.me/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add instadram-mcp --url https://api.instadram.me/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable instadram-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "instadram-mcp": {
      "url": "https://api.instadram.me/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure). The type must be streamableHttp for a remote HTTP server.
Cline configuration
{
  "mcpServers": {
    "instadram-mcp": {
      "type": "streamableHttp",
      "url": "https://api.instadram.me/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start instadram-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "instadram-mcp": {
      "type": "http",
      "url": "https://api.instadram.me/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http instadram-mcp https://api.instadram.me/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "instadram-mcp": {
      "url": "https://api.instadram.me/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "instadram-mcp": {
      "serverUrl": "https://api.instadram.me/mcp"
    }
  }
}

Do you run Instadram MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing