This guide shows you how to connect the Socialinsider MCP server to Claude and ChatGPT, so you can pull live Socialinsider analytics into your AI conversations, without installing anything locally.
✅ What you'll need:
an active Socialinsider account with API access
The Socialinsider MCP server is already running here:
When you add that URL to a supported client, you’ll be asked to sign in via a secure OAuth 2.0 flow. No API keys, tokens, or environment variables required.
How authentication works
The first time you use Socialinsider inside Claude or ChatGPT, the app will:
Open a Socialinsider login window in your browser
Ask you to approve access
Return you to the app with the connection ready
If you ever get stuck in a loop of login prompts, skip to Troubleshooting.
Connect to Claude
Option 1 - Web
This is the easiest option.
Open claude.ai
Click Customize (from the navigation bar)
3. Go to 'Connectors'
4. Click on the 'plus' icon - 'add custom connector'
5. Paste the URL: https://mcp.socialinsider.io/mcp
6. Click on 'Connect'
7. Complete the Socialinsider login & authorization flow - you will be asked to log in to your Socialinsider account
8. Check if Socialinsider appears now in the 'Connectors' section
You can now start a new conversation and try it 👇
“Show me the engagement rate for our Instagram profile in the project ‘Automotive’ for the last 30 days.”
Option 2 - Claude Desktop
Claude Desktop supports remote MCP servers.
Find your config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\\\\Claude\\\\claude_desktop_config.json
2. Add this block (create the file if it doesn’t exist):
{
"mcpServers": {
"socialinsider": {
"type": "http",
"url": "https://mcp.socialinsider.io/mcp"
}
}
}
3. Save the file and restart Claude Desktop
4. On first use, complete the Socialinsider OAuth login in the browser window
Verify the connection (optional): if Claude Desktop shows the Socialinsider tools, you’re done.
💡Note: If tools don’t show up, make sure you’re on a recent Claude Desktop version (see their release notes).
Option 3 - Claude Code (CLI)
If you use Claude Code in the terminal:
claude mcp add socialinsider https://mcp.socialinsider.io/mcp
On first use, Claude Code opens a browser window for OAuth login. After you authorize, the tools will be available in that project.
To verify the connection:
claude mcp list
Connect to ChatGPT (Desktop app on macOS)
Open ChatGPT
Go to ChatGPT (menu bar) → Settings
Open the Connectors (or MCP Servers) tab
Click Add server → choose Remote (SSE/HTTP)
Enter:
Name:
Socialinsider
Save and restart ChatGPT if prompted
On first use, complete the Socialinsider OAuth login in the browser window
Prompt Examples
Use natural language - just include the project, profile, and timeframe.
👉 Competitive analysis
“Compare the engagement rate of @netflix and @disneyplus on Instagram for Q1 2025, and tell me which drove more interactions per post.”
👉 Own profile audit
“Get the last 30 days of profile analytics for our Facebook page in project ‘Acme Corp’ and summarize the follower growth trend.”
👉 Top content
“Fetch the last 50 posts from our Instagram account in the ‘Brand’ project for March 2025 and rank them by engagement rate.”
👉 Multi-platform benchmark
“Compare average views per video for the YouTube channels in project ‘Competitors’ over the past 90 days.”
👉 Campaign performance
“Show me posts tagged with the ‘Summer24’ campaign in project ‘Marketing’ for Instagram between June and August 2024.”
Available Tools
Once connected, your assistant can use these Socialinsider tools:
Tool | What it does |
| Lists tracked profiles (optionally filtered by project) |
| Searches for a profile by URL or handle |
| Starts tracking a new profile (owned or competitor) |
| Removes a tracked profile and its historical data |
| Fetches posts with per-post metrics (supports pagination + campaigns) |
| Returns daily analytics (followers, engagement, reach, impressions) |
| Fetches Instagram Stories (owned/authorized business accounts only) |
| Lists brand groups inside a project |
| Lists campaign tags available in a project |
Troubleshooting
“Unauthorized” or repeated login prompts
Complete the OAuth flow in the browser window that opens (don’t close it early)
Remove the server and add it again to trigger a fresh login
Double-check the URL is exactly: https://mcp.socialinsider.io/mcp
Rate limit errors (429)
The error message includes how long to wait before retrying
Reduce the date range or number of profiles in your request
Response truncated
If the response is very long, use pagination (from / size) to fetch smaller batches
“Invalid timezone”
Use an IANA timezone format like UTC, America/New_York, Europe/London, Asia/Tokyo
✌️ Support
Account & billing: socialinsider.io/contact
MCP server issues: support@socialinsider.io
API documentation: api-docs.socialinsider.io
Privacy policy: socialinsider.io/privacy-policy





