Advertise
MCP.so
Sign In

X-Post MCP Server

@subhadeeproy3902

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

subhadeeproy3902

About X-Post MCP Server

A Model Context Protocol (MCP) server that allows interaction with the X API, along with a client to interact with the server using Google's Gemini AI.

#twitter-api#gemini#mcp-server

X-Post MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "x-post-mcp": {
      "command": "bun",
      "args": [
        "run",
        "dev"
      ]
    }
  }
}

X-Post MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is 🐦 X-Post MCP 🚀?

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 using the Model Context Protocol (MCP). It integrates Google Gemini AI models with the X platform, allowing AI assistants to generate and post content.

How to use 🐦 X-Post MCP 🚀?

Install prerequisites (Bun v1.2.5+, X API credentials, Google Gemini API key). Clone the repository, install dependencies in both server and client directories, and create .env files with API keys. Start the server with bun run dev (listens on port 3001) and the client with bun run index.ts. Interact via the chat interface to instruct the AI to post to X.

Key features of 🐦 X-Post MCP 🚀

  • Seamless integration with X (Twitter) API v2
  • AI-powered post creation using Google Gemini models
  • MCP server exposes a createPost tool
  • Interactive chat interface for testing
  • Secure handling of API credentials
  • Automatic truncation of posts exceeding X's character limit

Use cases of 🐦 X-Post MCP 🚀

  • Automating social media posts from AI assistants
  • Generating and publishing AI-created content on X
  • Testing MCP-based tool integration with Twitter

Frequently asked questions

1

What does 🐦 X-Post MCP 🚀 do?

It allows AI models (via Gemini) to post to X (Twitter) by exposing a MCP tool called `createPost`. Users interact through a chat client that translates requests into AI-generated tweets.

2

What prerequisites are needed to run 🐦 X-Post MCP 🚀?

You need Bun v1.2.5 or later, X (Twitter) API credentials (API key, secret, access token, access secret), and a Google Gemini API key.

3

How do I obtain X API credentials for 🐦 X-Post MCP 🚀?

Register a developer account on the X Developer Portal, create a project and app, enable OAuth 1.0a with “Read and Write and Direct Messages” permissions, and generate consumer keys and access tokens.

4

How does the client communicate with the server in 🐦 X-Post MCP 🚀?

The server uses Server-Sent Events (SSE) for communication. The client connects to the MCP server and sends commands via the chat interface.

5

What happens if a post exceeds X’s character limit?

The server automatically truncates the post to fit within X’s character limit before publishing.

Comments

More Other MCP servers

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Advertise