rolli-mcp
Social media search and analytics MCP server for X, Reddit, YouTube, Facebook, Instagram, Threads, Bluesky with keyword
MCP server for Rolli IQ that provides social media search and analytics across X, Reddit, YouTube, Facebook, Instagram, Threads, Bluesky, and more platforms.
About rolli-mcp
rolli-mcp is a community-built MCP server published by rolliinc that provides AI assistants with tools and capabilities via the Model Context Protocol. Social media search and analytics MCP server for X, Reddit, YouTube, Facebook, Instagram, Threads, Bluesky with keyword It is categorized under other. This server exposes 12 tools that AI clients can invoke during conversations and coding sessions.
How to install
You can install rolli-mcp in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
License
rolli-mcp is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Tools (12)
List all keyword searches, filtered by status
Create a keyword/hashtag search and return results when complete
Get keyword search results (status, analytics, posts)
List all user searches, filtered by status
Create a user profile search and return results when complete
rolli-mcp
MCP server for Rolli IQ — social media search and analytics across X, Reddit, YouTube, Facebook, Instagram, Threads, Bluesky, and more.
Tools
| Tool | Description |
|---|---|
list_keyword_searches | List all keyword searches, filtered by status |
keyword_search | Create a keyword/hashtag search and return results when complete |
get_keyword_search | Get keyword search results (status, analytics, posts) |
list_user_searches | List all user searches, filtered by status |
user_search | Create a user profile search and return results when complete |
get_user_search | Get user search results (profile, metrics, content analysis) |
get_topic_tree | Get conversation topic tree for a keyword search |
get_keyword_search_posts | Get raw posts from a keyword search |
get_user_search_posts | Get raw posts from a user search |
get_integration_setup | Get current integration settings (webhook URL, name) |
update_integration_setup | Set the webhook URL for search completion notifications |
get_usage | Get API usage data and per-user breakdowns |
Setup
You need a Rolli account with API access. Get your API token from rolli.ai.
Claude Desktop / Claude Code / VS Code / Cursor / Windsurf
Add to your MCP config (claude_desktop_config.json, .vscode/mcp.json, or equivalent):
{
"mcpServers": {
"rolli": {
"command": "npx",
"args": ["-y", "@rolli/mcp"],
"env": {
"ROLLI_API_TOKEN": "your_token"
}
}
}
}
ROLLI_USER_ID is optional and defaults to "rolli-mcp". Set it to override with your own user ID.
Optional Environment Variables
| Variable | Default | Description |
|---|---|---|
ROLLI_USER_ID | "rolli-mcp" | User ID sent with API requests |
ROLLI_POLL_INTERVAL_MS | 5000 | Polling interval (ms) when waiting for search results |
ROLLI_MAX_POLL_MS | 600000 | Max time (ms) to wait before search timeout (default: 10 min) |
Smithery
This server includes a smithery.yaml for deployment via Smithery. It will prompt for your API token during setup.
Usage Examples
Search for a keyword across social media:
"Search for posts about 'artificial intelligence' on Twitter and Reddit from the last week"
Analyze a user profile:
"Look up @elonmusk on Twitter and analyze their recent posts"
Get topic breakdown:
"Show me the topic tree for my keyword search #123"
Check API usage:
"How many searches have I used this month?"
Set up a webhook:
"Set my webhook URL to https://myapp.com/rolli-callback"
Development
npm ci
npm run lint # ESLint
npm run build # TypeScript
npm test # Vitest
CI runs on every push and PR to master. Releases published on GitHub automatically publish to npm (requires NPM_TOKEN repo secret).
License
MIT
Alternatives
Related Skills
Browse all skillsCreate professional draw.io (diagrams.net) diagrams in XML format (.drawio files) with integrated PMP/PMBOK methodologies, extensive visual asset libraries, and industry-standard professional templates. Use this skill when users ask to create flowcharts, swimlane diagrams, cross-functional flowcharts, org charts, network diagrams, UML diagrams, BPMN, project management diagrams (WBS, Gantt, PERT, RACI), risk matrices, stakeholder maps, or any other visual diagram in draw.io format. This skill includes access to custom shape libraries for icons, clipart, and professional symbols.
Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks
Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.
Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks
Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).
Provides comprehensive technical analysis for stocks and ETFs using RSI, MACD, Bollinger Bands, and other indicators. Activates when user requests stock analysis, technical indicators, trading signals, or market data for specific ticker symbols.