About ai.rolli/mcp
ai.rolli/mcp is an MCP server in the Social category: social media search and analytics across X, Reddit, Bluesky, YouTube, and more.
Install
claude mcp add ai-rolli-mcp -- npx -y @rolli/mcpnpx -y @rolli/mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (30)
cancel_agent_runCancel a pending or running Rolli Agent run
Parameters not published.
create_agent_scheduleCreate a recurring Rolli Agent report (daily/weekly/monthly/once)
Parameters not published.
delete_agent_runSoft-delete a completed or failed Rolli Agent run
Parameters not published.
delete_agent_schedulePermanently delete a Rolli Agent schedule
Parameters not published.
expert_searchFind experts matching a natural-language query and return results when complete
Parameters not published.
get_agent_runGet a Rolli Agent run by ID (progress while running, full report when complete)
Parameters not published.
get_agent_scheduleGet a Rolli Agent schedule with its 10 most recent runs
Parameters not published.
get_expert_searchGet expert search results (recommended experts with AI-generated match summaries)
Parameters not published.
get_integration_setupGet current integration settings (webhook URL, name)
Parameters not published.
get_keyword_searchGet keyword search results (status, analytics, posts)
Parameters not published.
Show all 30 tools
get_keyword_search_postsGet raw posts from a keyword search
Parameters not published.
get_topic_treeGet conversation topic tree for a keyword search
Parameters not published.
get_usageGet API usage data and per-user breakdowns
Parameters not published.
get_user_searchGet user search results (profile, metrics, content analysis)
Parameters not published.
get_user_search_postsGet raw posts from a user search
Parameters not published.
keyword_searchCreate a keyword/hashtag search and return results when complete
Parameters not published.
list_agent_runsList Rolli Agent runs (AI-driven social intelligence investigations)
Parameters not published.
list_agent_schedule_runsList the full execution history of a Rolli Agent schedule
Parameters not published.
list_agent_schedulesList Rolli Agent scheduled reports
Parameters not published.
list_expert_searchesList all expert searches, filtered by status
Parameters not published.
list_keyword_searchesList all keyword searches, filtered by status
Parameters not published.
list_user_searchesList all user searches, filtered by status
Parameters not published.
pause_agent_schedulePause a Rolli Agent schedule
Parameters not published.
rerun_agent_runRetry a failed, waiting, or stuck Rolli Agent run
Parameters not published.
resume_agent_scheduleResume a paused Rolli Agent schedule
Parameters not published.
start_agent_runStart a Rolli Agent investigation and return the markdown report when complete
Parameters not published.
update_agent_runPin or rename a Rolli Agent run
Parameters not published.
update_agent_scheduleUpdate a Rolli Agent schedule
Parameters not published.
update_integration_setupSet the webhook URL for search completion notifications
Parameters not published.
user_searchCreate a user profile search and return results when complete
Parameters not published.
Ask AI
Ask AI about ai.rolli/mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.