mcp-registry/mcp-twikit

    ==================
      
       /// MCP ///
      /// MCP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mcp-twikit

by adhikasp

A Model Context Protocol (MCP) server for interacting with Twitter.

191
25
Specialized
GitHub

01

search_twitter

Search Twitter for tweets that match a specified query, returning a chosen number of results with optional sorting.

02

get_timeline

Retrieve the latest tweets from the authenticated user's home timeline.

Installation

## Prerequisites
• Python ≥ 3.9
• A Twitter/X developer account with elevated READ / WRITE permissions.
## Clone or install the package
# Option A – install from PyPI (if published) pip install mcp-twikit # Option B – install directly from GitHub pip install git+https://github.com/adhikasp/mcp-twikit.git
## Create a virtual-env (recommended)
python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate
## Configure credentials – supply them as environment variables or an .env file
export TWITTER_API_KEY="<consumer key>" export TWITTER_API_SECRET="<consumer secret>" export TWITTER_ACCESS_TOKEN="<access token>" export TWITTER_ACCESS_SECRET="<access secret>"
## Start the MCP server
python -m mcp_twikit.server --host 0.0.0.0 --port 8080
## Verify
curl http://localhost:8080/healthz # → 200 OK

Documentation

License: MIT License
Updated 7/30/2025

Table of Contents