home / mcp / instagram120 mcp server

Instagram120 MCP Server

Provides access to the Instagram120 API via MCP, exposing endpoints for posts, reels, user info, stories, highlights, and more.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "bach-ai-tools-bachai-instagram120": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

You can access the Instagram120 API through this MCP server, enabling you to integrate Instagram data and actions into your applications with a standardized MCP interface. This server exposes a set of endpoints for posts, reels, user info, stories, highlights, and more, while simplifying authentication and deployment via MCP clients.

How to use

Connect to the Instagram120 MCP Server using an MCP client or launcher. You will run the server via stdio, which means you start a local process that the MCP platform communicates with through standard input and output. You can choose from multiple start methods, depending on your environment and preference.

How to install

Prerequisites: ensure you have Python and a working Python environment, and you can install Python packages with pip.

Install the package from PyPI:

pip install bach-instagram120

Or install from source in development mode (editable):

pip install -e .

Run the server using one of the supported methods.

# Using uvx (recommended, no extra install required)
uvx --from bach-instagram120 bach_instagram120

# Or specify a version
uvx --from bach-instagram120@latest bach_instagram120

# Development mode
python server.py

After installation, you can also run the installed command directly (requires that you installed the package):

bach_instagram120

Configuration and security

API access requires authentication. Set your API key in the environment before starting the server.

Environment variable needed:

export API_KEY="your_api_key_here"

Using MCP clients and environment variables

To run via Cursor or Claude Desktop, configure the MCP wrapper to start the stdio server with the proper environment variable. The following examples show how to wire the API key into the MCP configuration file.

Examples of available endpoints

The server provides endpoints for various Instagram features, including posts, reels, user info, highlights, stories, and media access. Use the corresponding MCP endpoints in your application to retrieve data or perform actions.

Available tools

posts

Get Instagram posts by user ID or username. Supports optional pagination via maxId to retrieve the next set of posts.

reels

Get Instagram reels by user ID or username. Supports pagination via maxId for continued retrieval.

userinfo

Retrieve user information by user ID or username.

highlights

Fetch highlights for a user.

highlight_stories

Retrieve stories within highlights.

story

Get a specific story by username and ID.

hls

Convert HLS streams to MP4 format for easy playback.

stories

Get multiple stories for a user.

links

Retrieve video links related to posts or reels.

profile

Get profile information for a user.

get

Get data bypassing CORS restrictions.

mediabyshortcode

Fetch a post or reel by its shortcode.