InsightSocial MCP server

Q: How do I add InsightSocial MCP to Claude Code?

Run `claude mcp add --env INSIGHTSOCIAL_API_KEY= cli -- npx -y insightsocial` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add InsightSocial MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

✓ VerifiedCommit Nov 6, 2026

insightsocial/cli · typescript · MIT

Fetch live public data from 22 social media platforms including TikTok, LinkedIn, and YouTube through a unified schema.

Also known as insightsocial/cli, cli

stdio remote Search & Web Data

Install GitHub ↗

Stars: 0
Tools: —
Downloads, 30 days: 873
Latest version: 0.3.9
Last commit: Nov 6, 2026
License: MIT

What is InsightSocial MCP?

InsightSocial fetches live public data from 22 social media platforms including TikTok, LinkedIn, and YouTube through a unified schema.

Summary generated from the project's README

About InsightSocial MCP server

InsightSocial provides a unified way to access live public data from 22 different social media platforms, including TikTok, LinkedIn, YouTube, X, and Reddit. It uses a single schema so that data like video engagement or post URLs remain consistent regardless of the source platform. This makes it an ideal tool for developers building AI agents that need to monitor social trends, profiles, or comments without writing custom scrapers for every individual service.

The MCP server can be run locally via npx or connected to clients like Claude and ChatGPT. Users can authenticate through a browser-based login or by providing an API key through environment variables. The system is designed to be efficient for LLM context windows by saving full responses locally and allowing users to re-slice data using jq or specific field filters. This ensures that large data payloads do not overwhelm the agent while still keeping the complete information available for local processing.

What you can do with it

1Cross-platform data retrievalAn AI agent can fetch video engagement metrics from both TikTok and YouTube using the same data structure.
2Social media researchA developer can instruct an agent to find specific endpoints for searching followers or profiles across various networks.
3Efficient context managementUsers can extract only specific fields from a large social media response to prevent exceeding AI context limits.
4Endpoint discoveryA developer can search for available data points by keyword to see what information is accessible.

Written from the project's README. Every use case is checked against a quote from it.

How to install InsightSocial MCP

Formats verified 10 Nov 2026

Claude CodeCursorVS CodeClaude DesktopCodexGemini CLI

$ claude mcp add --env INSIGHTSOCIAL_API_KEY=<YOUR_INSIGHTSOCIAL_API_KEY> cli -- npx -y insightsocial

~/.cursor/mcp.json

{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "insightsocial"
      ],
      "env": {
        "INSIGHTSOCIAL_API_KEY": "<YOUR_INSIGHTSOCIAL_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "insightsocial"
      ],
      "env": {
        "INSIGHTSOCIAL_API_KEY": "<YOUR_INSIGHTSOCIAL_API_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "insightsocial"
      ],
      "env": {
        "INSIGHTSOCIAL_API_KEY": "<YOUR_INSIGHTSOCIAL_API_KEY>"
      }
    }
  }
}

~/.codex/config.toml

[mcp_servers.cli]
command = "npx"
args = ["-y", "insightsocial"]

[mcp_servers.cli.env]
INSIGHTSOCIAL_API_KEY = "<YOUR_INSIGHTSOCIAL_API_KEY>"

~/.gemini/settings.json

{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "insightsocial"
      ],
      "env": {
        "INSIGHTSOCIAL_API_KEY": "<YOUR_INSIGHTSOCIAL_API_KEY>"
      }
    }
  }
}

Set 1 environment variable before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

INSIGHTSOCIAL_API_KEYSecret
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.

Name	Description
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.	Secret

Automated checks

Ran Nov 12, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)Pass
Commit or release in the last yearPass
Package name not close to a popular packagePass
Remote endpoint uses HTTPSPass
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesPass

README

View on GitHub

insightsocial

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

230+ endpoints: profiles, public emails, posts, videos, comments, followers, likers, hashtags, search, company pages, jobs, ads, transcripts, shop products and local business listings.
One schema across platforms: a TikTok video and a YouTube video 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 tiktok followers
npx -y insightsocial run /v1/tiktok/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

Read full README

InsightSocial MCP questions

How do I add InsightSocial MCP to Claude Code?

Run claude mcp add --env INSIGHTSOCIAL_API_KEY=<YOUR_INSIGHTSOCIAL_API_KEY> cli -- npx -y insightsocial in your terminal. Add --scope user to make it available in every project.

How do I add InsightSocial MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Which social media platforms are supported?

It supports 22 platforms including TikTok, LinkedIn, YouTube, X, Reddit, Pinterest, Bluesky, and many others.

How is the service priced?

Pricing is based on the specific endpoint used and charged per call, though empty results and failed calls are free.

Facts

Nov 13, 2026

Stars: 0
Downloads, 30 days: 873
Latest version: 0.3.9
Last commit: Nov 6, 2026
License: MIT
Transport: stdio, remote
Package: insightsocial

