MCP.so
Sign In

Agent Twitter Client MCP Server

@ryanmac

Basic information

Category

AI & Agents

License

MIT

Transports

stdio

Author

ryanmac

About Agent Twitter Client MCP Server

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

Agent Twitter Client MCP Server 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"
      ]
    }
  }
}

Agent Twitter Client MCP Server tools

14

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

Frequently asked questions

1

What authentication methods are supported?

Three methods: cookie-based (recommended), username/password with optional 2FA secret, and Twitter API v2 credentials.

2

Does Grok integration require special dependencies?

Yes, Grok functionality requires `agent-twitter-client` v0.0.19 or higher.

3

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.

4

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.

5

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.

Comments

More AI & Agents MCP servers