Socialbridge Mcp

io.github.IsaiahDupreePublished by GitHub account IsaiahDupreev1.0.0Updated Oct 24, 2026

Unified social-media data across 10 networks: profiles, posts, search, comments, cross-search.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingData & Analytics

Overview

AI-generated overview

A remote MCP connector that gives an assistant unified read-only access to public social-media profiles, posts, search results and comments across nine networks

What you can do
Fetch a single account's profile, or an account's recent posts, on a chosen network as a unified schema tagged with its platform. Search one network for posts, or fan one query across all keyless networks in parallel and merge the results. Read comments and replies on a post, and pull a single Threads post with its replies. Pull Reddit full history by user, subreddit or keyword, and a creator's public Snapchat Spotlight feed. List YouTube caption languages and cue segments, and query Meta Ad Library ad records when credentials are configured.
When to use it
Useful when an assistant needs public social-media data — influencer or account research, cross-network topic searches, comment reading, Reddit history or ad-library lookups — without writing per-network API integrations. It is a free discovery tier, so heavy or production use is expected to go through the paid upstream listings.
Requirements
Runs as a remote streamable-HTTP endpoint; no local runtime, account or login is needed on the MCP side. The server itself needs the operator-side variable SOCIALBRIDGE_MCP_PROXY_SECRET to pass the upstream guard, and optionally SOCIALBRIDGE_MCP_API_BASE_URL and SOCIALBRIDGE_MCP_RATE_LIMIT. Some networks (Instagram, Twitter/X, Reddit, Facebook) and the Facebook ads tool need operator-side credentials and otherwise return credentials_required.
Before you install
All tools are read-only and return public metadata, but every call is forwarded to a third-party metered upstream, so queries and results leave the assistant's environment. A soft per-IP limit (default 30 tool calls per hour) applies. Gated networks and the ads tool fail with credentials_required until the operator sets the relevant credentials; LinkedIn is disabled. Data accuracy depends entirely on the upstream service.

Installation

In SourceWeft

  1. Open Socialbridge Mcp in the dashboard and add it to a workspace.
  2. 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.IsaiahDupree%2Fsocialbridge-mcp/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.

{
  "mcpServers": {
    "socialbridge": {
      "type": "http",
      "url": "https://socialbridge-mcp.vercel.app/mcp"
    }
  }
}

README

socialbridge-mcp

A remote MCP (Model Context Protocol) connector for SocialBridge API — unified social-media data behind one /v1 contract across nine networks (Instagram, TikTok, YouTube, Twitter/X, Reddit, Facebook, Pinterest, Snapchat, Threads; LinkedIn is registered but quarantined). Every network exposes the same four operations — profile, posts, search, comments — returning one flat schema (Profile / Post / Comment) tagged with platform, plus a cross-platform superset (search_all) and a few platform-specific extras.

Live: https://socialbridge-mcp.vercel.app/mcp — 10 tools. Since the upstream SocialBridge deployment is metered (RapidAPI/Apify) and gates every /v1/* route behind a RapidAPI proxy-secret guard, this connector authenticates its own outbound calls with that same secret (SOCIALBRIDGE_MCP_PROXY_SECRET, sent as the X-RapidAPI-Proxy-Secret header) and applies a soft per-IP rate limit (SOCIALBRIDGE_MCP_RATE_LIMIT, default 30 tool-calls/hour, in-memory) so the free MCP tier stays a discovery channel rather than an unmetered bypass of the paid listing — see lib/ratelimit.js.

What this is, and why it's a separate connector

SocialBridge API is a plain REST API. Any HTTP client can already call it directly. This repo exists because MCP clients (Claude, ChatGPT, and other MCP-aware agents) don't consume arbitrary REST APIs — they consume MCP tools. socialbridge-mcp is a thin adapter layer that:

  • Exposes each SocialBridge endpoint as a discoverable, typed MCP tool (name, description, zod input schema, annotations) that an LLM can reason about and call directly.
  • Speaks the MCP streamable-HTTP transport at a single /mcp endpoint, so it registers as a connector in Claude, ChatGPT, or any other MCP client with one URL.
  • Does nothing else. Every tool call is a pass-through fetch to SocialBridge, and the JSON response is handed back verbatim as the tool result.

Authentication: None on the MCP side (deliberate)

SocialBridge's data has no per-user dimension — it's public social-media metadata (profiles, posts, search results, comments). There is nothing to gate per-caller, so this connector ships with no OAuth, no login, no Supabase, no billing, no demo-vs-real split — every caller gets the same real, live data. api/mcp.js builds a fresh, stateless McpServer per request.

The connector still authenticates its own outbound calls to the metered upstream (see below) — that is a server-to-server detail invisible to MCP callers, not per-caller auth.

Tools

One tool per real SocialBridge /v1 route (from social-api/openapi.yaml + src/routes.js):

ToolSocialBridge endpointDescription
social_profileGET /v1/{platform}/profileOne account profile as the unified Profile schema.
social_postsGET /v1/{platform}/postsAn account's recent posts as the unified Post[].
social_searchGET /v1/{platform}/searchSearch one network for posts (unified Post[]).
social_commentsGET /v1/{platform}/commentsComments/replies on a post (unified Comment[]).
search_allGET /v1/search/allFan one query across every network in parallel, merged.
reddit_historyGET /v1/reddit/historyKeyless Reddit full-history pull (Arctic Shift).
facebook_adsGET /v1/facebook/adsMeta Ad Library records as the unified Ad[] (gated).
youtube_transcriptGET /v1/youtube/transcriptCaption-language list / cue segments for a video.
threads_postGET /v1/threads/postA single thread by shortcode or URL, with replies.
snapchat_spotlightGET /v1/snapchat/spotlightA creator's public Spotlight feed (unified Post[]).

