Twitter MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Uses .ENV files to manage Twitter credentials and API keys securely

  • Enables server functionality on the Node.js runtime environment

  • Integrates with npm packages, specifically the agent-twitter-client library for Twitter interactions

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

  1. Clone this repository
  2. Install dependencies:
npm install # or yarn install
  1. 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:

To build the TypeScript code:

npx tsc

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

Provides tools for interacting with Twitter to retrieve tweets by ID and post new tweets using the agent-twitter-client library.

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Running the Server
          2. Using the Tools
        2. Development
          1. License