Rolli

ai.rolliPublished by rolli.aiv1.2.1Updated Oct 24, 2026

Social media search, expert discovery, and analytics across X, Reddit, YouTube, and more

VerifiedSTDIODesktop onlyProductivity & WorkflowWeb Search & ScrapingData & Analytics

Overview

AI-generated overview

Lets an assistant run social media keyword, user, and expert searches across X, Reddit, YouTube and more, and manage Rolli Agent reports.

What you can do
Rolli IQ provides social media search and analytics across X, Reddit, YouTube, Facebook, Instagram, Threads, Bluesky and other platforms. Tools create and retrieve keyword/hashtag searches, user profile searches, and expert searches, returning status, analytics, posts, and conversation topic trees. It also manages Rolli Agent investigations and scheduled reports, including starting, cancelling, rerunning, pinning, renaming, and deleting runs and schedules, plus webhook setup and API usage reporting.
When to use it
Use it when an assistant needs cross-platform social listening, topic breakdowns, profile analysis, expert discovery, or recurring social intelligence reports. It fits research, marketing, and monitoring workflows that already use a Rolli account.
Requirements
Runs locally over stdio via the npm package @rolli/mcp, so Node.js and npx are needed. A Rolli account with API access is required, and the API token is supplied through the ROLLI_API_TOKEN environment variable. Optional variables include ROLLI_USER_ID, ROLLI_POLL_INTERVAL_MS, and ROLLI_MAX_POLL_MS. Network access to the Rolli API is required.
Before you install
The server requires the secret ROLLI_API_TOKEN, which is purchased from the provider; keep it private and do not share it between tools. Several tools write or change data, including creating and deleting agent runs and schedules, updating integration settings, and setting a webhook URL. Searches and reports send queries and account data to the Rolli service.

Installation

In SourceWeft

  1. Open Rolli in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[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)
list_expert_searchesList all expert searches, filtered by status
expert_searchFind experts matching a natural-language query and return results when complete
get_expert_searchGet expert search results (recommended experts with AI-generated match summaries)
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
list_agent_runsList Rolli Agent runs (AI-driven social intelligence investigations)
start_agent_runStart a Rolli Agent investigation and return the markdown report when complete
get_agent_runGet a Rolli Agent run by ID (progress while running, full report when complete)
cancel_agent_runCancel a pending or running Rolli Agent run
rerun_agent_runRetry a failed, waiting, or stuck Rolli Agent run
update_agent_runPin or rename a Rolli Agent run
delete_agent_runSoft-delete a completed or failed Rolli Agent run
list_agent_schedulesList Rolli Agent scheduled reports
create_agent_scheduleCreate a recurring Rolli Agent report (daily/weekly/monthly/once)
get_agent_scheduleGet a Rolli Agent schedule with its 10 most recent runs
update_agent_scheduleUpdate a Rolli Agent schedule
delete_agent_schedulePermanently delete a Rolli Agent schedule
pause_agent_schedulePause a Rolli Agent schedule
resume_agent_scheduleResume a paused Rolli Agent schedule
list_agent_schedule_runsList the full execution history of a Rolli Agent schedule
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):

json
{  "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"

Optional X/Twitter Source Context

Rolli is useful for cross-platform social search, topic trees, user analysis, and scheduled social intelligence reports. If an agent also needs reviewed account-scoped X/Twitter source evidence before a Rolli investigation, collect that evidence in an approved OpenClaw workflow such as TweetClaw, then pass only the reviewed handles, post URLs, post IDs, excerpts, or summary notes into Rolli prompts.

Keep Rolli and TweetClaw credentials separate. Do not transfer API tokens, cookies, sessions, or account credentials between tools. Treat TweetClaw output as source context for Rolli searches and reports, not as publishing approval.

Development

sh
npm cinpm run lint    # ESLintnpm run build   # TypeScriptnpm 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

Source: README.md at commit f0ded75

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.2.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts