Rolli MCP

Social media search and analytics across X, Reddit, Bluesky, YouTube, LinkedIn, Facebook, Instagram, and Weibo via the Rolli IQ API

GitHub

Rolli IQ

rolli-mcp

MCP server for Rolli IQ — social media search and analytics across X, Reddit, YouTube, Facebook, Instagram, Threads, Bluesky, and more.

Rolli MCP server

Tools

ToolDescription
list_keyword_searchesList all keyword searches, filtered by status
keyword_searchCreate a keyword/hashtag search and return results when complete
get_keyword_searchGet keyword search results (status, analytics, posts)
list_user_searchesList all user searches, filtered by status
user_searchCreate a user profile search and return results when complete
get_user_searchGet user search results (profile, metrics, content analysis)
get_topic_treeGet conversation topic tree for a keyword search
get_keyword_search_postsGet raw posts from a keyword search
get_user_search_postsGet raw posts from a user search
get_integration_setupGet current integration settings (webhook URL, name)
update_integration_setupSet the webhook URL for search completion notifications
get_usageGet 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

VariableDefaultDescription
ROLLI_USER_ID"rolli-mcp"User ID sent with API requests
ROLLI_POLL_INTERVAL_MS5000Polling interval (ms) when waiting for search results
ROLLI_MAX_POLL_MS600000Max 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

Related Servers

NotebookLM Web Importer

Import web pages and YouTube videos to NotebookLM with one click. Trusted by 200,000+ users.

Install Chrome Extension