X Intelligence MCP Server

Twitter/X content discovery via public search engines. Free demo tool for exploring social media mentions.

Important Limitations

This is a free demo tool with significant limitations.

Feature	Status
Real-time data	No - uses search engine index (hours/days old)
Engagement metrics	No - likes, retweets, replies not available
Full tweet text	Partial - search engine snippets only
Rate limits	Subject to DuckDuckGo rate limits
Reliability	Best-effort, may return no results

For production use cases requiring real-time Twitter data with engagement metrics, you need:

• Twitter API Pro ($5,000/month) - developer.twitter.com
• Or a licensed data provider (Brandwatch, Sprinklr, etc.)

How It Works

1. Data Source: Searches DuckDuckGo for site:twitter.com content
2. AI Analysis: Optional OpenAI sentiment analysis on results
3. MCP Protocol: Exposes tools via Apify's MCP infrastructure

This approach queries publicly indexed Twitter content through search engines - not Twitter's API directly.

Tools

x_search

Search for Twitter content matching a query.

{
  "name": "x_search",
  "arguments": {
    "query": "your search term",
    "max_tweets": 10,
    "analyze": false
  }
}

x_monitor

Search for brand mentions with optional AI sentiment analysis.

{
  "name": "x_monitor",
  "arguments": {
    "brand": "Brand Name",
    "max_tweets": 20
  }
}

x_intent

Search for buying intent signals (recommendations, frustrations, comparisons).

{
  "name": "x_intent",
  "arguments": {
    "product_category": "CRM software",
    "max_tweets": 15
  }
}

x_compete

Compare mentions across 2-5 brands.

{
  "name": "x_compete",
  "arguments": {
    "brands": ["Brand A", "Brand B"],
    "tweets_per_brand": 10
  }
}

x_profile

Search for content from a specific Twitter user.

{
  "name": "x_profile",
  "arguments": {
    "username": "username",
    "max_tweets": 10
  }
}

get_stats

Get server usage statistics.

Setup

1. Optional: OpenAI Key for AI Analysis

Without an OpenAI key, you get raw search results only. With a key, you get sentiment analysis and insights.

Get your key at platform.openai.com/api-keys

2. Connect to MCP Client

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "x-intelligence": {
      "url": "https://mcp.apify.com?actors=YOUR_USERNAME/x-intelligence-mcp"
    }
  }
}

3. Use It

Ask Claude: "Search Twitter for mentions of Acme Corp"

Example Output

{
  "success": true,
  "tool": "x_search",
  "query": "Acme Corp",
  "tweet_count": 5,
  "tweets": [
    {
      "text": "Just tried Acme Corp's new product...",
      "author": "someuser",
      "likes": 0,
      "retweets": 0,
      "url": "https://twitter.com/someuser/status/123"
    }
  ]
}

Note: Engagement metrics (likes, retweets) are not available through this method.

Pricing

Free - This actor uses public search engines, not paid APIs.

Optional: OpenAI API costs for sentiment analysis (~$0.01-0.05 per analysis).

When to Use This vs. Alternatives

Use Case	This Tool	Twitter API Pro
Quick brand mention check	Yes	Overkill
Demo/prototype	Yes	Overkill
Real-time monitoring	No	Yes
Engagement analytics	No	Yes
Historical analysis	No	Yes
Production SLA	No	Yes

Technical Details

Data sources tried (in order):

1. Nitter instances (open-source Twitter frontend) - mostly offline
2. Twitter syndication API - limited availability
3. DuckDuckGo site:twitter.com search - primary working method

Why not use Twitter's API directly?

• Free tier: 1,500 tweets/month (insufficient)
• Basic ($100/mo): No commercial redistribution
• Pro ($5,000/mo): Required for production use

Support

This is a free demo tool provided as-is. For production needs, consider official Twitter API access.