Rolli MCP server
{
"mcpServers": {
"rolli": {
"command": "npx",
"args": [
"-y",
"@rolli/mcp@latest"
],
"env": {
"ROLLI_API_TOKEN": "<rolli_api_token>",
"ROLLI_USER_ID": "<rolli_user_id>"
}
}
}
}{
"mcpServers": {
"rolli": {
"command": "npx",
"args": [
"-y",
"@rolli/mcp@latest"
],
"env": {
"ROLLI_API_TOKEN": "<rolli_api_token>",
"ROLLI_USER_ID": "<rolli_user_id>"
}
}
}
}{
"mcpServers": {
"rolli": {
"command": "npx",
"args": [
"-y",
"@rolli/mcp@latest"
],
"env": {
"ROLLI_API_TOKEN": "<rolli_api_token>",
"ROLLI_USER_ID": "<rolli_user_id>"
}
}
}
}{
"servers": {
"rolli": {
"command": "npx",
"args": [
"-y",
"@rolli/mcp@latest"
],
"env": {
"ROLLI_API_TOKEN": "${input:rolli_api_token}",
"ROLLI_USER_ID": "${input:rolli_user_id}"
}
}
},
"inputs": [
{
"id": "rolli_api_token",
"type": "promptString",
"description": "Rolli api token",
"password": true
},
{
"id": "rolli_user_id",
"type": "promptString",
"description": "Rolli user id",
"password": true
}
]
}{
"mcpServers": {
"rolli": {
"command": "npx",
"args": [
"-y",
"@rolli/mcp@latest"
],
"env": {
"ROLLI_API_TOKEN": "<rolli_api_token>",
"ROLLI_USER_ID": "<rolli_user_id>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y @rolli/mcpversion 1.2.1
What it does
rolli-mcp is an MCP server for the Rolli IQ platform that exposes social media search, user profile analysis, and expert discovery across X, Reddit, YouTube, Facebook, Instagram, Threads, Bluesky, and more. It is aimed at developers and analysts who want to query social data, run AI-driven investigations, and schedule recurring social intelligence reports from within MCP-compatible clients.
- Search for posts by keyword or hashtag across multiple social platforms and retrieve analytics and topic breakdowns.
- Find subject-matter experts matching a natural-language query, with AI-generated summaries explaining why each person matches.
- Schedule recurring automated social intelligence reports (daily, weekly, or monthly) and receive results via webhook.
Tools this server exposes
| Tool | Does |
|---|---|
| list_keyword_searches | List all keyword searches filtered by status. |
| keyword_search | Create a keyword or hashtag search and return results when complete. |
| get_keyword_search | Get results (status, analytics, posts) for an existing keyword search. |
| 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 results (profile, metrics, content analysis) for an existing user search. |
| 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 including recommended experts with AI-generated match summaries. |
| get_topic_tree | Get the conversation topic tree for a given 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, showing progress while running or the 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 on a daily, weekly, monthly, or one-time schedule. |
| get_agent_schedule | Get a Rolli Agent schedule along with its 10 most recent runs. |
| update_agent_schedule | Update settings on an existing Rolli Agent schedule. |
| delete_agent_schedule | Permanently delete a Rolli Agent schedule. |
| pause_agent_schedule | Pause a Rolli Agent schedule so it stops executing. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.