# mcp

Connects Rolli IQ to your coding agent for social media monitoring, expert discovery, and automated topic investigations across networks like Reddit, X, and YouTube.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Author: rolliinc
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rolliinc/rolli-mcp
- Updated: 2026-09-10
- HTML: https://affpapa.org/en/nevibecode/mcp/rolliinc-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ROLLI_API_TOKEN`, `ROLLI_USER_ID` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ROLLI_API_TOKEN=<ROLLI_API_TOKEN> --env ROLLI_USER_ID=<ROLLI_USER_ID> --transport stdio rolliinc-mcp -- npx -y @rolli/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add rolliinc-mcp --env ROLLI_API_TOKEN=<ROLLI_API_TOKEN> --env ROLLI_USER_ID=<ROLLI_USER_ID> -- npx -y @rolli/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ROLLI_API_TOKEN=<ROLLI_API_TOKEN> -e ROLLI_USER_ID=<ROLLI_USER_ID> rolliinc-mcp npx -y @rolli/mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)](https://affpapa.org/en/nevibecode/mcp/social-media-search-api-twitter-instagram-reddit-tiktok-xpoz.md) — MCP server · ★ 13
- [social-content](https://affpapa.org/en/nevibecode/skills/openclaudia-social-content.md) — skill · 508 installs
- [thread-writer](https://affpapa.org/en/nevibecode/skills/openclaudia-thread-writer.md) — skill · 461 installs
- [comment-mining](https://affpapa.org/en/nevibecode/skills/comment-mining.md) — skill · 1200 installs
- [social-card-gen](https://affpapa.org/en/nevibecode/skills/social-card-gen.md) — skill · ★ 449
- [Hyperaware: What's Trending Now](https://affpapa.org/en/nevibecode/mcp/hyperaware-whats-trending-now.md) — MCP server

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12111
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2768
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1350
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md