instagram-engagement

This MCP server provides tools for analyzing Instagram engagement and deriving insights from posts and accounts. It includes capabilities to analyze post comments for sentiment and themes, compare engagement metrics across multiple accounts, extract demographic insights from engaged users, identify potential leads based on engagement patterns, and generate comprehensive engagement reports. To use it, configure your MCP settings to run the Instagram Engagement MCP, supplying your Instagram credentials via environment variables. Once running, invoke the available tools (analyze_post_comments, compare_accounts, extract_demographics, identify_leads, generate_engagement_report) by passing the required parameters such as post URLs, account handles, date ranges, and criteria. The server relies on the Instagram Private API, so use it responsibly and in accordance with Instagram’s terms of service and rate limits.

Prerequisites:

• Node.js and npm installed on your machine
• Access to the MCP runtime environment where you configure and run MCP servers

Installation options:

1. Install via Smithery (recommended for automatic deployment): npx -y @smithery/cli install @Bob-lance/instagram-engagement-mcp --client claude

2. Install from npm globally: npm install -g instagram-engagement-mcp

3. Clone from GitHub and install locally: git clone https://github.com/Bob-lance/instagram-engagement-mcp.git cd instagram-engagement-mcp npm install

Configuration guidance (example):

• If using npx (typical for hosted MCP setups): Add to your MCP config: { "mcpServers": { "instagram-engagement": { "command": "npx", "args": ["instagram-engagement-mcp"], "env": { "INSTAGRAM_USERNAME": "your_instagram_username", "INSTAGRAM_PASSWORD": "your_instagram_password" }, "disabled": false, "autoApprove": [] } } }
• If you cloned the repo and run from built code: { "mcpServers": { "instagram-engagement": { "command": "node", "args": ["/path/to/instagram-engagement-mcp/build/index.js"], "env": { "INSTAGRAM_USERNAME": "your_instagram_username", "INSTAGRAM_PASSWORD": "your_instagram_password" }, "disabled": false, "autoApprove": [] } } } Additional setup:
• Copy .env.example to .env and provide your Instagram credentials if the server requires environment variables at runtime.
• Build from source if you cloned the repository: npm run build

Tips and caveats:

• The server uses the Instagram Private API, which is not officially supported by Instagram.
• Respect rate limits to avoid IP blocks or account restrictions.
• Store credentials securely; rotate credentials as needed and consider using scoped tokens or secrets management in production.
• If you encounter authentication issues, ensure 2FA is disabled for the test account or follow the project's guidance for handling two-factor authentication.
• The available tools include: analyze_post_comments (sentiment/themes/leads from post comments), compare_accounts (engagement metrics across accounts), extract_demographics (demographics of engaged users), identify_leads (lead filtering based on engagement), and generate_engagement_report (comprehensive reports for an account).