Skip to main content
Glama
social-search-mcp

social-search-mcp

by vialan-art

Social Search

Personal Codex plugin for Reddit and X search and post retrieval. It packages a short Skill and four MCP tools around one tested provider implementation. The CLI and legacy HTTP adapters reuse that implementation.

Installed Architecture

Codex plugin -> existing SSH connection -> VPS stdio MCP
                                         |- Reddit -> loopback Redlib -> Reddit
                                         `- X -> TwitterAPI.io

Existing n8n -> Docker bridge -> legacy HTTP adapters -> same providers
Browser -> Cloudflare -> nginx -> Redlib (static/media cache; dynamic no-store)

Current repair and rollback evidence: 2026-09-07 verification.

The MCP transport has no public listening port. Configure scripts/connect-vps with SOCIAL_SEARCH_VPS_HOST, SOCIAL_SEARCH_VPS_PORT, SOCIAL_SEARCH_VPS_KEY, and (when needed) SOCIAL_SEARCH_VPS_USER; no host address, key or credential is included in this repository. X credentials are read inside the VPS process from the protected runtime configuration.

Related MCP server: hidrix-tools

Tools

Tool

Behavior

reddit_search

Native ordering, canonical source URLs, bounded session pagination

reddit_post

Original post and comments, parent IDs, hard count/depth limits, coverage

x_search

One complete provider page, original order, IDs and next cursor

x_post

Read requested IDs and available quote/reply context; report missing IDs

Errors remain errors, including authentication, quota, rate limits and malformed upstream pages. Results retain source links and distinguish returned content from loaded or source-reported totals. Comment permalink pages disclose unknown parents.

Reddit search cursors expire after 15 minutes and belong to one server process. A new Codex task or restarted MCP server requires a new search. Separate CLI invocations cannot continue those in-memory cursors. X calls use an existing paid third-party account and are not automatically retried. A page is usually 20 posts; requesting fewer locally does not reduce the upstream page charge.

Development

Node.js 22 or newer is required for the provider package on the VPS. The installed local bridge requires only SSH. Dependencies are pinned in package-lock.json.

npm ci --ignore-scripts
npm test
node src/cli.mjs doctor
node scripts/verify-live.mjs ./scripts/connect-vps

The final command performs live Reddit requests and a small paid X search/read. Use it deliberately, not as a periodic free health probe. The ordinary X health endpoint checks configuration only and explicitly says upstream_verified:false.

Compatibility and Caching

Existing Reddit GET /api/search, GET /api/post, and X POST /api/search routes remain available on loopback and Docker bridge addresses. Legacy Reddit modes are accepted as labels, with native ordering; old popularity filters are removed. The legacy X limit is an explicitly reported preview and may omit rows from the provider page. Use MCP for full-page pagination.

All /api/ responses bypass nginx cache and declare private, no-store for CDN caches. Normal Redlib webpage and media caching remains enabled. MCP reads Redlib on loopback directly, bypassing both nginx and Cloudflare page caches.

See deployment verification for observed results, current release locations, rollback steps, and remaining boundaries.

Provenance

The archived reference repository was reviewed at commit 3e9dea1951ce359f9232378efb6edb81126d1526; its source remains untouched. The new package lives separately. Real HTML fixtures were captured from the existing Redlib deployment. The comment-template fixture comes from Redlib commit a4d36e954cf1bd64f209cd8868c5a29edc81b374. Upstream fixtures retain their respective project provenance. This package is private and no publication license is granted.

Available Tools

4 tools
reddit_postA
Read-onlyIdempotent

Read a Reddit post and loaded comments with original links, parent IDs and explicit coverage. The count is a hard budget; results are not a complete or unbiased survey. Follow next_links for more threads.

Inputs: url (required), sort, maxDepth, maxComments.

x_postA
Read-onlyIdempotent

Read X posts by numeric ID through TwitterAPI.io, including available quotes and reply references. Reports missing IDs; does not fetch a full reply thread. Billed per returned post.

Inputs: ids (required), detail.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 4 tools

    Disambiguation4/5

    Each tool pairs a platform with a clear action (search vs. reading a specific post), so boundaries are largely distinct. The verb 'post' is mildly ambiguous since it means 'read a post object' rather than 'publish', but descriptions resolve this.

    Naming Consistency5/5

    All four tools follow a strict platform_action pattern (reddit_search/reddit_post, x_search/x_post) with consistent snake_case and parallel verb usage across both platforms.

    Tool Count5/5

    Four tools is well-scoped: a symmetric 2x2 grid of two platforms times two operations (search and read). Every tool earns its place with no redundancy.

    Completeness4/5

    Search-plus-read coverage exists for both Reddit and X, including comment/quote context and pagination. Gaps remain for user/timeline lookups and full reply threads (x_post explicitly does not fetch them), but core workflows are workable via next_links/cursors.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP tool server that gives any AI agent the ability to search, scrape, and analyze content across the internet.
      42
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for realtime X (Twitter) search enabling keyword/semantic search, filters, date ranges, and citations for coding agents.
      3 npm
      MIT