x-post-mcp

x-post-mcp

3.5

X-Post MCP is a client-server application that enables AI models to create and publish posts on X (formerly Twitter) through a standardized interface.

X-Post MCP is a powerful integration tool that allows AI models to post directly to X (formerly Twitter) using the Model Context Protocol (MCP). It provides a seamless interface for AI models to interact with the X platform, leveraging Google's Gemini models for AI-powered post creation. The application is built using modern technologies such as Bun, TypeScript, and Express, ensuring a fast and type-safe environment. It includes features like secure handling of API credentials, automatic truncation of posts exceeding character limits, and an interactive chat interface for testing and demonstration. The server component implements the MCP and exposes X posting functionality as a tool, while the client component connects to the server and provides an interface for interacting with AI models.

Features

  • Seamless integration with X (Twitter) API
  • AI-powered post creation using Google's Gemini models
  • MCP server exposing X posting functionality as a tool
  • Interactive chat interface for testing and demonstration
  • Secure handling of API credentials

MCP Tools

  • {'createPost': 'Tool to post to X using the MCP server'}

Usage with Different Platforms

server_setup

bash
# Clone the repository
git clone https://github.com/subhadeeproy3902/x-post-mcp.git
cd x-post-mcp

# Install server dependencies
cd server
bun install

client_setup

bash
# From the project root
cd client
bun install

starting_the_server

bash
cd server
bun run dev

starting_the_client

bash
cd client
bun run index.ts