Model Context Protocol server for personal Instagram accounts (unofficial private API via instagrapi).
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"instagram-personal-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# instagram-personal-mcp  A [Model Context Protocol](https://modelcontextprotocol.io) server that wraps [`instagrapi`](https://github.com/subzeroid/instagrapi) so Claude (or any MCP client) can read, engage, and DM from a **personal** Instagram account — no Business/Creator switch, no Meta app review. > **⚠️ Unofficial private API.** This server uses Instagram's reverse-engineered > mobile API (via `instagrapi`). It is not affiliated with or endorsed by Meta. > Accounts driving private-API traffic can be rate-limited, challenged, or > permanently disabled. Use a **burner account** until you trust your setup, > keep activity natural, and don't connect over VPNs / datacenter IPs. 24 tools across auth, profile/read, engagement, and DMs. ## Quick start ```bash git clone https://github.com/AleemHaider/instagram-personal-mcp cd instagram-personal-mcp python -m venv .venv && source .venv/bin/activate pip install -e ".[dev]" ``` Drop your creds in a `.env`: ```bash cp .env.example .env # edit: IG_USERNAME, IG_PASSWORD ``` Then run it: ```bash instagram-personal-mcp ``` The first call (e.g. `instagram_session_status` or `instagram_login`) will authenticate and save a session file to `~/.config/instagram-personal-mcp/session.json`. Subsequent runs reuse it. ## Connect to Claude Desktop Edit `~/.config/Claude/claude_desktop_config.json` (Linux) / `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS): ```json { "mcpServers": { "instagram-personal": { "command": "instagram-personal-mcp", "env": { "IG_USERNAME": "your_username", "IG_PASSWORD": "your_password" } } } } ``` Restart Claude Desktop. ## Tools ### Auth | Tool | What it does | |---|---| | `instagram_login` | Log in. Pass `verification_code` if 2FA is on. | | `instagram_logout` | Log out and delete the saved session. | | `instagram_session_status` | Report whether a usable session is loaded. | ### Profile & read | …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.