How do I install InsightSocial?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does InsightSocial need an API key?

The publisher lists these environment variables: INSIGHTSOCIAL_API_KEY.

What transport does InsightSocial use?

InsightSocial is reached over HTTP.

When was InsightSocial last checked?

Last checked 2026-11-07. Live public data from TikTok, LinkedIn, YouTube, X, Reddit and 17 more networks, via one key.

InsightSocial MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://api.insightsocial.app/mcp

Credentials from the publisher

INSIGHTSOCIAL_API_KEY — InsightSocial API key (isk_live_...). Create one at https://www.insightsocial.app/portal/api/keys?utm_source=mcp-registry. Searching and describing endpoints work without it; calling one needs it.

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http app.insightsocial-insightsocial https://api.insightsocial.app/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "app.insightsocial-insightsocial": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://api.insightsocial.app/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 0.3.9

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

insightsocial

The official CLI and MCP server for the InsightSocial API: live public data from 25 platforms through one key: Instagram, TikTok, LinkedIn, Facebook, YouTube, X, Reddit, Threads, Pinterest, Bluesky, Truth Social, Snapchat, Telegram, Twitch, Kick, Rumble, Kwai, Douyin, Xiaohongshu (RedNote), Quora, TikTok Shop, Weibo, Zhihu, Substack and Nextdoor.

300+ endpoints: profiles, public emails, posts, reels, comments, followers, likers, hashtags, search, company pages, jobs, ads, transcripts, shop products and local business listings.
One schema across platforms: a TikTok video and an Instagram post come back with the same fields (post.url, post.kind, post.engagement.likes, post.language), and unavailable lists any field a response could not fill. The CLI and MCP server ask for schema 2 on every call.
Priced per endpoint, charged per call. Empty results, failed calls and idempotent replays are free.
Built for agents. Every result is saved in full, and you re-slice it locally with jq for free, so a 50 KB page never ends up in your context.

Quick start

npx -y insightsocial init              # sign in through your browser, install the agent skill, show MCP setup
npx -y insightsocial search instagram followers
npx -y insightsocial run /v1/instagram/profile -p handle=natgeo
npx -y insightsocial view --last --jq '.data.author | {username, followers}'

init and login sign you in through your browser: they open the sign-in page and print a short code, you type the code there and click Allow, and a key named after this machine is saved. The CLI then prints which account it signed into. To use a key you already have, pass --api-key. New accounts include free calls.

Use it from an AI agent

Claude Code plugin

/plugin marketplace add insightsocial/skills
/plugin install insightsocial@insightsocial

This installs the skill and the MCP server together, from insightsocial/skills. Run npx -y insightsocial login once so the server can find your key.

MCP server (any client)

claude mcp add insightsocial --scope user -- npx -y insightsocial mcp

{
  "mcpServers": {
    "insightsocial": { "command": "npx", "args": ["-y", "insightsocial", "mcp"] }
  }
}

The server reads the key saved by insightsocial login, so the config holds no secret. You can also pass INSIGHTSOCIAL_API_KEY in its env. Without a key, search and describe still work.

Nothing to install: the same tools are hosted at https://api.insightsocial.app/mcp. Claude, ChatGPT and other clients that support it sign in with OAuth; others send the key as Authorization: Bearer. See MCP docs.

Tool	What it does
`search_endpoints`	Find endpoints by keywords and platform. Free.
`describe_endpoint`	Inputs, allowed values, an example and the price for one endpoint. Free.
`call_endpoint`	Fetch data. Saves the full response and returns a `result_id` with a trimmed view (10 items by default) and a ready `next_call` for the next page.
`read_result`	Re-slice a saved result with jq, fields, max_items or an outline with sizes. Free.
`get_credits`	Balance, plan and usage. Free.

insightsocial init --yes writes the MCP entry into Claude Code, Codex and Cursor for you.

Commands

Command
`init [--yes] [--no-skills]`	Save a key, install the skill for detected agents, print or write the MCP config.
`login [--api-key k] [--no-browser]` / `logout`	Sign in through your browser (or save a key you pass) / remove the key.
`search <words> [--platform p]`	Find endpoints. Free.
`list [--platform p]`	Every endpoint with its price. Free.
`describe <path>`	Inputs, example and price. Free.
`run <path> -p name=value …`	Call an endpoint. Saves to `./.insightsocial/`. Options: `--input <json>`, `-i file`, `--idempotency-key`, `--fresh`, `--max-credits N`, `-o file`, `--json`, and the shaping flags below.
`view [file] [--last [endpoint]]`	Re-shape a saved result. No network, no charge.
`credits`	Balance and usage. Free.
`mcp`	Start the MCP server over stdio.

Shaping flags (run and view) trim only what is printed; the saved file is always complete:

--jq <expr>: real jq (bundled, nothing to install) over the saved response. Paths start at .data.
--fields a,b.c: keep these keys on each item. Dotted paths descend.
--max-items N: show at most N items.
--summary: the structure with byte sizes, so you can see what is large before pulling it.

Paging: when there is another page, run prints the exact next command. Each page is a separate charged call.

Pricing a call first: -p dry_run=1 (or true) on any endpoint returns the quote and charges nothing. When a response could not fill a field the platform normally has, run prints it under missing; that null means unknown, not zero.

Configuration


Key	`--api-key`, then `INSIGHTSOCIAL_API_KEY`, then `~/.insightsocial/config.json` (mode 600)
`INSIGHTSOCIAL_BASE_URL`	Defaults to `https://api.insightsocial.app`
`INSIGHTSOCIAL_HOME`	Defaults to `~/.insightsocial` (config, catalogue cache, MCP results)

Develop

npm install
npm run check      # build + unit tests, no network and no key needed

License

MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install InsightSocial?

Does InsightSocial need an API key?

What transport does InsightSocial use?

When was InsightSocial last checked?

Documentation

insightsocial

Quick start

Use it from an AI agent

Claude Code plugin

MCP server (any client)

Commands

Configuration

Develop

License