Social Media Server

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

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: MCP Twitter

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

Clone the repository
Install dependencies:

npm install

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.