SocialGPT

io.github.scrollmarkPublished by GitHub account scrollmarkv0.1.0Updated Oct 27, 2026

Social media analytics, video analysis, and competitor intel for any MCP-compatible AI agent.

VerifiedStreamable HTTPWeb executableCommunication & CollaborationData & AnalyticsMedia & Design

Overview

AI-generated overview

Hosted SocialGPT MCP server that gives an assistant read access to your TikTok, Instagram and YouTube analytics, competitor research and video analysis.

What you can do
  • List, search and inspect your analyzed videos, with deep analysis including scene breakdowns and transcripts
  • Read connected accounts, view and engagement time series, follower history, growth summaries and per-post trajectories
  • Look up public creators, browse their top and recent videos, and find videos similar to a given one
  • Analyze new posts or creators into your library and poll the background job status
  • Publish to connected TikTok, Instagram or YouTube accounts, including upload links for local files, only with the opt-in publish scope
  • Run guided prompts and skills for performance audits, competitor benchmarking and hook teardowns
When to use it
Useful when you want an assistant to answer questions about your own social performance, benchmark against competitors, or reverse-engineer what works in a niche, and when you want publishing to connected accounts from inside the agent.
Requirements
Remote streamable HTTP endpoint; nothing to install. Requires a SocialGPT account and OAuth 2.1 with PKCE sign-in through your client; no API keys. Connecting a social account is needed for analysis of your own content, while public/competitor analysis works without one.
Before you install
Read scopes are granted by default; the opt-in content:ingest scope pulls new content into your library and content:publish can post to your connected accounts, so approve write scopes deliberately. Publishing requires an explicit confirmation flag, but Instagram and YouTube publish immediately once confirmed. Access can be revoked from SocialGPT settings.

Installation

In SourceWeft

  1. Open SocialGPT in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.scrollmark%2Fsocialgpt/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "socialgpt": {
      "type": "http",
      "url": "https://mcp.gpt.social/mcp"
    }
  }
}

README

[SocialGPT logo]

SocialGPT MCP Server

Your social data, inside every AI tool.

Connect SocialGPT to Claude, ChatGPT, Cursor, and any AI agent that speaks the Model Context Protocol. Your analytics, video analysis, and content intelligence — available everywhere you work.

[Model Context Protocol] [Auth] [License: MIT]

Setup · Tools · Guided workflows · Authentication · Roadmap

What is this?

This is the public front door for the SocialGPT MCP server — a hosted, remote MCP server that brings your social media analytics into any MCP-compatible AI agent. There's nothing to install and no API keys to manage: you point your client at one URL and authenticate once with your SocialGPT account.

Connection URL:

https://mcp.gpt.social/mcp
  • Transport: Streamable HTTP
  • Auth: OAuth 2.1 with PKCE — sign in once with your SocialGPT account, revoke any time
  • Access: Read-only analytics by default. Two optional scopes go further — one lets agents pull new content into your library for analysis, the other lets them publish to your connected accounts.

New to SocialGPT? Create a free account, then connect a social account to unlock analysis of your own content. Public/competitor analysis works without connecting anything.

Setup

Pick your client, paste the config, and authenticate with your SocialGPT account. Most clients open a browser window for OAuth the first time an agent uses a SocialGPT tool.

Ready-to-copy config files for each client live in examples/.

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS), then restart Claude Desktop:

json
{  "mcpServers": {    "socialgpt": {      "url": "https://mcp.gpt.social/mcp"    }  }}

Claude.ai

Settings → Integrations → Add more → paste the URL and follow the prompts:

https://mcp.gpt.social/mcp

Claude.ai handles authentication during the integration setup flow.

Claude Code

bash
claude mcp add --transport http socialgpt https://mcp.gpt.social/mcp

On your first request that uses SocialGPT tools, Claude Code opens a browser for OAuth sign-in and caches the token locally.

Cursor

Add to your project's .cursor/mcp.json, or ~/.cursor/mcp.json for global access:

json
{  "mcpServers": {    "socialgpt": {      "url": "https://mcp.gpt.social/mcp"    }  }}

VS Code

Add to .vscode/mcp.json in your workspace (or run MCP: Add Server from the command palette):

json
{  "servers": {    "socialgpt": {      "type": "http",      "url": "https://mcp.gpt.social/mcp"    }  }}

ChatGPT

Settings → Tools & integrations → Add MCP server, then paste the URL:

https://mcp.gpt.social/mcp

Codex

Add to ~/.codex/config.toml (or .codex/config.toml for a single project):

toml
[mcp_servers.socialgpt]url = "https://mcp.gpt.social/mcp"

Cline

MCP Servers icon → Remote Servers → add the server URL, or edit cline_mcp_settings.json:

