What is X Post Mcp Server

x-post-mcp-server is a Model Context Protocol (MCP) server designed for interacting with the X (formerly Twitter) API. It includes a client that utilizes Google’s Gemini AI for natural language interactions and features automated daily posting scripts.

Use cases

Use cases include automating daily posts of news summaries, sharing inspirational quotes, and commemorating historical events, making it suitable for content creators, marketers, and developers interested in leveraging AI for social media engagement.

How to use

To use x-post-mcp-server, clone the repository, set up the required environment variables with your API keys for X/Twitter and Google Gemini AI, and run the server. You can then interact with the MCP server to create posts or utilize the automated posting features.

Key features

Key features include an MCP server that exposes a ‘createPost’ tool for posting tweets, a client that connects to the server using Google Gemini AI, and automated scripts for daily posting of Hacker News recaps, quotes, and historical events.

Where to use

x-post-mcp-server can be used in social media management, content automation, and AI-driven interactions, particularly for users or businesses looking to enhance their presence on X (Twitter).

🤖 MCP X/Twitter Post Server & Client

This project demonstrates a Model Context Protocol (MCP) server that allows interaction with the X (formerly Twitter) API, along with a client to interact with the server using Google’s Gemini AI, and automated daily posting scripts.

✨ Features

• MCP Server (/server): Exposes a createPost tool via MCP to post tweets.
• MCP Client (/client): Connects to the MCP server and uses Google Gemini AI to interact with the createPost tool through natural language.
• Auto Poster (/server/autopost.ts): 🚀 Fetches top Hacker News stories daily, generates a recap using Gemini AI, and posts it to X using the createPost tool.
• Quote Poster (/server/autopost_quotes.ts): 💬 Fetches a random ZenQuotes quote and posts it to X.
• On This Day Poster (/server/autopost_today.ts): 📅 Fetches a historical event for today from ZenQuotes and posts it to X.
• GitHub Actions: 🤖 Automates posting with workflows:
  • /.github/workflows/daily-post.yml: 📰 Posts Hacker News recap daily at 12:00 UTC.
  • /.github/workflows/autopost_quotes.yml: 💡 Posts a quote daily at 4:00 UTC.
  • /.github/workflows/autopost_today.yml: 🏛️ Posts a historical event daily at 18:00 UTC.

🚀 Getting Started

Prerequisites

• Bun installed (v1.2.5 or later recommended).
• Node.js (compatible version for Bun).
• API keys for X/Twitter and Google Gemini AI.

Setup

1. Clone the repository:

   git clone https://github.com/Xeven777/x-post-mcp-server
   cd x-post-mcp-server
   

2. Environment Variables:
   • Navigate to the server directory: cd server
   • Create a .env file by copying the example or creating a new one. See server/.env for required variables (you’ll need TWITTER_API_KEY, TWITTER_API_SECRET, TWITTER_ACCESS_TOKEN, TWITTER_ACCESS_SECRET, GEMINI_API_KEY).
   • Fill in your API credentials.
   • Navigate back to the root directory: cd ..
   • (Optional) If the client needs specific environment variables (like GEMINI_API_KEY if not using the server’s), repeat the .env creation process in the client directory. The current client reads GEMINI_API_KEY from the environment it’s run in.

🖥️ Server (/server)

The server exposes the MCP endpoint and the createPost tool.

1. Navigate to the server directory:

   cd server
   

2. Install dependencies:

   bun install
   

3. Run the server:

   bun run dev
   

   Or, to run the compiled version (after building):

   bun run build
   bun run start
   

   The server will be running on http://localhost:3001.

🗣️ Client (client)

The client connects to the server and allows you to interact with the createPost tool using natural language via Gemini.

1. Navigate to the client directory:

   cd client
   

2. Install dependencies:

   bun install
   

3. Ensure the server is running.
4. Run the client:
   (Make sure GEMINI_API_KEY is available in this terminal’s environment)

   bun run index.ts
   

   You can now chat with the AI. Try asking it to “post ‘Hello World!’ to X”.

📰 Auto Posters (/server/autopost.ts, /server/autopost_quotes.ts, /server/autopost_today.ts)

• Hacker News Recap: 🚀 Fetches the top 5 Hacker News stories from the last ~24 hours, uses Gemini to generate a witty recap, and posts it to X.
• Quote Poster: 💬 Fetches a random quote from ZenQuotes and posts it to X.
• On This Day Poster: 📅 Fetches a historical event for today from ZenQuotes and posts it to X.

How to use:

1. 📂 Navigate to the server directory:

   cd server
   

2. 📦 Install dependencies:

   bun install
   

3. 🔑 Set up your .env file with Twitter and Gemini keys.
4. ▶️ Run the scripts directly:

   bun run autopost.ts           # 🚀 Hacker News Recap
   bun run autopost_quotes.ts    # 💬 ZenQuotes Quote
   bun run autopost_today.ts     # 📅 On This Day Event
   

🔁 Automated GitHub Actions

The following workflows keep your X account fresh and fun, automatically:

• daily-post.yml: 📰 Runs server/autopost.ts every day at 12:00 UTC.
• autopost_quotes.yml: 💡 Runs server/autopost_quotes.ts every day at 4:00 UTC.
• autopost_today.yml: 🏛️ Runs server/autopost_today.ts every day at 18:00 UTC.

Each workflow:

• ✅ Checks out the code
• 🛠️ Sets up Node.js
• 📦 Installs dependencies
• 🚦 Runs the respective script using secrets configured in the GitHub repository settings

Enjoy using the MCP X Poster! 🎉