Skip to main content
Glama

X MCP Server

X MCP Server

A Model Context Protocol (MCP) server for posting tweets to X (Twitter) and interacting with the X API.

Features

  • Post Tweets: Create and post tweets to X (Twitter)
  • Get User Timeline: Retrieve your recent tweets
  • Search Tweets: Search for tweets using queries
  • Reply to Tweets: Reply to existing tweets
  • Error Handling: Comprehensive error handling and validation

Prerequisites

  1. X Developer Account: You need a Twitter/X developer account
  2. Node.js: Version 18 or higher

Setup

  1. Clone and Install Dependencies:
    npm install
  2. Configure Environment Variables:
    cp env.example .env
    Edit .env and add your X API credentials:
    X_API_KEY=your_api_key_here X_API_SECRET=your_api_secret_here X_ACCESS_TOKEN=your_access_token_here X_ACCESS_TOKEN_SECRET=your_access_token_secret_here
  3. Build the Project:
    npm run build

Usage

Running the Server

# Development mode npm run dev # Production mode npm start

Available Tools

The server provides the following tools:

1. post_tweet

Post a new tweet to X.

Parameters:

  • text (required): The tweet content (max 280 characters)
  • reply_to_tweet_id (optional): ID of the tweet to reply to

Example:

{ "text": "Hello, world! This is my first tweet via MCP! 🚀", "reply_to_tweet_id": "1234567890123456789" }
2. get_user_timeline

Get your recent tweets.

Parameters:

  • count (optional): Number of tweets to retrieve (default: 10, max: 100)

Example:

{ "count": 5 }
3. search_tweets

Search for tweets using a query.

Parameters:

  • query (required): Search query
  • count (optional): Number of results (default: 10, max: 100)

Example:

{ "query": "MCP protocol", "count": 20 }

MCP Client Configuration

To use this server with an MCP client, add it to your client configuration:

{ "mcpServers": { "x-server": { "command": "node", "args": ["dist/index.js"], "env": { "X_API_KEY": "your_api_key", "X_API_SECRET": "your_api_secret", "X_ACCESS_TOKEN": "your_access_token", "X_ACCESS_TOKEN_SECRET": "your_access_token_secret" } } } }

Development

Project Structure

x-mcp-server/ ├── src/ │ └── index.ts # Main server implementation ├── dist/ # Compiled JavaScript (generated) ├── package.json # Dependencies and scripts ├── tsconfig.json # TypeScript configuration ├── env.example # Environment variables template └── README.md # This file

Scripts

  • npm run build: Compile TypeScript to JavaScript
  • npm start: Run the compiled server
  • npm run dev: Run in development mode with hot reload
  • npm test: Run tests (when implemented)

Error Handling

The server includes comprehensive error handling for:

  • Missing API credentials
  • Invalid tweet content (length, format)
  • API rate limits
  • Network errors
  • Invalid parameters

Security Notes

  • Never commit your .env file to version control
  • Keep your API credentials secure
  • Use environment variables for all sensitive data
  • Consider using a .gitignore file to exclude sensitive files

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests if applicable
  5. Submit a pull request

License

MIT License - see LICENSE file for details.

Support

For issues and questions:

  1. Check the error messages for common issues
  2. Verify your API credentials are correct
  3. Ensure you have the necessary X API permissions
  4. Check the X API documentation for rate limits and restrictions

x-mcp-server

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables users to interact with X (Twitter) through the X API. Supports posting tweets, retrieving user timelines, searching tweets, and replying to tweets with comprehensive error handling.

  1. Features
    1. Prerequisites
      1. Setup
        1. Usage
          1. Running the Server
          2. Available Tools
        2. MCP Client Configuration
          1. Development
            1. Project Structure
            2. Scripts
          2. Error Handling
            1. Security Notes
              1. Contributing
                1. License
                  1. Support
                    1. x-mcp-server

                      Related MCP Servers

                      • A
                        security
                        A
                        license
                        A
                        quality
                        Server for X (Twitter) integration that provides tools for reading your timeline and engaging with tweets. Designed for use with Claude desktop.
                        Last updated -
                        3
                        3
                        30
                        JavaScript
                        MIT License
                      • -
                        security
                        A
                        license
                        -
                        quality
                        Enables interaction with Twitter through a Model Context Protocol, allowing large language models to post tweets, search for tweets, and reply to tweets.
                        Last updated -
                        25
                        3
                        18
                        TypeScript
                        MIT License
                        • Apple
                      • -
                        security
                        F
                        license
                        -
                        quality
                        Provides AI agents with comprehensive Twitter functionality through the Model Context Protocol standard, enabling reading tweets, posting content, managing interactions, and accessing timeline data with robust error handling.
                        Last updated -
                        5
                        11
                        JavaScript
                        • Apple
                      • -
                        security
                        A
                        license
                        -
                        quality
                        A Model Context Protocol server that enables AI models and applications to interact directly with Twitter/X, providing capabilities to create posts, reply to tweets, retrieve user data, and manage account actions.
                        Last updated -
                        10
                        8
                        TypeScript
                        MIT License

                      View all related MCP servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/krishna-paulraj/x-mcp-server'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server