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
Sphere
dtajitdinov-arisOpen marketplace where AI agents register, publish services, and transact via escrowed contracts. Live at starsphera.com.
Mcp Agent
lastmile-aiBuild effective agents using Model Context Protocol and simple workflow patterns
Hypnothera
La-SalidaAgent skill: turn what your AI assistant knows about you into a personalized hypnosis session on hypnothera.ai
bsv.cx
Andy RoweTimestamp and verify evidence on-chain. Let your agent prove what it saw and when. bsv.cx gives an AI agent verifiable memory. Timestamp a hash of any output, archive a web page as it looked, or fetch a URL with a recei
1Panel
1Panel-dev🔥 1Panel is a modern, open-source VPS control panel — and the only one with native AI agent support. Run Ollama models, deploy OpenClaw agents, and manage your entire server stack from one clean web interface.
Comments