insightsocial ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/insightsocial/cli.svg)](https://hostedmcp.org/servers/insightsocial/cli/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

InsightSocial MCP server

✓ VerifiedCommit Nov 6, 2026

insightsocial/cli · typescript · MIT

Fetch live public data from 22 social media platforms including TikTok, LinkedIn, and YouTube through a unified schema.

Also known as insightsocial/cli, cli

stdio remote Search & Web Data

Install GitHub ↗

Stars: 0
Tools: —
Downloads, 30 days: 873
Latest version: 0.3.9
Last commit: Nov 6, 2026
License: MIT

What is InsightSocial MCP?

InsightSocial fetches live public data from 22 social media platforms including TikTok, LinkedIn, and YouTube through a unified schema.

Summary generated from the project's README

About InsightSocial MCP server

What you can do with it

1Cross-platform data retrievalAn AI agent can fetch video engagement metrics from both TikTok and YouTube using the same data structure.
2Social media researchA developer can instruct an agent to find specific endpoints for searching followers or profiles across various networks.
3Efficient context managementUsers can extract only specific fields from a large social media response to prevent exceeding AI context limits.
4Endpoint discoveryA developer can search for available data points by keyword to see what information is accessible.

Written from the project's README. Every use case is checked against a quote from it.

How to install InsightSocial MCP

Formats verified 10 Nov 2026

Claude CodeCursorVS CodeClaude DesktopCodexGemini CLI

$ claude mcp add --env INSIGHTSOCIAL_API_KEY=<YOUR_INSIGHTSOCIAL_API_KEY> cli -- npx -y insightsocial

~/.cursor/mcp.json

{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "insightsocial"
      ],
      "env": {
        "INSIGHTSOCIAL_API_KEY": "<YOUR_INSIGHTSOCIAL_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "insightsocial"
      ],
      "env": {
        "INSIGHTSOCIAL_API_KEY": "<YOUR_INSIGHTSOCIAL_API_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "insightsocial"
      ],
      "env": {
        "INSIGHTSOCIAL_API_KEY": "<YOUR_INSIGHTSOCIAL_API_KEY>"
      }
    }
  }
}

~/.codex/config.toml

[mcp_servers.cli]
command = "npx"
args = ["-y", "insightsocial"]

[mcp_servers.cli.env]
INSIGHTSOCIAL_API_KEY = "<YOUR_INSIGHTSOCIAL_API_KEY>"

~/.gemini/settings.json

{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "insightsocial"
      ],
      "env": {
        "INSIGHTSOCIAL_API_KEY": "<YOUR_INSIGHTSOCIAL_API_KEY>"
      }
    }
  }
}

Set 1 environment variable before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

INSIGHTSOCIAL_API_KEYSecret
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.

Name	Description
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.	Secret

Automated checks

Ran Nov 12, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)Pass
Commit or release in the last yearPass
Package name not close to a popular packagePass
Remote endpoint uses HTTPSPass
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesPass

README

View on GitHub

insightsocial

230+ endpoints: profiles, public emails, posts, videos, comments, followers, likers, hashtags, search, company pages, jobs, ads, transcripts, shop products and local business listings.
One schema across platforms: a TikTok video and a YouTube video 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 tiktok followers
npx -y insightsocial run /v1/tiktok/profile -p handle=natgeo
npx -y insightsocial view --last --jq '.data.author | {username, followers}'

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.

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.

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

Read full README

InsightSocial MCP questions

How do I add InsightSocial MCP to Claude Code?

Run claude mcp add --env INSIGHTSOCIAL_API_KEY=<YOUR_INSIGHTSOCIAL_API_KEY> cli -- npx -y insightsocial in your terminal. Add --scope user to make it available in every project.

How do I add InsightSocial MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Which social media platforms are supported?

It supports 22 platforms including TikTok, LinkedIn, YouTube, X, Reddit, Pinterest, Bluesky, and many others.

How is the service priced?

Pricing is based on the specific endpoint used and charged per call, though empty results and failed calls are free.

Facts

Nov 13, 2026

Stars: 0
Downloads, 30 days: 873
Latest version: 0.3.9
Last commit: Nov 6, 2026
License: MIT
Transport: stdio, remote
Package: insightsocial

insightsocial ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/insightsocial/cli.svg)](https://hostedmcp.org/servers/insightsocial/cli/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

InsightSocial MCP server

What is InsightSocial MCP?

About InsightSocial MCP server

What you can do with it

How to install InsightSocial MCP

Install InsightSocial MCP in Claude Code

Install InsightSocial MCP in Cursor

Install InsightSocial MCP in VS Code

Install InsightSocial MCP in Claude Desktop

Install InsightSocial MCP in Codex

Install InsightSocial MCP in Gemini CLI

Configuration

Automated checks

README

insightsocial

Quick start

Use it from an AI agent

Claude Code plugin

MCP server (any client)

Commands

Configuration

Develop

License

InsightSocial MCP questions

InsightSocial MCP server

What is InsightSocial MCP?

About InsightSocial MCP server

What you can do with it

How to install InsightSocial MCP

Install InsightSocial MCP in Claude Code

Install InsightSocial MCP in Cursor

Install InsightSocial MCP in VS Code

Install InsightSocial MCP in Claude Desktop

Install InsightSocial MCP in Codex

Install InsightSocial MCP in Gemini CLI

Configuration

Automated checks

README

insightsocial

Quick start

Use it from an AI agent

Claude Code plugin

MCP server (any client)

Commands

Configuration

Develop

License

InsightSocial MCP questions