MCP.so
Sign In

X-Post MCP Server

@subhadeeproy3902

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.

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