json
{  "mcpServers": {    "socialgpt": {      "type": "streamableHttp",      "url": "https://mcp.gpt.social/mcp"    }  }}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

json
{  "mcpServers": {    "socialgpt": {      "serverUrl": "https://mcp.gpt.social/mcp"    }  }}

AntiGravity

Add to ~/.gemini/config/mcp_config.json:

json
{  "mcpServers": {    "socialgpt": {      "serverUrl": "https://mcp.gpt.social/mcp"    }  }}

Any other MCP client

Any client that supports the Model Context Protocol can connect using the server URL https://mcp.gpt.social/mcp. Check your client's docs for where to register an MCP server, and use the streamable HTTP transport.

What you can do

Your contentFull visibility into your own posts and performance — list and search your analyzed videos, deep-dive analysis with hooks, themes, and transcripts, and track views, engagement, and growth over time across TikTok, Instagram, and YouTube.
Competitor intelReverse-engineer what works in any niche — look up any public creator's profile and content DNA, browse their top and recent videos, find videos similar to yours, and benchmark against comparable creators.
Content profileYour content DNA, always up to date — synthesized pillars and recurring themes, a voice and tone profile derived from your actual content, and a prescriptive playbook that evolves as you create.
PublishingPost to your connected TikTok, Instagram, and YouTube accounts without leaving your agent — with a required confirmation step before anything goes live. Opt-in via the content:publish scope.
Guided workflowsPre-built prompts that chain tools together for a full performance audit, head-to-head benchmarking, or reverse-engineering a creator's winning formula.

Just ask

Once connected, talk to your agent like a teammate:

"How did my content perform this month compared to last?"

"Find creators in the fitness niche on TikTok and show me what's working for them."

"Analyze my latest Instagram reel and suggest better hooks."

"Compare my engagement rate to similar creators on YouTube."

"Post this video to my TikTok as a draft."

Tools

The server exposes a curated surface — read-only unless you grant a write scope. The Scope column shows which OAuth scope each tool needs (see Authentication & scopes).

Your videos & content
ToolDescriptionScope
list_videosList your videos — filter by platform/query, scope to one connected account, sort by recent or top performers.analysis:read
search_videosSearch your analyzed videos by query.analysis:read
get_videoGet one video by platform + post id — owned or public/analyzed.analysis:read · analysis:read:public
get_video_analysisFull analysis (incl. scene breakdown) for a video — owned or competitor.analysis:read · analysis:read:public
searchSearch your content (connector-convention entrypoint).analysis:read
fetchFetch a single resource by id (connector-convention entrypoint).analysis:read
get_content_profileYour content DNA — topics, pillars, and voice synthesized from your content.analysis:read
Accounts & metrics
ToolDescriptionScope
list_accountsList your connected social accounts.analysis:read
get_accountGet one connected account by id.analysis:read
get_account_metricsViews / engagement as a time series over a trailing window (up to 365 days), per account or aggregated.analysis:read
get_follower_historyAudience growth over time — follower / following / media counts as a true time series (up to 365 days).analysis:read
get_growth_summaryComputed growth deltas and momentum over a window — the "am I growing?" answer in one call.analysis:read
get_post_metrics_historyOne post's trajectory over time — how a single video's numbers moved after publishing.analysis:read · analysis:read:public
Competitor & creator discovery
ToolDescriptionScope
get_creatorGet a public/competitor creator's profile by platform + handle.analysis:read:public
list_creator_videosList a public creator's videos, sorted by recent or top, optionally with analysis.analysis:read:public
list_similar_videosFind videos similar to a given one from across the platform.analysis:read · analysis:read:public
Analyze new content
ToolDescriptionScope
analyze_postAnalyze a single TikTok/YouTube/Instagram post by URL — adds it to your library and runs deep video analysis.content:ingest
analyze_creatorAnalyze a public creator's recent posts (async — returns a job_id to poll).content:ingest
get_analysis_statusCheck the status of an analyze_creator job.content:ingest
Publish

Opt-in — these are the only tools that act on your accounts, and they require the content:publish scope. Nothing publishes without your explicit confirmation.

ToolDescriptionScope
get_publish_optionsLive TikTok publish options — privacy levels, interaction settings, whether posting is possible right now. Required before posting to TikTok.content:publish
publish_postPublish to a connected TikTok, Instagram, or YouTube account. TikTok supports draft or direct; Instagram publishes reels and carousels immediately; YouTube publishes a video immediately.content:publish
get_publish_statusPoll a publish job by job_id.content:publish
get_upload_linkGet a page where you can upload a local video file that has no public URL.content:publish
list_uploadsList drafts you've uploaded, so a draft_id can be handed to publish_post.content:publish

Publishing a local file is a three-step handoff: get_upload_link → you upload in the browser → list_uploads to find the draft → publish_post(draft_id=...).

