Twitter MCP Server

An MCP (Model Context Protocol) server that provides tools for interacting with Twitter using the agent-twitter-client library.

Features

getTweet: Retrieve a tweet by its ID
sendTweet: Post a new tweet to Twitter

Prerequisites

Node.js (v14 or higher)
npm or yarn
Twitter account credentials

Installation

Clone this repository
Install dependencies:

npm install
# or
yarn install

Create a .env file in the root directory with your Twitter credentials:

TWITTER_USERNAME=your_twitter_username
TWITTER_PASSWORD=your_twitter_password
TWITTER_EMAIL=your_email@example.com (optional)
TWITTER_2FA_SECRET=your_2fa_secret (optional)

# Optional API credentials (used as fallback)
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

Usage

Running the Server

You can run the server using the FastMCP CLI tools:

# For development and testing in the terminal
npx fastmcp dev

# For visual inspection with the MCP Inspector
npx fastmcp inspect

Using the Tools

getTweet

Retrieves a tweet by its ID.

Parameters:

tweetId (string): The ID of the tweet to retrieve

Example:

getTweet({"tweetId": "1734609533274853865"})

sendTweet

Posts a new tweet to Twitter.

Parameters:

text (string): The text content of the tweet to send

Example:

sendTweet({"text": "Hello World from MCP!"})

Development

This server is built using:

FastMCP - A TypeScript framework for building MCP servers
agent-twitter-client - A Twitter client library

To build the TypeScript code:

npx tsc

License

MIT