Developer Tools · Social Media

X MCP Server

mbelinky/x-mcp-server

An enhanced Model Context Protocol (MCP) server for X that adds OAuth 2.0 support, v2 API media uploads, and comprehensive rate limiting to the original implementation.

Install

npx -y @mbelinky/x-mcp-server

Client configuration

{
  "mcpServers": {
    "twitter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mbelinky/x-mcp-server"
      ],
      "env": {
        "API_KEY": "<API_KEY>",
        "API_SECRET_KEY": "<API_SECRET_KEY>",
        "ACCESS_TOKEN": "<ACCESS_TOKEN>",
        "ACCESS_TOKEN_SECRET": "<ACCESS_TOKEN_SECRET>"
      }
    }
  }
}

Environment variables

API_KEYAPI_SECRET_KEYACCESS_TOKENACCESS_TOKEN_SECRETAUTH_TYPEOAUTH2_CLIENT_IDOAUTH2_CLIENT_SECRETOAUTH2_ACCESS_TOKENOAUTH2_REFRESH_TOKEN
Author
@mbelinky
Category
Developer Tools, Social Media
License
MIT
Updated
Oct 6, 2026

Features

  • Post Tweets: Create text tweets with optional media attachments (images, GIFs)

  • Search Tweets: Search X with customizable result count

  • Dual Authentication: Support for both OAuth 1.0a and OAuth 2.0

  • Rate Limiting: Built-in protection for X's API limits

  • Type Safety: Full TypeScript implementation with Zod validation

Tools (7)

  • v1.1

    Legacy API, being phased out but still works with OAuth 1.0a

  • v2

    Modern API with better features but some endpoints have issues

  • Media

    OAuth 2.0 tokens cannot access v1.1 media endpoints, must use v2

  • Delete

    v2 delete endpoint currently has issues (500 errors), v1.1 works as fallback

  • post_tweet

    Post a new tweet with optional media attachments and replies.

  • search_tweets

    Search for tweets with customizable result count (10-100).

  • delete_tweet

    Delete a tweet by its ID.

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS

Related MCP servers

More servers
Playwright logo

Playwright

microsoft/playwright

72.2k

Playwright is a framework for web automation and testing. It drives Chromium, Firefox, and WebKit with a single API — in your tests, in your scripts, and as a tool for AI agents.

Developer Tools
repomix logo

repomix

yamadashy/repomix

15.2k

Repomix is a tool that packs a codebase into an AI-friendly format, supporting local and remote repository processing and providing code compression, security checks and multiple output formats.

Developer Tools
UI-TARS-desktop logo

UI-TARS-desktop

bytedance/UI-TARS-desktop

12.9k

TARS is ByteDance's multimodal AI agent stack, shipping two projects: Agent TARS (a CLI and Web UI agent built on MCP) and UI-TARS-desktop (a desktop GUI agent).

Developer Tools
blender logo

blender

ahujasid/blender-mcp

10.6k

formerly blender-mcp — the PyPI package is now mcp-for-blender. Existing setups keep working; no config change is required. Read more.

Developer Tools
Playwright Browser Automation logo

Playwright Browser Automation

microsoft/playwright-mcp

9.2k

A Model Context Protocol (MCP) server that provides browser automation capabilities using Playwright. This server enables LLMs to interact with web pages through structured accessibility snapshots, bypassing the need for screenshots or visually-tuned models.

Developer Tools
2344 logo

2344

comet-ml/opik

7k

Opik is the open-source LLM observability and evaluation platform for AI agent tracing, LLM evaluation, prompt management, and production monitoring. Built by Comet. Apache-2.0 licensed, free to self-host the full platform, with 20,000+ GitHub stars.

Developer Tools