How do I install Rolli?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Rolli need an API key?

The publisher lists these environment variables: ROLLI_API_TOKEN, ROLLI_USER_ID.

When was Rolli last checked?

Last checked 2026-11-07. Social media search, expert discovery, and analytics across X, Reddit, YouTube, and more

Rolli MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @rolli/[email protected]

Credentials from the publisher

ROLLI_API_TOKEN — Rolli API token (purchase at rolli.ai)
ROLLI_USER_ID — Rolli user ID (optional, defaults to "rolli-mcp")

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1ROLLI_API_TOKEN=<secret> ROLLI_USER_ID=<value> claude mcp add ai.rolli-mcp -- npx -y @rolli/mcp@1.2.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "ai.rolli-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "@rolli/[email protected]"8      ],9      "env": {10        "ROLLI_API_TOKEN": "<secret>",11        "ROLLI_USER_ID": "<value>"12      }13    }14  }15}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.2.1
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Tools

Tool	Description
`list_keyword_searches`	List all keyword searches, filtered by status
`keyword_search`	Create a keyword/hashtag search and return results when complete
`get_keyword_search`	Get keyword search results (status, analytics, posts)
`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 user search results (profile, metrics, content analysis)
`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 (recommended experts with AI-generated match summaries)
`get_topic_tree`	Get conversation topic tree for a 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 (progress while running, 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 (daily/weekly/monthly/once)
`get_agent_schedule`	Get a Rolli Agent schedule with its 10 most recent runs
`update_agent_schedule`	Update a Rolli Agent schedule
`delete_agent_schedule`	Permanently delete a Rolli Agent schedule
`pause_agent_schedule`	Pause a Rolli Agent schedule
`resume_agent_schedule`	Resume a paused Rolli Agent schedule
`list_agent_schedule_runs`	List the full execution history of a Rolli Agent schedule
`get_integration_setup`	Get current integration settings (webhook URL, name)
`update_integration_setup`	Set the webhook URL for search completion notifications
`get_usage`	Get 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

Variable	Default	Description
`ROLLI_USER_ID`	`"rolli-mcp"`	User ID sent with API requests
`ROLLI_POLL_INTERVAL_MS`	`5000`	Polling interval (ms) when waiting for search results
`ROLLI_MAX_POLL_MS`	`600000`	Max 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

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

Rolli

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Rolli?

Does Rolli need an API key?

What transport does Rolli use?

When was Rolli last checked?

Documentation

Tools

Setup

Claude Desktop / Claude Code / VS Code / Cursor / Windsurf

Optional Environment Variables

Smithery

Usage Examples

Optional X/Twitter Source Context

Development

License