agent-twitter-client-mcp
@ryanmac
About agent-twitter-client-mcp
A Model Context Protocol (MCP) server that integrates with X using the @elizaOS `agent-twitter-client` package, allowing AI models to interact with Twitter without direct API access.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"agent-twitter-client-mcp": {
"command": "npx",
"args": [
"agent-twitter-client-mcp"
]
}
}
}Tools
14Fetch tweets from a specific user
Fetch a specific tweet by ID
Search for tweets
Post a new tweet
Post a tweet with a poll
Like a tweet
Retweet a tweet
Quote a tweet
Get a user's profile
Follow a user
Get a user's followers
Get users a user is following
Chat with Grok via Twitter
Check the health of the Twitter MCP server
Overview
What is agent-twitter-client-mcp?
A Model Context Protocol (MCP) server that integrates with Twitter using the agent-twitter-client package, allowing AI models to interact with Twitter without direct API access.
How to use agent-twitter-client-mcp?
Install globally or locally via npm, create a .env file with Twitter credentials (cookies, username/password, or API), and run the server with agent-twitter-client-mcp or npx agent-twitter-client-mcp. Configure it with Claude Desktop by adding the server to the MCP config file with the chosen authentication method. An interactive test CLI is also available via npx agent-twitter-client-mcp-test.
Key features of agent-twitter-client-mcp
- Cookie-based, username/password, or Twitter API v2 authentication
- Fetch, search, post, like, retweet, and quote tweets
- Create polls with multiple options and duration
- Get user profiles, follow users, and list followers/following
- Chat with Grok via Twitter's interface with conversation continuity
- Health check endpoint for server status
Use cases of agent-twitter-client-mcp
- Have an AI assistant search Twitter for recent news or topics
- Automate posting tweets with text, images, or videos from AI agents
- Analyze trending topics or user sentiment using Grok's real-time data
- Manage social media interactions like following, liking, and quoting
FAQ from agent-twitter-client-mcp
What authentication methods are supported?
Three methods: cookie-based (recommended), username/password with optional 2FA secret, and Twitter API v2 credentials.
Does Grok integration require special dependencies?
Yes, Grok functionality requires agent-twitter-client v0.0.19 or higher.
What are the rate limits for Grok?
Non-premium accounts: 25 messages per 2 hours; premium accounts have higher limits. The server returns rate limit info in responses when limits are reached.
Can I post tweets with media (images/videos)?
Yes, the server supports posting tweets with images and videos by providing file paths or URLs in the request.
Which port does the server use by default?
Default port is 3000. It can be changed via the PORT environment variable or Docker Compose configuration.
Frequently asked questions
What authentication methods are supported?
Three methods: cookie-based (recommended), username/password with optional 2FA secret, and Twitter API v2 credentials.
Does Grok integration require special dependencies?
Yes, Grok functionality requires `agent-twitter-client` v0.0.19 or higher.
What are the rate limits for Grok?
Non-premium accounts: 25 messages per 2 hours; premium accounts have higher limits. The server returns rate limit info in responses when limits are reached.
Can I post tweets with media (images/videos)?
Yes, the server supports posting tweets with images and videos by providing file paths or URLs in the request.
Which port does the server use by default?
Default port is 3000. It can be changed via the `PORT` environment variable or Docker Compose configuration.
Basic information
More AI & Agents MCP servers
mcp-hfspace MCP Server 🤗
evalstateMCP Server to Use HuggingFace spaces, easy configuration and Claude Desktop mode.
MCP-LLM Bridge
patruffBridge between Ollama and MCP servers, enabling local LLMs to use Model Context Protocol tools
🔎 GPT Researcher
assafelovicAn autonomous agent that conducts deep research on any data using any LLM providers
Model Context Protocol for Unreal Engine
chongdashuEnable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).
Lumify Sports Intelligence
LumifyAgent-ready sports intelligence API: live scores, odds, line movement, public betting splits, and explainable bet confidence — via 16 MCP tools at https://lumify.ai/mcp. Get a free key instantly — no signup, email, or ca
Comments