Skip to main content
Glama

ツール

ツール

説明

list_keyword_searches

ステータスでフィルタリングされたすべてのキーワード検索を一覧表示

keyword_search

キーワード/ハッシュタグ検索を作成し、完了時に結果を返す

get_keyword_search

キーワード検索結果(ステータス、分析、投稿)を取得

list_user_searches

ステータスでフィルタリングされたすべてのユーザー検索を一覧表示

user_search

ユーザープロフィール検索を作成し、完了時に結果を返す

get_user_search

ユーザー検索結果(プロフィール、指標、コンテンツ分析)を取得

get_topic_tree

キーワード検索のトピックツリーを取得

get_keyword_search_posts

キーワード検索から生の投稿を取得

get_user_search_posts

ユーザー検索から生の投稿を取得

get_integration_setup

現在の統合設定(Webhook URL、名前)を取得

update_integration_setup

検索完了通知用のWebhook URLを設定

get_usage

API使用状況データとユーザーごとの内訳を取得

Related MCP server: Grok X Insights MCP Server

セットアップ

APIアクセス権を持つRolliアカウントが必要です。rolli.aiからAPIトークンを取得してください。

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

MCP設定(claude_desktop_config.json、.vscode/mcp.json、または同等のもの)に追加してください:

{
  "mcpServers": {
    "rolli": {
      "command": "npx",
      "args": ["-y", "@rolli/mcp"],
      "env": {
        "ROLLI_API_TOKEN": "your_token"
      }
    }
  }
}

ROLLI_USER_IDはオプションで、デフォルトは"rolli-mcp"です。独自のユーザーIDで上書きする場合は設定してください。

オプションの環境変数

変数

デフォルト

説明

ROLLI_USER_ID

"rolli-mcp"

APIリクエストと共に送信されるユーザーID

ROLLI_POLL_INTERVAL_MS

5000

検索結果を待機する際のポーリング間隔(ミリ秒)

ROLLI_MAX_POLL_MS

600000

検索タイムアウトまでの最大待機時間(ミリ秒)(デフォルト:10分)

Smithery

このサーバーにはSmithery経由でデプロイするためのsmithery.yamlが含まれています。セットアップ中にAPIトークンの入力を求められます。

使用例

ソーシャルメディア全体でキーワードを検索:

"TwitterとRedditで先週の「人工知能」に関する投稿を検索して"

ユーザープロフィールを分析:

"Twitterで@elonmuskを検索し、最近の投稿を分析して"

トピックの内訳を取得:

"キーワード検索#123のトピックツリーを表示して"

API使用状況を確認:

"今月は何回検索を使用しましたか?"

Webhookを設定:

"Webhook URLをhttps://myapp.com/rolli-callbackに設定して"

開発

npm ci
npm run lint    # ESLint
npm run build   # TypeScript
npm test        # Vitest

CIはmasterへのすべてのプッシュとPRで実行されます。GitHubで公開されたリリースは自動的にnpmに公開されます(NPM_TOKENリポジトリシークレットが必要です)。

ライセンス

MIT

Available Tools

30 tools
cancel_agent_runA

Cancel a pending or running Rolli Agent run. Marks the run as failed.

Inputs: id (required).

create_agent_scheduleB

Create a recurring Rolli Agent report that runs on a cron-like cadence (daily, weekly, monthly, or one-time) with optional email and Slack notifications.

Inputs: name (required), question (required), starts_at (required), recurrence_time (required), +16 more.

delete_agent_runA

Soft-delete a Rolli Agent run. The record remains in the database for audit purposes but is hidden from listings. Only works on completed or failed runs — cancel the run first if it is still running.

Inputs: id (required).

delete_agent_scheduleA

Permanently delete a Rolli Agent schedule and its execution history. This is irreversible. Use pause_agent_schedule to temporarily stop a schedule without losing history.

Inputs: id (required).

get_agent_runA

Get a Rolli Agent run by ID. While running, returns progress (percentage, phase, current tool). Once complete, returns the full markdown report, signals, evidence links, and usage metrics.

Inputs: id (required).

get_agent_scheduleA

Get a Rolli Agent schedule's full configuration plus its 10 most recent execution records.

Inputs: id (required).

get_integration_setupA

Get the current integration settings (webhook return URL and integration name).

Inputs: no named parameters.

get_keyword_search_postsA

Get raw posts from a keyword search. The first line says how many of the search's posts this response shows and the offset of the next page; total, returned, offset and platform_counts (posts per platform across the whole search) are in the JSON. Read a large search in pages with offset and limit, one platform at a time, and fields=lean when the text matters more than media and profile URLs. A response over the size cap is marked truncated: true.

Inputs: search_id (required), limit, fields, offset, +1 more.

get_topic_treeB

Get the conversation topic tree for a keyword search. Shows how topics and subtopics are distributed across the search results.

Inputs: search_id (required), platform.

get_usageA

Get API usage data. Returns search counts, per-user breakdowns, and the current IQ credit balance (credits.credits_remaining, credits.credits_limit, credits.period_reset_date — the latter two are null for one-time credit grants). Optionally filter by month.

Inputs: month.

get_user_search_postsA

Get raw posts from a user search. The first line says how many of the profile's posts this response shows and the offset of the next page; total, returned and offset are in the JSON. Read a large search in pages with offset and limit, and fields=lean when the text matters more than media and profile URLs. A response over the size cap is marked truncated: true.

Inputs: search_id (required), limit, fields, offset.

list_agent_runsA

List Rolli Agent runs (AI-driven social intelligence investigations). Returns a paginated summary list. Discarded runs are excluded.

Inputs: limit, offset, status, user_id.

list_agent_schedule_runsA

List the full execution history of a Rolli Agent schedule, including a preview of each linked agent run.

Inputs: id (required), limit, offset.

list_agent_schedulesB

List Rolli Agent scheduled reports. Schedules execute on a daily/weekly/monthly/once cadence and produce a new agent run each time.

Inputs: limit, offset.

list_expert_searchesC

List all expert searches. Returns a paginated list filtered by status.

Inputs: page, show.

list_keyword_searchesB

List all keyword searches. Returns a paginated list filtered by status.

Inputs: page, show.

list_user_searchesC

List all user searches. Returns a paginated list filtered by status.

Inputs: page, show.

pause_agent_scheduleA

Pause a Rolli Agent schedule so it stops executing. The schedule and its history are preserved — resume it later with resume_agent_schedule.

Inputs: id (required).

rerun_agent_runA

Rerun a failed, waiting, or stuck Rolli Agent run. Resets the run to pending and re-enqueues it. Running runs are force-cancelled first. Returns 422 if the run is already completed. Fails immediately if the IQ credit balance is exhausted (a rerun needs at least 1 credit).

Inputs: id (required).

resume_agent_scheduleA

Resume a paused Rolli Agent schedule. next_run_at is recalculated based on the recurrence parameters.

Inputs: id (required).

start_agent_runA

Start a Rolli Agent investigation. Submit a plain-English question; the agent plans a search strategy, queries Rolli IQ across platforms, analyzes posts, and produces a markdown intelligence report with signals, evidence links, and a confidence rating. Fails immediately (before starting) if the IQ credit balance is insufficient. Polls inline for up to 2 minutes. If the run finishes in that window, returns the full results; otherwise returns the run ID and a note to fetch the results with get_agent_run (typical run takes 3–5 minutes).

Inputs: question (required), mode, max_post, metadata, +4 more.

update_agent_runB

Update a Rolli Agent run's metadata (rename or pin). At least one of pinned or label is required.

Inputs: id (required), label, pinned.

update_agent_scheduleB

Partially update a Rolli Agent schedule. Unspecified fields are left unchanged. next_run_at is recalculated if any recurrence parameter changes.

Inputs: id (required), mode, name, ends_at, +14 more.

update_integration_setupC

Update integration configuration. Set the webhook URL that receives notifications when a search completes.

Inputs: return_url (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 30 tools

    Disambiguation4/5

    The three search creators (keyword_search, user_search, expert_search) target genuinely distinct resources, and the get_/list_/get_*_posts variants are separated by clear descriptions about paging and polling. The only friction is the large family of similarly named search readers (get_keyword_search vs. get_keyword_search_posts vs. list_keyword_searches), which an agent must read carefully but can still distinguish.

    Naming Consistency4/5

    Nearly everything follows snake_case verb_noun (get_agent_run, create_agent_schedule, cancel_agent_run, list_user_searches), and the agent/schedule families are very predictable. The deviations are the three creation tools named noun-first (keyword_search, user_search, expert_search) instead of create_*, which breaks the pattern in the single most-used operation.

    Tool Count3/5

    30 tools is heavy and crosses the point where surface area itself becomes a selection cost. The count is partly justified by four sub-domains (searches, agent runs, schedules, integrations/usage), but the search family alone spawns ~12 tools that could be consolidated with a resource parameter.

    Completeness4/5

    Agent runs and schedules have full lifecycle coverage (create/get/list/update/delete/cancel/rerun; create/get/update/delete/pause/resume/runs), and searches cover create/get/list/paged posts plus polling semantics. The gap is that no search type (keyword, user, expert) can be deleted or updated, and there is no way to re-fetch a stale search beyond retrying.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      SocialCrawl provides the "best" quality public web data on the internet. Access 65+ real-time social media, e-commerce and public web data from a single API with a single schema.
      5
      569 npm
      28
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to search, describe and call 239 social data endpoints across Instagram, TikTok, LinkedIn, Facebook, YouTube, X, Reddit, Threads and Pinterest through a single API key, covering profiles, posts, comments, followers, hashtags, ads and transcripts with one unified schema. Full responses are saved server-side and can be re-sliced for free with jq, fields or size outlines, so agents pull only the data they need into context.
      121 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI tools to read publicly visible social media posts, comments, profiles, and trends from 18 platforms such as TikTok, Instagram, X, Reddit, YouTube, Xiaohongshu, and Weibo, on a prepaid pay-per-call basis where failed calls are free. Ships tools for search, trending, detail, comments, user profiles and posts, plus higher-level workflows like brand buzz, comment analysis, account watching, creator discovery, bulk link data, and viral finding.
      MIT