The Twitter MCP Server is a comprehensive API integration platform that allows interaction with Twitter's API for various operations:
- Tweet Operations: Post tweets (with or without media), reply to tweets, delete tweets, retrieve tweets by ID or in batches
- User Operations: Get user information, follow/unfollow users, retrieve user timelines, followers, and following lists (some features currently have availability issues)
- Engagement: Like/unlike tweets, retweet/undo retweets, and get lists of retweets and liked tweets
- Search & Analytics: Search for tweets and get hashtag analytics (some features currently have availability issues)
- List Management: Create lists, add/remove users from lists, and retrieve list members and user-owned lists
Uses environment variables from .env files to store Twitter API credentials securely
Uses npm for dependency management and running build/development scripts
Uses TypeScript for implementation of parameter validation and error handling
Twitter MCP Server
A Model Context Protocol server implementation for Twitter API integration.
Setup
- Clone the repository
- Install dependencies:
npm install
- Copy
.env.example
to.env
and fill in your Twitter API credentials - Build the project:
npm run build
- Start the server:
npm start
Environment Variables
Required Twitter API credentials in .env
:
Available Tools
Tweet Operations
postTweet
: Post a new tweetpostTweetWithMedia
: Post a tweet with media attachmentgetTweetById
: Get a specific tweet by IDreplyToTweet
: Reply to an existing tweetdeleteTweet
: Delete a tweet
Search & Analytics
searchTweets
: Search for tweetsgetHashtagAnalytics
: Get analytics for a hashtag
User Operations
getUserInfo
: Get user informationgetUserTimeline
: Get user's tweetsgetFollowers
: Get user's followersgetFollowing
: Get accounts a user follows
Engagement
likeTweet
: Like a tweetunlikeTweet
: Unlike a tweetretweet
: Retweet a tweetundoRetweet
: Undo a retweetgetRetweets
: Get users who retweeted a tweetgetLikedTweets
: Get tweets liked by a user
List Management
createList
: Create a new listaddUserToList
: Add a user to a listremoveUserFromList
: Remove a user from a listgetListMembers
: Get members of a list
Error Handling
All tools return standardized error responses:
- Missing parameters:
Missing required parameter: parameter_name
- API errors: Error message from Twitter API
- Not found errors: Appropriate "not found" message for the resource
Response Format
All successful responses follow this format:
Development
- Build:
npm run build
- Start:
npm start
- Watch mode:
npm run dev
Status: Working perfectly Response: Returns tweet ID Latest test: Success
Status: Working perfectly Response: Returns complete tweet data Latest test: Success
Status: Working perfectly Response: Confirmation of action Latest test: Success
Status: Working perfectly Response: Confirmation of action Latest test: Success
Status: Working perfectly Response: Returns reply tweet ID Latest test: Success
Status: Working perfectly Response: Complete user profile data Latest test: Success
Status: Working perfectly Response: Confirmation of action Latest test: Success
Status: Working perfectly Response: Confirmation of list creation Latest test: Success
Status: Working perfectly Response: Returns both owned and member lists Latest test: Success
Status: Error 400 Error: Invalid Request parameters Fix needed: Parameter validation
Status: Error 400 Error: Invalid Request parameters Fix needed: Query parameter formatting
Status: Error 400 Error: Invalid Request parameters Fix needed: Parameter validation
- Error Handling:
This server cannot be installed
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.
Tools
Enables interaction with Twitter through a Model Context Protocol, allowing large language models to post tweets, search for tweets, and reply to tweets.
Related Resources
Related MCP Servers
- -securityFlicense-qualityProvides 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 -41JavaScript
- -securityAlicense-qualityA Model Context Protocol server that enables AI to interact with Twitter, allowing functions like searching tweets, comparing sentiments across accounts, and retrieving timeline content.Last updated -MIT License
- -securityAlicense-qualityA 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 -874TypeScriptMIT License
Juhe News MCP Serverofficial
-securityFlicense-qualityA Model Context Protocol server that enables large language models to access the latest trending news headlines and detailed content across various categories including recommended, domestic, technology, and sports news.Last updated -Python