X V2 Server

An MCP server that implements the Twitter/X API v2 functions, providing tools for tweet retrieval, publishing, interaction, etc., and supporting programmatic operations by AI assistants.

Social media Marketing #Twitter API #Tweet Management #Social Interaction #MCP Service Remote .TypeScript

rating : 2.5 points

downloads : 18

update time : 2025-04-28

What is the X(Twitter) V2 MCP Server?

This is a server based on the Model Context Protocol, specifically designed to interact with the Twitter/X platform. It provides a series of tools that allow AI assistants to access various Twitter functions programmatically, such as publishing content, interacting, and managing lists.

How to use the X(Twitter) V2 MCP Server?

Before use, you need to configure the API keys of your Twitter developer account. Then you can perform various Twitter operations through simple API calls, such as tweeting, replying, and liking.

Use Cases

Suitable for scenarios that require automated Twitter interaction, such as social media management, automatic content publishing, and data analysis.

Main Features

Get TweetsYou can get the tweets published by a user through the user ID, or get a specific tweet through the tweet ID.

Publish a TweetSupports publishing plain text tweets or tweets with images.

Interaction FeaturesSupports interaction operations such as replying to tweets, quoting tweets, and liking tweets.

User ManagementYou can follow/unfollow users and get user information.

List ManagementCreate and manage Twitter lists, add/remove list members.

Search FunctionSearch for tweets and get trending topics.

Advantages and Limitations

Advantages

Provides full coverage of the Twitter API v2 functions

Simplifies the complex API call process

Supports image upload and publishing

Good pagination support, suitable for large data volume scenarios

Limitations

Requires a Twitter developer account and API keys

Subject to the usage restrictions of the Twitter API

Some advanced features require additional permissions

How to Use

Get API Keys

Get API keys and access tokens from the Twitter developer platform.

Configure Environment Variables

Set environment variables such as TWITTER_API_KEY.

Install and Run

Install dependencies and start the server.

Use the Tool

Access http://127.0.0.1:6274 to configure the environment and start using.

Usage Examples

Monitor Brand MentionsRegularly check tweets that mention your brand.

Automatically Reply to CustomersAutomatically reply to customers' question tweets.

Automatic Content PublishingPublish marketing content regularly.

Frequently Asked Questions

How to get Twitter API keys?

Why is my request restricted?

Does it support video upload?

Related Resources

Twitter API Official Documentation

The official documentation of the Twitter API v2

Twitter Developer Platform

The developer platform for applying for API keys

Model Context Protocol

The official documentation of the MCP protocol

🚀 X (Twitter) V2 MCP Server

A tool implementing an MCP server for interacting with the Twitter/X API v2. This service allows AI assistants to programmatically retrieve tweets, post new content, reply to tweets, quote tweets, etc.

🚀 Quick Start

This X MCP server enables seamless interaction with the Twitter/X API v2. Below are the details of its usage.

✨ Features

The X MCP service offers the following tools for interacting with the Twitter/X API:

get_tweets_by_userid

Retrieve tweets from a specific user's profile.

userId: The ID of the user to search for.
paginationToken (optional): A token to get the next page of results.
exclude (optional): Types of tweets to exclude (retweets, replies).
maxResults (optional): The maximum number of tweets to return (default: 10).

get_tweet_by_id

Get a single tweet by its ID.

tweetId: The ID of the tweet to retrieve.

get_user_mentions

Retrieve tweets that mention a specific user.

userId: The ID of the user to get mentions for.
paginationToken (optional): A token to get the next page of results.
maxResults (optional): The maximum number of mentions to return (default: 10).

quote_tweet

Create a quote tweet with custom text.

tweetId: The ID of the tweet to quote.
replyText: The text to include in the quote.

reply_to_tweet

Reply to an existing tweet.

tweetId: The ID of the tweet to reply to.
replyText: The content of the reply.

post_tweet

Post a new tweet.

text: The content of the tweet.
imageBase64: The image to post (in Base64 format).

like_tweet

Like a specific tweet.

tweetId: The ID of the tweet to like.

follow_user

Follow a Twitter user.

targetUserId: The ID of the user to follow.

unfollow_user

Unfollow a Twitter user.

targetUserId: The ID of the user to unfollow.

get_user_by_username

Get Twitter user information by username.

username: The username (without the @ symbol).

search_tweets

Search for tweets using a query string.

query: The search query.
maxResults (optional): The maximum number of results to return (default: 10).

get_trending_topics

Get trending topics for a specific location.

woeid (optional): The "Where On Earth ID" (WOEID) of the region (1 for global, default: 1).

create_list

Create a new Twitter list.

name: The name of the list.
description (optional): An optional description of the list.
isPrivate (optional): Whether to make the list private (default: false).

add_list_member

Add a user to a Twitter list.

listId: The ID of the list.
userId: The ID of the user to add.

remove_list_member

Remove a user from a Twitter list.

listId: The ID of the list.
userId: The ID of the user to remove.

get_owned_lists

Get all lists owned by the currently logged-in user.

No parameters required.

📦 Installation

To use this MCP server, you need to set the following environment variables:

# Example configuration

💻 Usage Examples

Basic Usage

Here are the steps to set up and run the server:

Clone the repository:

git clone https://github.com/yourusername/x-v2-server.git
cd x-v2-server

Install dependencies:

npm install

Start the server:

node index.js

📚 Documentation

📄 License

[Insert license information]

This document provides a comprehensive guide for the use and development of the X (Twitter) V2 MCP Server.

Featured MCP Services

Notion Api MCP

Certified

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

Python

141

4.5 points

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

TypeScript

4.3 points

Figma Context MCP

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

567

5 points

Minimax MCP Server

The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.

Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.

TypeScript

5.2K

4.7 points

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご