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):
{
"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