Work in Progress These docs are a work in progress. More content is coming soon.

← Back to Documentation

Twitter / X

Search tweets, explore trending topics, and analyze user profiles and engagement.

Setup

Connect the Twitter / X toolkit by configuring your own API key from a supported data provider. This toolkit uses API key authentication โ€” no OAuth login is required.

Prerequisites

Before configuring the Twitter / X toolkit, ensure you have:

  • Configured an MCP server in your toolforest.io dashboard.
  • An API key from at least one of the supported providers (see below).

Supported Providers

ProviderDescription
X (Official API)Twitter's official API. Requires a developer account at developer.x.com.
SocialDataThird-party Twitter data provider at socialdata.tools.
TwitterAPI.ioThird-party Twitter data provider at twitterapi.io.

You only need an API key from one provider to get started. You can configure multiple providers for additional flexibility and reliability.

Setup Steps

Step 1: Open Configuration

  1. Navigate to your MCP server panel in the toolforest.io dashboard.
  2. Locate the Twitter / X toolkit.
  3. Click the Configure button.

Step 2: Enter Your API Key(s)

A configuration modal will appear with fields for each supported provider. Enter your API key for at least one provider.

Step 3: Confirmation

After submitting, the toolkit status will change to Connected and you can begin searching tweets and exploring Twitter data immediately.

Managing Your Connection

Reconfigure

To update your API keys, click the โ‹ฎ (three-dot button) and select Reconfigure. You can add, change, or remove provider keys at any time.

Disconnect

To disconnect the toolkit:

  1. Click the Disconnect button in your MCP server panel.
  2. toolforest.io will delete all stored API key credentials.
๐Ÿ”’ Security
Your API keys are encrypted at rest. They are only decrypted when your AI assistant makes a request to the Twitter API on your behalf.

Capabilities

CategoryCapabilities
SearchSearch tweets by keyword, hashtag, user, language, mentions, exact phrases, and exclusions with full operator support
TweetsGet tweet by ID with full metadata (author, engagement metrics, media, entities), view quote tweets
Threads & RepliesGet full tweet threads (author's reply chain), view all replies to a tweet from any user
UsersGet user profiles (bio, location, verification status, follower/following counts, tweet count, profile images)
User ActivityView a user's recent tweets, mentions, followers list, and following list
TrendsGet trending topics by location (worldwide, country, or city) with tweet counts