Search viral content, analyze X accounts, track trending topics and discover niche leaders — directly from Claude, Cursor, Windsurf or any MCP-compatible AI agent. Powered by twitterapi.io. No posting. No DMs. Pure read-only research.

Claude Desktop · Claude Code · Cursor · Windsurf · Cline · Codex CLI · Gemini CLI · any MCP-compatible AI agent

Recommended for non-technical users. No API key, no Node.js, nothing to install. Just connect and start researching.

→ Use mcp-x-intelligence on MCPize

Connect directly to our hosted endpoint using your own API key. No server setup needed — we host the MCP server for you.

Step 1 — Get a free twitterapi.io API key

Sign up at twitterapi.io and copy your key from the dashboard.

Step 2 — Add the MCP server to your AI client config

Pick your client below and replace YOUR_TWITTERAPI_KEY with your actual key.

Config file: %LOCALAPPDATA%\Packages\Claude_...\LocalCache\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "x-intelligence": {
      "command": "cmd",
      "args": [
        "/c", "npx", "-y", "mcp-remote",
        "https://mcp-x-intelligence.fluyeporlaweb.workers.dev/mcp",
        "--header", "x-twitterapi-key: YOUR_TWITTERAPI_KEY"
      ]
    }
  }
}

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "x-intelligence": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp-x-intelligence.fluyeporlaweb.workers.dev/mcp",
        "--header", "x-twitterapi-key: YOUR_TWITTERAPI_KEY"
      ]
    }
  }
}

Same config as Mac above. Add it to your MCP settings JSON file.

Step 3 — Restart your AI client and verify

Ask your AI assistant:

"What tools do you have available?"

You should see the x-intelligence tools listed.

search_viral_content

query         string   required  Search keyword or phrase
min_likes     number   optional  Minimum likes (default: 50)
min_retweets  number   optional  Minimum retweets (default: 0)
hours_back    number   optional  Hours back to search (default: 48)
limit         number   optional  Max results (default: 20)

analyze_account

username      string   required  X username without @
tweets_limit  number   optional  Tweets to analyze (default: 20)

get_trending_topics

woeid         number   optional  Where On Earth ID (default: 1 = Worldwide)
                                 23424977=USA · 23424950=Spain · 23424900=Mexico
                                 23424747=Argentina · 23424791=Colombia

get_niche_leaders

keyword       string   required  Niche or topic keyword
limit         number   optional  Max accounts (default: 10)

• Content creators — Find what's going viral in your niche before writing your next thread or post
• Marketers — Competitive account analysis and real-time trend monitoring at zero cost
• Developers — Build research pipelines and content strategy tools backed by live X data
• Researchers — Social media data collection without the official X API price tag

• "Search for viral posts about Claude MCP from the last 48 hours with over 100 likes"
• "Analyze the account @OpenAI — what are their top 5 posts and when do they usually post?"
• "What's trending in Mexico and Argentina right now?"
• "Find the top 10 accounts in the AI tools niche on X"

The official X API uses pay-per-use credit pricing — no monthly minimums. However it still requires: a developer account approval process, OAuth 2.0 authentication setup, and custom integration work to connect with AI agents like Claude.

mcp-x-intelligence removes all that friction. One API key from twitterapi.io, one config block, done.

Make sure you are using v1.2.0 or later. Earlier versions had a schema compatibility issue affecting Hermes, Cursor and Windsurf users.

The hosted endpoint at MCPize is always up to date.

1. Check your config file has the correct JSON syntax
2. Restart your AI client completely (not just the window)
3. Verify your twitterapi.io key is valid at twitterapi.io/dashboard

Some queries may return no results if:

• The keyword is too specific
• The time window (hours_back) is too short
• The engagement filter (min_likes) is too high

Try broadening your search parameters.

twitterapi.io enforces rate limits on free accounts. If you get errors after many requests, wait a few minutes and try again.

@fluyeporlaweb — AI tools, automation and developer resources in Spanish.

Join the community: t.me/fluyeporlaweb

Listed on Smithery

MIT — do whatever you want with it.