Social Search MCP
Enables searching and filtering content specifically from Facebook to retrieve relevant social media results.
Utilizes Google Search through Custom Search or Serper APIs to perform targeted searches across specified social media platforms.
Enables searching and filtering content specifically from Reddit to retrieve relevant discussions and posts.
Uses SearXNG as a metasearch engine backend to aggregate and filter results from various social media domains.
Social Search MCP Server
A Model Context Protocol (MCP) server that empowers LLMs to search across specific social media platforms using the industry's best search engines.
Overview
This server provides a search_social tool that accepts a query and an optional list of platforms (facebook, reddit, linkedin, etc.). It filters results exclusively to those domains and returns them directly to the LLM context.
Related MCP server: OneSearch MCP Server
Search Providers
You can configure the backend by setting the SEARCH_PROVIDER environment variable. By default, it uses SearXNG since it is free and open-source.
1. SearXNG (Default)
SearXNG is a free, open-source internet metasearch engine.
SEARCH_PROVIDER=searxngSEARXNG_URL=http://localhost:8080(Defaults to localhost, specify a remote public instance if you don't host your own, but note that public instances often limit automated JSON requests).
2. Serper.dev
A powerful Google Search wrapper API. Highly recommended for accurate results.
SEARCH_PROVIDER=serperSERPER_API_KEY=your_key(Get one from Serper.dev)
3. Google Custom Search
The official Google Custom Search API.
SEARCH_PROVIDER=googleGOOGLE_API_KEY=your_keyGOOGLE_CX=your_cx_engine_id
Setup
Ensure you have Python 3.10+ installed.
# Clone or place in a directory, then:
python -m venv venv
source venv/bin/activate
pip install -e .Usage with Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"social-search-mcp": {
"command": "/ABSOLUTE/PATH/TO/venv/bin/social-search-mcp",
"args": [],
"env": {
"SEARCH_PROVIDER": "searxng",
"SEARXNG_URL": "http://localhost:8080"
}
}
}
}Replace /ABSOLUTE/PATH/TO/ with the actual path to this folder. Restart Claude Desktop after updating the config.
Available Tools
1 toolsearch_socialC
Perform a web search focused ONLY on specific social media platforms.
Inputs: query (required), platforms, max_results, time_filter, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools, as there are no other tools to confuse it with. The tool's purpose is clearly defined and distinct by default.
The single tool name follows a consistent verb_noun pattern (search_social), and with only one tool, there is no inconsistency to evaluate. The naming is straightforward and predictable.
A single tool is too few for a server named 'Social Search MCP', which implies a broader scope of social media search operations. This minimal set feels thin and inadequate for the apparent domain, limiting functionality.
The tool surface is severely incomplete for social media search, as it only offers a generic search without coverage for specific platforms, filtering, or advanced operations like trending topics or user lookups. This will likely cause agent failures due to significant gaps.
Maintenance
Related MCP Connectors
Social media MCP server: your Instagram, TikTok, YouTube, LinkedIn and Threads history for your AI.
OAuth-enabled MCP server that extracts structured data from public social media posts.
Web search API and MCP server for developers building AI agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables LLMs to perform web searches using Google's Custom Search API through a standardized interface.147MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables web search, scraping, crawling, and content extraction through multiple engines including SearXNG, Firecrawl, and Tavily.4230 npm148MIT
- FlicenseNot gradedqualityDmaintenanceA comprehensive Model Context Protocol (MCP) server that provides tools for interacting with the SocialData API. This server allows you to fetch Twitter/X data, monitor user activity, and analyze social media engagement programmatically.7-
- AlicenseAqualityAmaintenanceA local-first, no-API-key MCP server that enables LLMs to search the web, fetch pages, and read documents using multiple engines and smart fallbacks.611186MIT