What can you do with this server?

This social-media-mcp server allows you to manage X (formerly Twitter) posts with the following capabilities: * Post messages to X, including replying to existing threads * Create new threads on X with provided content * List X posts with optional filtering by limit and thread ID * Access platform information for X via the provided endpoint

How do I use social-media-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@social-media-mcp post a new thread about the latest AI developments" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

social-media-mcp by angheljf

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.