mcp-x-intelligence — X/Twitter Research MCP for Claude, Cursor & AI Agents

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.

What it does — 4 X Research Tools for AI Agents

| Tool | What it does | Example prompt | |------|-------------|----------------| | search_viral_content | Find top posts by keyword with engagement filters (likes, retweets, time window) | "Find the most viral posts about AI agents in the last 48h" | | analyze_account | Full profile analysis: followers, top posts, engagement rate, active hours | "Analyze @fluyeporlaweb and tell me their best content strategy" | | get_trending_topics | Trending topics by country in real time | "What's trending in Spain and Mexico right now?" | | get_niche_leaders | Top accounts in any niche sorted by follower count | "Who are the top 10 AI tool creators on X?" |

Compatible with Every Major MCP Client

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

Quick Start

Option 1 — Hosted Version via MCPize (No Setup Required)

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

| Plan | Calls/month | Price | |------|-------------|-------| | Free | 50 | Free | | Pro | 1,000 | $9/mo |

Option 2 — BYOK: Bring Your Own twitterapi.io Key (Free)

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.

Claude Desktop on Windows

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

Claude Desktop on Mac

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

Cursor / Windsurf / Cline

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.

Tool Parameters Reference

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)

Use Cases for X Research with AI

• 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

Example Prompts to Try

• "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"

Why Not the Official X API?

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.

| | Official X API | mcp-x-intelligence | |---|---|---| | Pricing model | Pay-per-use credits (no minimum) | Free (BYOK) or $9/mo hosted | | Setup time | Developer account approval required | Minutes | | MCP native | No — requires custom integration | Yes — plug and play | | Works with Claude | Manual integration | Native | | Auth complexity | OAuth 2.0 setup required | Single API key |

Troubleshooting

"Tool execution failed" or RuntimeError

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.

Tools not appearing in my AI client

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

Empty results

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.

Rate limits

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

Built by

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

Join the community: t.me/fluyeporlaweb

Listed on Smithery

License

MIT — do whatever you want with it.