Twitter MCP Server

An MCP (Model Context Protocol) server that provides Twitter automation tools using Browserbase and Stagehand for browser automation.

Features

• twitter_post: Post tweets or replies to Twitter

• twitter_search: Search for tweets on Twitter with structured results

• get_context_id: Get the current Browserbase context ID for persistent sessions

• set_context_id: Set the context ID for persistent browser sessions

Setup

1. Install dependencies:

2. Configure your environment variables (create a .env file):

3. Run the development server:

Tools

twitter_post

Posts a tweet to Twitter or replies to an existing tweet.

Parameters:

• text (required): Tweet text to post

• replyToUrl (optional): URL of tweet to reply to

Example:

twitter_search

Searches for tweets on Twitter and returns structured results.

Parameters:

• query (required): Search query to find tweets

• count (optional): Number of search results to return (default: 10)

Returns:

• Tweet text, author username, timestamp, and engagement metrics

Example:

get_context_id

Retrieves the current Browserbase context ID being used for persistent sessions.

Parameters: None

Returns: Current context ID or information about setting one up

set_context_id

Sets the context ID for maintaining persistent browser sessions across requests.

Parameters:

• contextId (required): The context ID to set

Example:

Configuration

The server supports the following configuration options:

Persistent Sessions

This server supports persistent browser sessions through Browserbase context IDs. This allows you to:

• Maintain login state across multiple requests

• Avoid repeated authentication flows

• Preserve browser cookies and session data

To use persistent sessions:

1. Set up a context ID using set_context_id or configure BROWSERBASE_CONTEXT_ID in your environment

2. The server will use this context for all browser operations

3. Your Twitter login session will persist across tool calls

Authentication

This server uses Browserbase for browser automation, which handles Twitter authentication through the browser session. Make sure your Browserbase session is authenticated with Twitter for the tools to work properly. Use persistent sessions with context IDs to maintain login state.