mcp · rolliinc — Claude Code MCP server: what it does, how to install
Connects Rolli IQ to your coding agent for social media monitoring, expert discovery, and automated topic investigations across networks like Reddit, X, and YouTube.
claude mcp add --env ROLLI_API_TOKEN=<ROLLI_API_TOKEN> --env ROLLI_USER_ID=<ROLLI_USER_ID> --transport stdio rolliinc-mcp -- npx -y @rolli/mcpWhat mcp does
This server wires your AI workspace into Rolli IQ over standard MCP pipes. It pulls conversations from platforms such as Reddit, X, and YouTube, returning raw message threads alongside structured topic graphs. You can also look up creator profiles or locate niche authorities using plain text prompts.
The package handles long-running investigations through dedicated background agents. You can schedule these investigative runs on daily or weekly intervals to track emerging narratives automatically. By default, client polling checks status every 5000 milliseconds and times out after 600000 milliseconds.
Without a valid ROLLI_API_TOKEN set in your environment, the server refuses every request. Execution happens via npx -y @rolli/mcp. Webhook destinations for search completion pings can be registered through the update_integration_setup tool.
What it helps with
- track social discussions across Reddit and X
- discover topic authorities through natural language queries
- schedule periodic automated intelligence reports
- retrieve conversation topic branches for hashtag research
- monitor API consumption across team accounts
Example prompts for the agent
- Find recent discussions about machine learning on Reddit and display the main conversation clusters.
- Trigger an agent investigation for our product name and compile a Markdown summary.
- Check our current Rolli API usage figures for the active billing cycle.
How to install mcp
Platform CLI
claude mcp add --env ROLLI_API_TOKEN=<ROLLI_API_TOKEN> --env ROLLI_USER_ID=<ROLLI_USER_ID> --transport stdio rolliinc-mcp -- npx -y @rolli/mcpReplace <…> with your own values
Platform CLI
codex mcp add rolliinc-mcp --env ROLLI_API_TOKEN=<ROLLI_API_TOKEN> --env ROLLI_USER_ID=<ROLLI_USER_ID> -- npx -y @rolli/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"rolliinc-mcp": {
"command": "npx",
"args": [
"-y",
"@rolli/mcp"
],
"env": {
"ROLLI_API_TOKEN": "<ROLLI_API_TOKEN>",
"ROLLI_USER_ID": "<ROLLI_USER_ID>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"rolliinc-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@rolli/mcp"
],
"env": {
"ROLLI_API_TOKEN": "<ROLLI_API_TOKEN>",
"ROLLI_USER_ID": "<ROLLI_USER_ID>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e ROLLI_API_TOKEN=<ROLLI_API_TOKEN> -e ROLLI_USER_ID=<ROLLI_USER_ID> rolliinc-mcp npx -y @rolli/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp
How do I install mcp in Claude Code?
Run claude mcp add mcp -e ROLLI_API_TOKEN=<ROLLI_API_TOKEN> -- npx -y @rolli/mcp in your terminal. Replace <ROLLI_API_TOKEN> with your personal token from your rolli.ai profile.
What capabilities does mcp provide?
The package gives coding assistants access to Rolli IQ data tools. It inspects public chatter on networks like X and YouTube, identifies relevant domain experts, and executes deep investigative runs.
What happens if a social search takes several minutes?
The server polls for updates every 5000 milliseconds until data arrives or the 600000 millisecond cutoff is reached. You can adjust both boundaries by defining ROLLI_POLL_INTERVAL_MS and ROLLI_MAX_POLL_MS.
Similar MCP servers
All MCP servers for Marketing and content →mcp by other authors comes first.