Meta
ToolDescriptionScope
server_infoBasic info about the server and the scopes it supports.—
whoamiThe authenticated caller — user id and granted scopes.—

Conventions

A few behaviours that apply across the surface:

  • Account groups (brands / workspaces). Accounts are organized into groups. list_accounts returns each account's group plus a groups list; pass a group_id to list_accounts, get_content_profile, get_publish_options, or publish_post to scope to one brand. Omit it for the default group.
  • Pagination. list_videos, search_videos, and list_creator_videos return a next_cursor when more results exist — pass it back as cursor with the same filters. No next_cursor means you have everything.
  • Time-series granularity. get_account_metrics, get_follower_history, and get_post_metrics_history take a granularity of daily (default), weekly, or raw.
  • Async analysis. Deep video analysis runs in the background (~30–60s). get_video_analysis returns {"status": "pending", "retry_after_seconds": N} until it's ready — that's expected, not an error. Wait and call again.

Guided workflows

The server also ships prompts — guided workflows that chain the tools above into a complete analysis. Clients surface these as slash-commands or prompt templates.

PromptWhat it does
analyze_my_accountA thorough performance audit of one connected account over a timeframe — momentum, what's working, what's underperforming, and prioritized recommendations.
compare_to_similarBenchmark one of your videos head-to-head against similar competitor videos and get specific changes to test.
what_works_in_nicheReverse-engineer a creator's winning formula — hooks, formats, topics, cadence — into a repeatable playbook.
connect_accountGuided setup for linking a social account to unlock analysis of your own content.
post_from_my_deviceWalk through publishing a video that lives on your device — upload, pick options, confirm, post. Needs content:publish.

Skills

Where prompts ask the model to do an analysis, skills ship the work itself. Most are a real script the agent runs on your MCP data, returning a styled report; going-viral is the strategy loop that conducts the others. They install on Claude.ai (upload a zip) and Claude Code (drop in a folder), and run the same SocialGPT MCP tools under the hood.

SkillAnswersTools used
going-viral"How do I actually go viral?" — the end-to-end loop: research outliers, find your own drivers, study winning hooks, ship one experiment, review, repeat. Grounds each step in your data and routes into the three analysis skills.orchestrates — list_videos, list_creator_videos, get_video_analysis, get_content_profile, get_growth_summary, …
content-performance-audit"What actually drives my views?" — a statistical audit of your posts (length, timing, platform, format) with real significance tests.list_videos
competitor-gap-analysis"Where are competitors winning that I'm silent?" — content gaps, owned territory, format gaps vs. 1–3 rivals.list_videos, list_creator_videos
hook-retention-teardown"What do my best hooks do that my flops don't?" — pacing and language patterns separating winners from losers.list_videos, get_video_analysis

See skills/ for install instructions, the build script, and the methodology behind each one. New skills land here as the tool surface grows.

Authentication & scopes

The SocialGPT MCP server is an OAuth 2.1 resource server. Your client performs an OAuth 2.1 + PKCE flow against your SocialGPT account; the server validates the bearer token on every request. No API keys are ever copied around, and you can revoke access at any time from your SocialGPT settings.

Access is governed by four scopes. The two read scopes are granted by default; the two write scopes are opt-in — a client has to ask for them explicitly, and you have to approve them.

ScopeDefaultGrants
analysis:read✅Read your own content, metrics, connected accounts, and content profile.
analysis:read:public✅Read public/competitor creators and their analysis.
content:ingestopt-inTrigger analysis of new posts/creators — pulls content into your library for analysis. It does not post or publish anything on your behalf.
content:publishopt-inPublish to your connected TikTok / Instagram / YouTube accounts. The only scope that puts content in front of your audience — publish_post additionally requires an explicit confirmation flag, so an agent cannot post without you saying yes.

Clients can also request offline_access for a refresh token, so you don't re-authenticate every hour.

Until you connect a social account, only public/competitor analysis is available. Newly connected accounts appear automatically on the same token — no need to re-authenticate.

Roadmap

Read access and publishing are live today. We're building the rest of the write surface so your agent can do more than analyze and post — all over the same MCP connection:

  • Schedule posts — queue content for optimal posting times
  • Generate scripts — full video scripts grounded in your analytics and style
  • Design carousels — generate carousel posts from your content DNA (publishing an existing carousel already works)
  • Manage comments — read, reply to, and moderate comments across platforms
  • A/B test hooks — run experiments on hooks and captions

Support & links

⭐ If SocialGPT MCP is useful to you, star this repo — it helps other creators discover it.

This repository contains the public listing and connection details for the SocialGPT MCP server. The server itself is hosted by SocialGPT; its source is not part of this repository.

License

MIT © Scrollmark, Inc.

Source: README.md at commit 1c04e02

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts