rolli-mcp

rolli-mcp

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

Tools

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

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