platform is an enum of instagram, tiktok, youtube, twitter, reddit, facebook, pinterest, snapchat, threads, linkedin. Keyless platforms return real data with no setup; gated platforms return an honest credentials_required and LinkedIn returns platform_disabled — nothing is ever faked.

All 10 tools are read-only and annotated { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }.

Environment variables

VarDefaultPurpose
SOCIALBRIDGE_MCP_API_BASE_URLhttps://social-api-olive.vercel.appUpstream SocialBridge base URL (override for local/self-hosted testing).
SOCIALBRIDGE_MCP_PROXY_SECRET(unset)RapidAPI proxy secret, sent outbound as X-RapidAPI-Proxy-Secret to pass the upstream /v1/* guard. Without it the upstream returns 403 and tools surface it honestly.
SOCIALBRIDGE_MCP_RATE_LIMIT30Soft per-IP cap on tools/call per hour (in-memory, per serverless instance).

This is a free discovery tier over the metered SocialBridge API — heavy users should go through the paid RapidAPI/Apify listings.

How it wraps social-api

Each tool handler does a plain fetch(\${SOCIALBRIDGE_MCP_API_BASE_URL}${path}`, ...)(with theX-RapidAPI-Proxy-Secret` header when configured) against the real SocialBridge REST API and returns the parsed JSON as MCP tool-result content:

js
{ content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] }

Upstream HTTP errors (4xx/5xx) are caught and surfaced as a typed MCP error result via an asError helper rather than crashing the request.

Local development

bash
npm installnode local-server.js &                       # serves /mcp and /health on :3900SOCIALBRIDGE_MCP_PROXY_SECRET=... npm run smoke   # real end-to-end smoke test

Source: README.md at commit ba7ca4c

Tools

10

social_profile

Get a social profile

Fetch one account profile from any supported network as the unified Profile schema (id, username, displayName, bio, url, followers, following, postCount, verified, avatarUrl, externalUrl), tagged with its platform. Keyless on Instagram, TikTok, YouTube, Pinterest, Snapchat, and Threads. Twitter/X, Reddit, and Facebook need operator-side credentials (returns credentials_required until set); LinkedIn is quarantined (platform_disabled).

Parametersplatformrequiredusernamerequired

social_posts

Get an account's recent posts

An account's recent posts / videos / tweets / threads / pins as the unified Post[] schema (id, url, author, text, createdAt, like/comment/share/view counts, mediaType, mediaUrls, hashtags), tagged with its platform. Keyless on Instagram, TikTok, YouTube, Pinterest, Snapchat, and Threads. Twitter/X, Reddit, and Facebook need operator-side credentials; LinkedIn is quarantined. For a keyless Reddit history pull use reddit_history.

Parameterslimitcursorplatformrequiredusernamerequired

social_comments

Get comments / replies on a post

Comments / replies on one post as the unified Comment[] schema, tagged with its platform. Provide url OR postId. Keyless on TikTok, YouTube, and Threads (and a single tweet via syndication on Twitter/X). Instagram, Reddit, and Facebook need operator-side credentials; Snapchat comments are not supported keyless; LinkedIn is quarantined.

ParametersurllimitcursorpostIdplatformrequired

search_all

Search every network at once

The wedge no incumbent offers: fan one search query out across the requested platforms (default: all keyless, non-disabled) in parallel, merge the unified Post[], and tag each result with its platform. Gated / disabled / unsupported / throttled engines are listed under "skipped" with an honest reason — the call still returns whatever came back.

Parametersqrequiredlimitplatforms

reddit_history

Reddit full history (keyless)

Keyless full-history pull via Arctic Shift — a user's or subreddit's posts, or a keyword search across Reddit history, returned as the unified Post[]. Provide at least one of username, subreddit, or q. Optional before/after bound the window by epoch-seconds or ISO timestamp.

Parametersqafterlimitbeforeusernamesubreddit

facebook_ads

Facebook / Meta Ad Library

Meta (Facebook/Instagram) Ad Library records as the unified Ad[] (id, pageName, adCreativeBody, adSnapshotUrl, startDate, currency, spend + impression ranges). Provide q OR pageId. GATED — needs operator-side FACEBOOK_ACCESS_TOKEN (with ads_read); returns credentials_required until set.

ParametersqlimitpageIdcountry

youtube_transcript

YouTube transcript / caption languages

Available caption-language list (and cue segments where retrievable) for a YouTube video. Provide url OR videoId. Keyless. NOTE: actual cue text is BotGuard-gated keyless, so it is reported honestly (available:false, empty segments) rather than fabricated.

ParametersurllangvideoId

threads_post

Threads post by shortcode

Fetch a single thread by shortcode or URL, including its replies, as the unified Post (with replies). Provide code OR url. Keyless.

Parametersurlcode

snapchat_spotlight

Snapchat creator Spotlight feed

A creator's public Snapchat Spotlight feed as the unified Post[] with real view/comment/share counts. Keyless.

Parameterslimitusername

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

90% 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 listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.