# INSSIST

Controls your active Instagram browser session via the INSSIST extension. Helps agents handle DMs and schedule media posts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 27
- Author: inssist
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/inssist/mcp
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/inssist

## What it does

Instead of relying on the Graph API, this server interacts with your open browser profile using a local WebSocket on port `48231`. This design removes the need for Meta developer accounts. It operates on personal, creator, and business profiles alike without storing your login credentials.

The server provides 60 distinct tools. They cover direct messages, draft scheduling, and audience audits. Media uploads via `draft_create` accept local files up to 100 MB or external URLs. Lengthy jobs run in the background; the agent polls their progress with dedicated status tools like `insights_report` or `downloads_status`.

Running the server requires Node.js 22 or newer alongside Chrome with the INSSIST extension installed. Without turning on the Connect to AI Agents toggle in the extension menu, incoming tool calls cannot reach your Instagram tab.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `INSSIST_MCP_PORT`, `INSSIST_MCP_HOME` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env INSSIST_MCP_PORT=<INSSIST_MCP_PORT> --env INSSIST_MCP_HOME=<INSSIST_MCP_HOME> --transport stdio inssist -- npx -y @inssist/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add inssist --env INSSIST_MCP_PORT=<INSSIST_MCP_PORT> --env INSSIST_MCP_HOME=<INSSIST_MCP_HOME> -- npx -y @inssist/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "inssist": {
            "command": "npx",
            "args": [
                "-y",
                "@inssist/mcp"
            ],
            "env": {
                "INSSIST_MCP_PORT": "<INSSIST_MCP_PORT>",
                "INSSIST_MCP_HOME": "<INSSIST_MCP_HOME>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "inssist": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@inssist/mcp"
            ],
            "env": {
                "INSSIST_MCP_PORT": "<INSSIST_MCP_PORT>",
                "INSSIST_MCP_HOME": "<INSSIST_MCP_HOME>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e INSSIST_MCP_PORT=<INSSIST_MCP_PORT> -e INSSIST_MCP_HOME=<INSSIST_MCP_HOME> inssist npx -y @inssist/mcp
```
Replace <…> with your own values

## When to use it
- read unread direct messages and draft replies
- schedule reels and stories using local video files
- export unfollower scans directly to CSV files
- collect audience metrics without Meta Graph API keys

## Example prompts
- List my recent direct messages and show unread threads
- Schedule a reel from /Users/me/clip.mp4 for tomorrow at 9am with a caption
- Run an unfollowers scan and summarize accounts that left recently

## Similar
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107423
- [openshorts](https://affpapa.org/en/nevibecode/mcp/openshorts.md) — MCP server · ★ 7049
- [OpenScreen](https://affpapa.org/en/nevibecode/mcp/openscreen.md) — MCP server · ★ 4863
- [Usertour MCP Server](https://affpapa.org/en/nevibecode/mcp/usertour-mcp-server.md) — MCP server · ★ 2326
- [Appllama](https://affpapa.org/en/nevibecode/mcp/appllama.md) — MCP server · ★ 3046
- [obsei](https://affpapa.org/en/nevibecode/mcp/obsei.md) — MCP server · ★ 1441

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md