social-media-mcp

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

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.

License

This project is licensed under the MIT License