Twitter Agent

In this tutorial, you will learn how to create a Node.js application that integrates X/twitter with Alith’s Model Context Protocol (MCP) feature. This allows you to use LLM models and agents to fetch tweets from a specific user, post a new tweet, like a tweet, quote a tweet, etc.

Note: Although we used Node.js in this tutorial, you can still use Alith Rust SDK and Python SDK to complete this twitter agent.

Prerequisites

Before starting, ensure you have the following:

OpenAI API Key: Sign up at OpenAI and get your API key or you can use your favorite LLM models.
Node.js 18+ environment and pnpm.
A X/Twitter account.

Install Required Libraries

Init the project and install the necessary Node.js libraries using pnpm:


mkdir alith-twitter-example && cd alith-twitter-example && pnpm init
pnpm i alith
pnpm i --save-dev @types/json-schema

Set Up Environment Variables

LLM API Key

Store your API keys and tokens as environment variables for security:


export OPENAI_API_KEY="your-openai-api-key"


export AUTH_METHOD=cookies
export TWITTER_COOKIES=["auth_token=your_auth_token; Domain=.twitter.com", "ct0=your_ct0_value; Domain=.twitter.com"]

To obtain cookies:

Log in to Twitter in your browser
Open Developer Tools (F12)
Go to the Application tab > Cookies
Copy the values of auth_token and ct0 cookies

Username/Password Authentication


export AUTH_METHOD=credentials
export TWITTER_USERNAME=your_username
export TWITTER_PASSWORD=your_password
export TWITTER_EMAIL=your_email@example.com  # Optional
export TWITTER_2FA_SECRET=your_2fa_secret    # Optional, required if 2FA is enabled

API Authentication


export AUTH_METHOD=api
export TWITTER_API_KEY=your_api_key
export TWITTER_API_SECRET_KEY=your_api_secret_key
export TWITTER_ACCESS_TOKEN=your_access_token
export TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret

Write the Typescript Code

Create a Typescript script (e.g., index.ts) and add the following code:

Note: We need to install tsc firstly


import { Agent } from 'alith'
 
const agent = new Agent({
  name: 'A twitter agent',
  model: 'gpt-4',
  preamble:
    'You are a automatic twitter agent.',
  mcpConfigPath: 'mcp_twitter.json',
})
console.log(await agent.prompt('Search Twitter for tweets about AI'))
console.log(await agent.prompt('Post a tweet saying "Hello from Alith Twitter Agent!"'))
console.log(await agent.prompt('Get the latest tweets from @OpenAI'))
console.log(await agent.prompt('Chat with Grok about quantum computing'))

Write the MCP Config

Create a JSON file named mcp_twitter.json and add the following code:


{
  "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\"]"
      }
    }
  }
}

Run the Application

Run your Typescript script to start and test the application:


npx tsc && node index.js