Rolli MCP
Rolli MCP is a social media search and analytics server for searching, analyzing, and monitoring content across X/Twitter, Reddit, YouTube, Facebook, Instagram, Threads, Bluesky, LinkedIn, Weibo, and more.
Keyword/Hashtag Search: Create, list, and filter searches across multiple platforms with optional date ranges and post count limits.
User Profile Search: Look up and analyze user profiles on Twitter, Facebook, or Instagram with date-filtered post retrieval.
Search Management: List and filter all keyword or user searches by status (pending, started, finished, failed).
Retrieve Search Results: Get detailed results, analytics summaries, profile info, and metrics for any search by ID.
Topic Tree Analysis: Explore conversation topic trees for keyword searches to understand topic/subtopic distribution, filterable by platform.
Raw Post Access: Retrieve actual social media posts from keyword or user searches, with platform filtering.
Webhook Integration: Configure webhook URLs to receive notifications when searches complete.
API Usage Monitoring: Track API usage statistics and per-user breakdowns, with optional filtering by month (past 12 months).
Enables social media search, user profile analysis, and conversation topic breakdown on Bluesky through the Rolli IQ API.
Enables social media search, user profile analysis, and conversation topic breakdown on Facebook through the Rolli IQ API.
Enables social media search, user profile analysis, and conversation topic breakdown on Instagram through the Rolli IQ API.
Enables social media search, user profile analysis, and conversation topic breakdown on Reddit through the Rolli IQ API.
Enables social media search, user profile analysis, and conversation topic breakdown on YouTube through the Rolli IQ API.
Tools
Tool | Description |
| 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 |
| Get user search results (profile, metrics, content analysis) |
| Get conversation topic tree for a keyword search |
| Get raw posts from a keyword search |
| Get raw posts from a user search |
| Get current integration settings (webhook URL, name) |
| Set the webhook URL for search completion notifications |
| 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 |
|
| User ID sent with API requests |
|
| Polling interval (ms) when waiting for search results |
|
| 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 # VitestCI runs on every push and PR to master. Releases published on GitHub automatically publish to npm (requires NPM_TOKEN repo secret).
License
MIT
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/rolliinc/rolli-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server