MCP.so
Sign In

agent-twitter-client-mcp

@theo-nash

Repository

About agent-twitter-client-mcp

Model Context Protocol implementation for twitter interactions

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "twitter-mcp-server-theo-nash": {
      "command": "npx",
      "args": [
        "agent-twitter-client-mcp"
      ]
    }
  }
}

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?

It integrates with Twitter using the agent-twitter-client package, allowing AI models to interact with Twitter without direct API access. It's for developers and AI agents that need to perform Twitter actions programmatically.

How to use agent-twitter-client-mcp?

Install via npm globally or locally, configure Twitter credentials in a .env file, then run the MCP server with agent-twitter-client-mcp or npx agent-twitter-client-mcp. Alternatively, configure it as an MCP server in Claude Desktop by adding the appropriate configuration to the claude_desktop_config.json file.

Key features of agent-twitter-client-mcp

  • Cookie, credentials, or API authentication
  • Fetch tweets, search, and post tweets
  • Like, retweet, and quote tweets
  • Get user profiles and follow users
  • Grok AI chat via Twitter interface
  • Interactive CLI test interface

Use cases of agent-twitter-client-mcp

  • Search Twitter for trending topics or specific queries
  • Post tweets with text, images, or videos via AI assistants
  • Analyze user profiles and follower lists
  • Integrate Grok's real-time Twitter data into conversations
  • Automate social media management tasks

FAQ from agent-twitter-client-mcp

How does agent-twitter-client-mcp authenticate with Twitter?

It supports three methods: cookie authentication (recommended), username/password with optional 2FA, and Twitter API v2 credentials.

What are the runtime requirements for agent-twitter-client-mcp?

It requires Node.js and npm. For Grok integration, agent-twitter-client v0.0.19 or higher is required.

Where does my Twitter data live?

Data is accessed through the MCP server using your Twitter credentials; the server itself does not store data persistently beyond the session.

Are there any rate limits?

Yes, Twitter imposes rate limits. Grok has specific limits: 25 messages per 2 hours for non-premium accounts; premium accounts have higher limits.

Can I use agent-twitter-client-mcp with Claude Desktop?

Yes, you can configure it as an MCP server in Claude Desktop's configuration file with the appropriate environment variables for authentication.

Frequently asked questions

How does agent-twitter-client-mcp authenticate with Twitter?

It supports three methods: cookie authentication (recommended), username/password with optional 2FA, and Twitter API v2 credentials.

What are the runtime requirements for agent-twitter-client-mcp?

It requires Node.js and npm. For Grok integration, agent-twitter-client v0.0.19 or higher is required.

Where does my Twitter data live?

Data is accessed through the MCP server using your Twitter credentials; the server itself does not store data persistently beyond the session.

Are there any rate limits?

Yes, Twitter imposes rate limits. Grok has specific limits: 25 messages per 2 hours for non-premium accounts; premium accounts have higher limits.

Can I use agent-twitter-client-mcp with Claude Desktop?

Yes, you can configure it as an MCP server in Claude Desktop's configuration file with the appropriate environment variables for authentication.

Comments

Basic information

Category

AI & Agents

License

MIT

Transports

stdio

Author

theo-nash

More AI & Agents MCP servers

Plainpaper

Plainpaper

The AI marketing canvas for Claude and MCP agents. Your agent drafts campaigns as cards on a shared board, briefed by your brand rules, approved by you.

Transform MCP

Unstructured

The Unstructured Transform MCP Server connects your ADK agent to Unstructured, a document processing platform that turns raw files into structured, AI-ready data. This integration gives your agent the ability to parse PD

L

Legion MCP

faulkj

MCP-native LLM councils for debates, juries, blind panels, voting, refinement, and custom multi-model deliberation.

1

Nero AI Image Processing

nero-com

We provide AI-powered tools for image enhancement, upscaling, background removal, photo restoration, colorization, denoising, and compression. All features are available through our API documentation.

🔎 GPT Researcher

assafelovic

An autonomous agent that conducts deep research on any data using any LLM providers

28.1K