herascrape-mcp: Instagram MCP server

Instagram data for AI agents, over the Model Context Protocol. Point Claude, Cursor, ChatGPT, VS Code, or any MCP client at herascrape-mcp and it can read public Instagram profiles, content, engagement, and search results directly: no scraping code, no browser, no login.

Every endpoint is one tool, generated from the live API, so the tool list never drifts from what the server serves. It is read-only, cursor-paginated, and flat $0.0004 per successful call (only 2xx is billed; the media resolver, oEmbed and the balance check are free). Powered by the herascrape Instagram API; to call it from code instead, use the Python & TypeScript client.

What agents can do with it

• Profiles & audiences: resolve a username or user id to a full profile; page a user's followers and following; pull the "about" / account details.
• Content: a user's posts, reels, tagged posts, live stories, highlights, and reposts; fetch any individual post or reel by id.
• Engagement: read a post's comments and their replies; see who liked a post or a comment.
• Discovery: hashtag top / recent / reels; a location's top & recent media; trending audio and the clips using a given audio track.
• Search: users, hashtags, audio, places, and a universal "top" search.
• Utilities: convert between a shortcode and a media id, oEmbed a post, and check your live balance.

Agents reach for these when a task needs what's actually on Instagram right now: audience research, competitor and campaign tracking, influencer vetting, trend and hashtag analysis, enriching a profile or a post.

One-click install

The button above opens a client picker and installs herascrape-mcp wherever you run agents. For clients with native one-click install:

Get an API key (or sign in to authorize in-browser) from your herascrape dashboard.

Manual install

Remote (recommended): connect by URL, authorize in the browser

Hosts that support remote MCP connect to the hosted server and authorize with a click (OAuth); no key to copy.

• Claude Code: claude mcp add herascrape --transport http https://herascrape.com/mcp

• Cursor / Claude Desktop / ChatGPT:

  {
    "mcpServers": {
      "herascrape": { "url": "https://herascrape.com/mcp" }
    }
  }

Local (stdio-only hosts): npx, with an API key

For hosts that only run local (stdio) servers (Node ≥ 18). The bridge is a thin stdio-to-HTTP proxy to the hosted server: it forwards your API key as x-api-key and relays the live tool list and calls; it defines no tools of its own. Get a key from your dashboard.

• Claude Code:

  claude mcp add herascrape --env HERASCRAPE_API_KEY=your_key -- npx -y herascrape-mcp

• Claude Desktop / Cursor (claude_desktop_config.json / .cursor/mcp.json):

  {
    "mcpServers": {
      "herascrape": {
        "command": "npx",
        "args": ["-y", "herascrape-mcp"],
        "env": { "HERASCRAPE_API_KEY": "your_key" }
      }
    }
  }

Configuration

Variable	Default	Purpose
HERASCRAPE_API_KEY	none	Sent as x-api-key. Required for the local (stdio) bridge.
HERASCRAPE_MCP_URL	https://herascrape.com/mcp	Override the server URL (e.g. staging).

License

MIT