Agent Twitter Client MCP

A service that integrates with Twitter through the Model Context Protocol (MCP), allowing AI models to interact with Twitter without directly accessing the API. It supports tweet operations, user operations, and Grok AI integration.

Social media Artificial intelligence chatbots #Twitter Integration #AI Interaction #Grok Chat #Tweet Operations Remote .TypeScript

rating : 2.5 points

downloads : 23

update time : 2025-04-28

What is the Twitter MCP Server?

The Twitter MCP (Model Context Protocol) server is an intermediate service that allows AI models to securely access Twitter features through proxy without directly accessing the Twitter API. It offers a rich set of features and supports various operations such as tweeting, searching, liking, and retweeting.

How to use the Twitter MCP Server?

First, you need to install and run the MCP server, then configure your Twitter authentication information. After that, you can use the APIs provided by MCP through the command line or integration to perform various operations.

Applicable Scenarios

It is suitable for application scenarios where you want to use Twitter data for analysis, content generation, or social media management. For example, AI models can be used to write tweets, monitor trending topics, or interact with users.

Main Features

Get User TweetsGet tweets from a specific user.

Get Specified TweetGet a specific tweet by tweet ID.

Tweet SearchSearch for tweets based on keywords.

Send TweetPublish a new tweet.

Create PollAdd poll options to a tweet.

Like, Retweet, and Quote TweetLike, retweet, or quote a tweet.

Get User ProfileGet a user's profile.

Follow UserFollow other users.

Get Followers and Following ListsGet a user's followers or following list.

Chat with GrokHave a conversation with Grok through the Twitter interface.

Advantages and Limitations

Advantages

Use features without directly accessing the Twitter API.

Support multiple authentication methods, including cookies, username/password, and API keys.

Integrate Grok functionality for real-time access to Twitter data.

Easy to integrate with other AI tools.

Limitations

The Grok functionality requires a specific version of the proxy client.

There may be rate limits that affect frequent operations.

Twitter authentication information needs to be properly stored and protected.

How to Use

Install the MCP Server

Install the MCP server globally or locally.

Configure Environment Variables

Set the authentication method (cookies, username/password, or API key).

Start the MCP Server

Run the MCP server to start using it.

Usage Examples

Search for TweetsSearch for tweets about AI.

Publish a TweetPublish a simple tweet.

Interact with GrokHave a conversation with Grok through Twitter.

Frequently Asked Questions

How to obtain the cookies required for cookie authentication?

Is the Grok functionality paid?

How to solve the rate limit problem?

Related Resources

Official Documentation

The GitHub repository for the MCP server.

Test Interface

An interactive command - line interface for testing MCP functionality.

🚀 Agent Twitter Client - MCP

The Agent Twitter Client - MCP is a powerful tool that enables seamless interaction with Twitter. It offers a range of features and deployment options to meet various user needs.

🚀 Quick Start

The Agent Twitter Client - MCP is a Twitter client that requires specific environment configurations and installation steps. Below is a detailed guide to help you get started quickly.

✨ Features

It requires Node.js version 18 or higher and the npm package manager.
Supports multiple deployment methods, including direct Docker usage and Docker Compose.
Allows configuration of environment variables for customized settings.
Ensures log persistence for easy monitoring and debugging.

📦 Installation

Prerequisites

Node.js 18+
npm package manager

Installation Steps

Clone the repository:

git clone https://github.com/ryanmac/agent-twitter-client-mcp.git
cd agent-twitter-client-mcp

Install dependencies:

npm install

Create a .env configuration file:

AUTH_METHOD=cookies
TWITTER_COOKIES=["cookie1=value1", "cookie2=value2"]

Build the project:

npm run build

Start the server:

npm start

💻 Usage Examples

Environment Variable Settings

In addition to authentication-related variables, you can also configure the following:

LOG_LEVEL: Set the log level (error, warn, info, debug).
NODE_ENV: Set the runtime environment (development, production).

Docker Deployment

Using Docker Directly

# Build the Docker image
docker build -t agent-twitter-client-mcp .

# Start the container and map ports
docker run -p 3000:3000 \
  -e AUTH_METHOD=cookies \
  -e TWITTER_COOKIES='["auth_token=YOUR_AUTH_TOKEN; Domain=.twitter.com", "ct0=YOUR_CT0_VALUE; Domain=.twitter.com"]' \
  agent-twitter-client-mcp

Using Docker Compose

Create a .env file containing Twitter credentials.
Run the service:

# Start the service
docker-compose up -d

# View logs
docker-compose logs -f

# Stop the service
docker-compose down

Docker Environment Variable Configuration

You can pass environment variables in the following ways:

Configure in the docker-compose.yml file (already included in the configuration).
Use a .env file (recommended for docker-compose).
Specify directly in the docker run command (as shown above).

Log Persistence

The Docker Compose configuration includes log volume mounting:

volumes:
  - ./logs:/app/logs

This stores logs in the logs folder under the project directory.

🔧 Technical Details

Security Considerations

Credential Storage: Store credentials securely. It is recommended to use environment variables or a secure vault.
Rate Limiting: Implement rate limiting to prevent abuse of the Twitter API.
Content Validation: Validate all content before publishing to prevent malicious use.