his (for example, if you already have an application running on port 3000), you have several options: #### Option 1: Using Environment Variables Set the `PORT` environment variable: ```bash PORT=3001 npx agent-twitter-client-mcp ``` #### Option 2: Using Docker Compose If using Docker Compose, you can configure both the host and container ports in your `.env` file: ``` # .env file MCP_HOST_PORT=3001 # The port on your host machine MCP_CONTAINER_PORT=3000 # The port inside the container ``` Then run: ```bash docker-compose up -d ``` This will map port 3001 on your host to port 3000 in the container, allowing you to access the MCP at http://localhost:3001 while your other application continues to use port 3000. ### Setup with Claude Desktop 1. Configure Claude Desktop to use this MCP by adding to your config file: **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` ```json { "mcpServers": { "agent-twitter-client-mcp": { "command": "npx", "args": ["-y", "agent-twitter-client-mcp"], "env": { "AUTH_METHOD": "cookies", "TWITTER_COOKIES": "[\"auth_token=YOUR_AUTH_TOKEN; Domain=.twitter.com\", \"ct0=YOUR_CT0_VALUE; Domain=.twitter.com\", \"twid=u%3DYOUR_USER_ID; Domain=.twitter.com\"]" } } } } ``` 2. Restart Claude Desktop ### Authentication Methods #### Cookie Authentication (Recommended) ```json { "AUTH_METHOD": "cookies", "TWITTER_COOKIES": "[\"auth_token=YOUR_AUTH_TOKEN; Domain=.twitter.com\", \"ct0=YOUR_CT0_VALUE; Domain=.twitter.com\", \"twid=u%3DYOUR_USER_ID; Domain=.twitter.com\"]" } ``` To obtain cookies: 1. Log in to Twitter in your browser 2. Open Developer Tools (F12) 3. Go to the Application tab > Cookies 4. Copy the values of `auth_token`, `ct0`, and `twid` cookies 5. Make sure to include the `Domain=.twitter.com` part for each cookie #### Username/Password Authentication ```json { "AUTH_METHOD": "credentials", "TWITTER_USERNAME": "your_username", "TWITTER_PASSWORD": "your_password", "TWITTER_EMAIL": "your_email@example.com", // Optional "TWITTER_2FA_SECRET": "your_2fa_secret" // Optional, required if 2FA is enabled } ``` #### Twitter API Authentication ```json { "AUTH_METHOD": "api", "TWITTER_API_KEY": "your_api_key", "TWITTER_API_SECRET_KEY": "your_api_secret_key", "TWITTER_ACCESS_TOKEN": "your_access_token", "TWITTER_ACCESS_TOKEN_SECRET": "your_access_token_secret" } ``` ## Available Tools - `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 ## Testing Interface The MCP includes an interactive command-line interface for testing: ```bash npx agent-twitter-client-mcp-test # or if installed locally npm run test:interface ``` This launches a REPL where you can test various MCP functions: ``` agent-twitter-client-mcp> help Available commands: health Run a health check profile Get a user profile tweets [count] Get tweets from a user tweet Get a specific tweet by ID search [count] Search for tweets post Post a new tweet like Like a tweet retweet Retweet a tweet quote Quote a tweet follow Follow a user followers [count] Get a user's followers following [count] Get users a user is following grok Chat with Grok help Show available commands

#grok-api

agent-twitter-client-mcp