[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81505":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":36,"readmeContent":37,"aiSummary":38,"trendingCount":16,"starSnapshotCount":16,"syncStatus":39,"lastSyncTime":40,"discoverSource":41},81505,"mcp-x-intelligence","fluyeporlaweb\u002Fmcp-x-intelligence","fluyeporlaweb","X\u002FTwitter research MCP for Claude, Cursor, Windsurf and any MCP-compatible AI agent","",null,"TypeScript",48,9,28,1,0,5,20,44.5,false,"main",true,[24,25,26,27,28,29,30,31,32,33,34,35],"ai-agent","claude","content-strategy","cursor","mcp","model-context-protocol","research","twitter","twitterapi","twitterapi-io","windsurf","x-api","2026-06-12 04:01:34","# mcp-x-intelligence — X\u002FTwitter Research MCP for Claude, Cursor & AI Agents\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Flogo.png\" alt=\"mcp-x-intelligence logo\" width=\"120\">\n\u003C\u002Fp>\n\nSearch 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](https:\u002F\u002Ftwitterapi.io?ref=fluyeporla666). No posting. No DMs. Pure read-only research.\n\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Cloudflare Workers](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FHosted%20on-Cloudflare%20Workers-orange)](https:\u002F\u002Fworkers.cloudflare.com)\n[![MCP Compatible](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMCP-Compatible-purple)](https:\u002F\u002Fmodelcontextprotocol.io)\n[![smithery badge](https:\u002F\u002Fsmithery.ai\u002Fbadge\u002Ffluyeporlaweb\u002Fmcp-x-intelligence)](https:\u002F\u002Fsmithery.ai\u002Fservers\u002Ffluyeporlaweb\u002Fmcp-x-intelligence)\n[![Glama](https:\u002F\u002Fglama.ai\u002Fmcp\u002Fservers\u002Ffluyeporlaweb\u002Fmcp-x-intelligence\u002Fbadges\u002Fscore.svg)](https:\u002F\u002Fglama.ai\u002Fmcp\u002Fservers\u002Ffluyeporlaweb\u002Fmcp-x-intelligence)\n\n---\n\n## What it does — 4 X Research Tools for AI Agents\n\n| Tool | What it does | Example prompt |\n|------|-------------|----------------|\n| `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\"* |\n| `analyze_account` | Full profile analysis: followers, top posts, engagement rate, active hours | *\"Analyze @fluyeporlaweb and tell me their best content strategy\"* |\n| `get_trending_topics` | Trending topics by country in real time | *\"What's trending in Spain and Mexico right now?\"* |\n| `get_niche_leaders` | Top accounts in any niche sorted by follower count | *\"Who are the top 10 AI tool creators on X?\"* |\n\n---\n\n## Compatible with Every Major MCP Client\n\nClaude Desktop · Claude Code · Cursor · Windsurf · Cline · Codex CLI · Gemini CLI · any MCP-compatible AI agent\n\n---\n\n## Quick Start\n\n### Option 1 — Hosted Version via MCPize (No Setup Required)\n\n**Recommended for non-technical users.** No API key, no Node.js, nothing to install. Just connect and start researching.\n\n→ **[Use mcp-x-intelligence on MCPize](https:\u002F\u002Fmcpize.com\u002Fmcp\u002Fmcp-x-intelligence)**\n\n| Plan | Calls\u002Fmonth | Price |\n|------|-------------|-------|\n| Free | 50 | Free |\n| Pro | 1,000 | $9\u002Fmo |\n\n---\n\n### Option 2 — BYOK: Bring Your Own twitterapi.io Key (Free)\n\nConnect directly to our hosted endpoint using your own API key. No server setup needed — we host the MCP server for you.\n\n**Step 1 — Get a free twitterapi.io API key**\n\nSign up at [twitterapi.io](https:\u002F\u002Ftwitterapi.io?ref=fluyeporla666) and copy your key from the dashboard.\n\n**Step 2 — Add the MCP server to your AI client config**\n\nPick your client below and replace `YOUR_TWITTERAPI_KEY` with your actual key.\n\n#### Claude Desktop on Windows\n\nConfig file: `%LOCALAPPDATA%\\Packages\\Claude_...\\LocalCache\\Roaming\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"x-intelligence\": {\n      \"command\": \"cmd\",\n      \"args\": [\n        \"\u002Fc\", \"npx\", \"-y\", \"mcp-remote\",\n        \"https:\u002F\u002Fmcp-x-intelligence.fluyeporlaweb.workers.dev\u002Fmcp\",\n        \"--header\", \"x-twitterapi-key: YOUR_TWITTERAPI_KEY\"\n      ]\n    }\n  }\n}\n```\n\n#### Claude Desktop on Mac\n\nConfig file: `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"x-intelligence\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\", \"mcp-remote\",\n        \"https:\u002F\u002Fmcp-x-intelligence.fluyeporlaweb.workers.dev\u002Fmcp\",\n        \"--header\", \"x-twitterapi-key: YOUR_TWITTERAPI_KEY\"\n      ]\n    }\n  }\n}\n```\n\n#### Cursor \u002F Windsurf \u002F Cline\n\nSame config as Mac above. Add it to your MCP settings JSON file.\n\n**Step 3 — Restart your AI client and verify**\n\nAsk your AI assistant:\n> *\"What tools do you have available?\"*\n\nYou should see the `x-intelligence` tools listed.\n\n---\n\n## Tool Parameters Reference\n\n**`search_viral_content`**\n```\nquery         string   required  Search keyword or phrase\nmin_likes     number   optional  Minimum likes (default: 50)\nmin_retweets  number   optional  Minimum retweets (default: 0)\nhours_back    number   optional  Hours back to search (default: 48)\nlimit         number   optional  Max results (default: 20)\n```\n\n**`analyze_account`**\n```\nusername      string   required  X username without @\ntweets_limit  number   optional  Tweets to analyze (default: 20)\n```\n\n**`get_trending_topics`**\n```\nwoeid         number   optional  Where On Earth ID (default: 1 = Worldwide)\n                                 23424977=USA · 23424950=Spain · 23424900=Mexico\n                                 23424747=Argentina · 23424791=Colombia\n```\n\n**`get_niche_leaders`**\n```\nkeyword       string   required  Niche or topic keyword\nlimit         number   optional  Max accounts (default: 10)\n```\n\n---\n\n## Use Cases for X Research with AI\n\n- **Content creators** — Find what's going viral in your niche before writing your next thread or post\n- **Marketers** — Competitive account analysis and real-time trend monitoring at zero cost\n- **Developers** — Build research pipelines and content strategy tools backed by live X data\n- **Researchers** — Social media data collection without the official X API price tag\n\n---\n\n## Example Prompts to Try\n\n- *\"Search for viral posts about Claude MCP from the last 48 hours with over 100 likes\"*\n- *\"Analyze the account @OpenAI — what are their top 5 posts and when do they usually post?\"*\n- *\"What's trending in Mexico and Argentina right now?\"*\n- *\"Find the top 10 accounts in the AI tools niche on X\"*\n\n---\n\n## Why Not the Official X API?\n\nThe official X API uses pay-per-use credit pricing —\nno monthly minimums. However it still requires:\na developer account approval process, OAuth 2.0 authentication setup,\nand custom integration work to connect with AI agents like Claude.\n\nmcp-x-intelligence removes all that friction.\nOne API key from twitterapi.io, one config block, done.\n\n| | Official X API | mcp-x-intelligence |\n|---|---|---|\n| Pricing model | Pay-per-use credits (no minimum) | Free (BYOK) or $9\u002Fmo hosted |\n| Setup time | Developer account approval required | Minutes |\n| MCP native | No — requires custom integration | Yes — plug and play |\n| Works with Claude | Manual integration | Native |\n| Auth complexity | OAuth 2.0 setup required | Single API key |\n\n---\n\n## Troubleshooting\n\n### \"Tool execution failed\" or RuntimeError\nMake sure you are using **v1.2.0 or later**.\nEarlier versions had a schema compatibility issue\naffecting Hermes, Cursor and Windsurf users.\n\nThe hosted endpoint at MCPize is always up to date.\n\n### Tools not appearing in my AI client\n1. Check your config file has the correct JSON syntax\n2. Restart your AI client completely (not just the window)\n3. Verify your twitterapi.io key is valid at twitterapi.io\u002Fdashboard\n\n### Empty results\nSome queries may return no results if:\n- The keyword is too specific\n- The time window (hours_back) is too short\n- The engagement filter (min_likes) is too high\n\nTry broadening your search parameters.\n\n### Rate limits\ntwitterapi.io enforces rate limits on free accounts.\nIf you get errors after many requests, wait a few minutes\nand try again.\n\n---\n\n## Built by\n\n[@fluyeporlaweb](https:\u002F\u002Fx.com\u002Ffluyeporlaweb) — AI tools, automation and developer resources in Spanish.\n\nJoin the community: [t.me\u002Ffluyeporlaweb](https:\u002F\u002Ft.me\u002Ffluyeporlaweb)\n\nListed on [Smithery](https:\u002F\u002Fsmithery.ai\u002Fserver\u002Ffluyeporlaweb\u002Fmcp-x-intelligence)\n\n---\n\n## License\n\nMIT — do whatever you want with it.\n","mcp-x-intelligence 是一个专为 Claude、Cursor、Windsurf 以及其他支持 MCP 协议的 AI 代理设计的研究工具，旨在通过 X\u002FTwitter 平台进行内容分析和趋势追踪。项目采用 TypeScript 编写，并部署在 Cloudflare Workers 上，确保了高性能与稳定性。它提供了四大核心功能：搜索热门内容、分析账户表现、获取实时趋势话题以及发现特定领域的领军人物，所有操作均基于纯读取模式，不涉及发布或私信行为。适用于需要深入了解社交媒体动态、优化内容策略或研究市场趋势的专业人士及团队使用。",2,"2026-06-11 04:05:19","CREATED_QUERY"]