# agent-twitter-client-mcp

> MCP Server

This repository provides a Model Context Protocol (MCP) server that enables AI models to interact with Twitter through the agent-twitter-client, offering features like tweet operations, user management, and Grok integration.

## Overview

- **Category:** Communication
- **Language:** TypeScript
- **Stars:** 32
- **Forks:** 1
- **Owner:** ryanmac
- **GitHub:** https://github.com/ryanmac/agent-twitter-client-mcp
- **Homepage:** https://github.com/ryanmac/agent-twitter-client-mcp
- **Created:** 2025-03-07T20:54:02+00:00
- **Updated:** 2025-03-25T11:37:20+00:00
- **Source:** https://model-context-protocol.com/servers/ai-model-twitter-interaction-mcp-server

## Setup

## Setup

1. Clone the repository:

```bash
git clone https://github.com/ryanmac/agent-twitter-client-mcp.git
cd agent-twitter-client-mcp
```

2. Install dependencies:

```bash
npm install
```

3. Create a `.env` file with configuration:

```
AUTH_METHOD=cookies
TWITTER_COOKIES=["cookie1=value1", "cookie2=value2"]
```

4. Build the project:

```bash
npm run build
```

5. Start the server:

```bash
npm start
```

## Tools

## Available Tools

- Authentication Options: Cookie-based, username/password, and Twitter API v2 credentials.
- Tweet Operations: Fetch, get by ID, search, send tweets, create polls, like, retweet, and quote tweets.
- User Operations: Get profiles, follow users, get followers and following lists.
- Grok Integration: Chat with Grok, continue conversations, get web search results and citations, access Twitter's real-time data.
- `get_user_tweets`: Fetch tweets from a specific user.
- `get_tweet_by_id`: Fetch a specific tweet by ID.
- `search_tweets`: Search for tweets.
- `send_tweet`: Post a new tweet.
- `send_tweet_with_poll`: Post a tweet with a poll.
- `like_tweet`: Like a tweet.
- `retweet`: Retweet a tweet.
- `quote_tweet`: Quote a tweet.
- `get_user_profile`: Get a user's profile.
- `follow_user`: Follow a user.
- `get_followers`: Get a user's followers.
- `get_following`: Get users a user is following.
- `grok_chat`: Chat with Grok via Twitter.
- `health_check`: Check the health of the Twitter MCP server.