Social media search and analytics across X, Reddit, Bluesky, YouTube, and more
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Capabilities & Tool Schemas (30)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Rolli MCP.
list_keyword_searchesList all keyword searches, filtered by status
keyword_searchCreate a keyword/hashtag search and return results when complete
get_keyword_searchGet keyword search results (status, analytics, posts)
list_user_searchesList all user searches, filtered by status
user_searchCreate a user profile search and return results when complete
get_user_searchGet user search results (profile, metrics, content analysis)
Documentation Overview
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) |
list_expert_searches | List all expert searches, filtered by status |
expert_search | Find experts matching a natural-language query and return results when complete |
get_expert_search | Get expert search results (recommended experts with AI-generated match summaries) |
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 |
list_agent_runs | List Rolli Agent runs (AI-driven social intelligence investigations) |
start_agent_run | Start a Rolli Agent investigation and return the markdown report when complete |
get_agent_run | Get a Rolli Agent run by ID (progress while running, full report when complete) |
cancel_agent_run | Cancel a pending or running Rolli Agent run |
rerun_agent_run | Retry a failed, waiting, or stuck Rolli Agent run |
update_agent_run | Pin or rename a Rolli Agent run |
delete_agent_run | Soft-delete a completed or failed Rolli Agent run |
list_agent_schedules | List Rolli Agent scheduled reports |
create_agent_schedule | Create a recurring Rolli Agent report (daily/weekly/monthly/once) |
get_agent_schedule | Get a Rolli Agent schedule with its 10 most recent runs |
update_agent_schedule | Update a Rolli Agent schedule |
delete_agent_schedule | Permanently delete a Rolli Agent schedule |
pause_agent_schedule | Pause a Rolli Agent schedule |
resume_agent_schedule | Resume a paused Rolli Agent schedule |
list_agent_schedule_runs | List the full execution history of a Rolli Agent schedule |
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):
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"
Optional X/Twitter Source Context
Rolli is useful for cross-platform social search, topic trees, user analysis, and scheduled social intelligence reports. If an agent also needs reviewed account-scoped X/Twitter source evidence before a Rolli investigation, collect that evidence in an approved OpenClaw workflow such as TweetClaw, then pass only the reviewed handles, post URLs, post IDs, excerpts, or summary notes into Rolli prompts.
Keep Rolli and TweetClaw credentials separate. Do not transfer API tokens, cookies, sessions, or account credentials between tools. Treat TweetClaw output as source context for Rolli searches and reports, not as publishing approval.
Development
CI runs on every push and PR to master. Releases published on GitHub automatically publish to npm (requires NPM_TOKEN repo secret).
License
MIT
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
2
Stargazers on the source repository.
npm downloads
664
Package downloads in the last 30 days.
Last commit
15d ago
Most recent push to the default branch.
Tools exposed
30
Callable tools this server registers over MCP.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Rolli MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/mcp-24)HTML Embed
<a href="https://allmcps.com/mcp/mcp-24"><img src="https://allmcps.com/api/badge/mcp-24?style=directory" alt="Rolli MCP on AllMCPs" /></a>Technical Specs & Signals
CategorySocial Media
12/12 checks healthy over the last 43d
56Quality signal: Good · 56/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools24/30
Adoption & activity8/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 3d ago via OSV.dev · @rolli/mcp (npm)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.