Skip to main content
Glama
Social Search MCP

Social Search MCP

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=searxng

  • SEARXNG_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=serper

  • SERPER_API_KEY=your_key (Get one from Serper.dev)

The official Google Custom Search API.

  • SEARCH_PROVIDER=google

  • GOOGLE_API_KEY=your_key

  • GOOGLE_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 tool
search_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

    B3.1/5.0

    Scored across 1 tool

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables LLMs to perform web searches using Google's Custom Search API through a standardized interface.
      1
      47
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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
      -