Skip to main content
Glama
Sign In
enesjakozh
social-media-mcp

social-media-mcp

by angheljf
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

Social Media Server

A Model Context Protocol (MCP) server for managing social media posts, currently supporting X (formerly Twitter).

Example

Features

  • Post messages to X (Twitter)

  • Create threads on X

  • Reply to existing threads

  • List X posts with filtering options

  • Platform information endpoints

Related MCP server: SocialData MCP Server

Prerequisites

  • Node.js 16 or higher

  • Twitter API credentials

    • API Key

    • API Secret

    • Access Token

    • Access Secret

Installation

Installing via Smithery

To install Social Media Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install social-media-server --client claude

Manual Installation

  1. Clone the repository

  2. Install dependencies:

npm install

  1. Create a .env file with your Twitter credentials:

TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET=your_api_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_SECRET=your_access_secret

Building

To build the project, run:

npm run build

Available Tools

  • post_to_x - Post a message to X

    • Required: content (string)

    • Optional: threadId (string)

  • create_x_thread - Create a new thread on X

    • Required: content (string)

  • list_x_post - List X posts with optional filtering

    • Optional: limit (number)

    • Optional: threadId (string)

Resources

The server provides platform information via:

  • socialmedia://platforms/x

Development

The project uses TypeScript and follows the Model Context Protocol specification. The main server implementation is in index.ts, with types defined in types.ts.

License

This project is licensed under the MIT License

Available Tools

3 tools
create_x_threadC

Create a thread on X (formerly Twitter)

Inputs: content (required).

list_x_postsC

List X (formerly Twitter) posts

Inputs: limit, threadId.

post_to_xC

Post a message to X (formerly Twitter)

Inputs: content (required), threadId.

Tool Schema Changelog

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

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    C2.6/5.0

    Scored across 3 tools

    Disambiguation2/5

    The tools have significant overlap and unclear boundaries. 'create_x_thread' and 'post_to_x' both involve posting to X, with the distinction between a 'thread' and a 'post' not clearly defined in the descriptions, leading to potential confusion. 'list_x_posts' is more distinct but still part of the same ambiguous posting domain.

    Naming Consistency4/5

    The naming follows a consistent verb_noun pattern with 'create_x_thread', 'list_x_posts', and 'post_to_x', all using snake_case. However, there is a minor deviation in the verb choice: 'create' vs. 'post' for similar actions, which slightly reduces consistency.

    Tool Count2/5

    With only 3 tools, the server feels too thin for a social media domain, lacking essential operations like updating, deleting, searching, or interacting with other platforms. This limited scope may hinder agents from performing common social media tasks effectively.

    Completeness2/5

    The tool surface is severely incomplete for a social media server. It focuses only on X (Twitter) with basic create and list operations, missing critical functions such as update, delete, reply, like, follow, or support for other platforms like Facebook or Instagram, leading to significant gaps in agent workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • MCP Twitter

      0xhijo
      A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI models and applications to interact directly with Twitter/X, providing capabilities to create posts, reply to tweets, retrieve user data, and manage account actions.
      5 npm
      11
      MIT

    • SocialData MCP Server

      TheSethRose
      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
      -

    • X.com MCP Server

      tiovikram
      F
      license
      A
      quality
      D
      maintenance
      Model Context Protocol server that enables LLMs to interact with X.com (formerly Twitter) through OAuth 2.0 authentication, supporting major Post-related operations including reading, writing, searching, and managing posts, likes, retweets, and bookmarks.
      21
      49 npm
      8
      -

    • Twitter MCP Server

      aali-1
      A
      license
      Not graded
      quality
      D
      maintenance
      Model Context Protocol server that enables programmatic interaction with Twitter API, allowing users to post tweets, search for content, and retrieve user timelines through standardized MCP tools.
      14 npm
      MIT

    Appeared in Searches