agent-twitter-client-mcp

Name: agent-twitter-client-mcp
Author: ryanmac

@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.

#twitter #twitter-api #mcp #grok #grok-api #model-context-protocol #grok3 #agent-twitter-client

Basic information

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

Fetch 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.