Happy slice of mcp pizzaMCP.pizza
Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AIFire in da houseCheck it out free

mcp-x

MCP.Pizza Chef: Lyonsupernova

mcp-x is a Model Context Protocol (MCP) server designed to connect the Claude language model with the X (formerly Twitter) API v2. It enables real-time interaction with the X platform, allowing models to post tweets and engage with social media content programmatically. Built on top of the official X API v2, mcp-x facilitates secure and efficient communication by requiring developer credentials such as Access Token, Secret, Client ID, Client Secret, and Bearer token. This server is ideal for developers looking to integrate social media capabilities into AI workflows, enhancing automation and contextual awareness within the MCP ecosystem.

Use This MCP server To

Post tweets programmatically via Claude Integrate social media updates into AI workflows Automate tweet generation and posting Enable real-time social media interaction for models Fetch and manage X API credentials securely

README

mcp-x MCP server

MCP project to connect Claude with X API. Built on top of X API v2

Demo

demo.mp4

Supported Features

  • Post tweets

Configuration

Getting Started with X

  • Go to X Developer Platform and login with your X account
  • Start with Basic plan
  • Store the Access Token, Secret, Client ID, Client Secret and Bearer token Docs: x-api-start

Set up

  • On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "x": {
      "command": "uv",
      "args": [
        "--directory",
        "PROJECT_PATH/src/mcp_x",
        "run",
        "mcp-x"
      ],
      "env": {
        "X_API_KEY": "YOUR_API_KEY",
        "X_API_KEY_SECRET": "YOUR_API_KEY_SECRET",
        "X_ACCESS_TOKEN": "YOUR_ACCESS_TOKEN",
        "X_ACCESS_TOKEN_SECRET": "YOUR_ACCESS_TOKEN_SECRET",
        "X_BEARER_TOKEN": "YOUR_BEARER_TOKEN",
        "LOGGING_PATH": "PROJECT_PATH/src/mcp_x/logs"
      }
    }
  }
}

TODO

  • Tests
  • Add Get tweets
  • Add Delete tweets
  • ...

Deployment

(todo)

Building and Publishing

To prepare the package for distribution:

  1. Sync dependencies and update lockfile:
uv sync
  1. Build package distributions:
uv build

This will create source and wheel distributions in the dist/ directory.

mcp-x FAQ

How do I configure mcp-x on my system?
On MacOS, configure via '~/Library/Application Support/Claude/claude_desktop_config.json'. On Windows, use '%APPDATA%/Claude/claude_desktop_config.json'.
What credentials are required to use mcp-x?
You need Access Token, Secret, Client ID, Client Secret, and Bearer token from the X Developer Platform.
Where can I get the API credentials for mcp-x?
Obtain them by signing up on the X Developer Platform and starting with the Basic plan.
Does mcp-x support posting tweets only?
Currently, mcp-x supports posting tweets; other X API features may be added later.
Is mcp-x compatible with other LLM providers besides Claude?
While designed for Claude, mcp-x can be adapted for use with other LLMs like OpenAI's GPT-4, Anthropic's Claude, and Google's Gemini with appropriate integration.
How is security handled when using mcp-x?
mcp-x requires secure storage of API credentials and uses official X API v2 endpoints to ensure safe communication.
Can I see a demo of mcp-x in action?
Yes, a video demo is available on the GitHub repository showcasing mcp-x capabilities.