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

현재 통합 설정(웹훅 URL, 이름)을 가져옵니다

update_integration_setup

검색 완료 알림을 위한 웹훅 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

검색 결과를 기다릴 때의 폴링 간격(ms)

ROLLI_MAX_POLL_MS

600000

검색 시간 초과 전 대기할 최대 시간(ms) (기본값: 10분)

Smithery

이 서버에는 Smithery를 통한 배포를 위한 smithery.yaml이 포함되어 있습니다. 설정 중에 API 토큰을 입력하라는 메시지가 표시됩니다.

사용 예시

소셜 미디어에서 키워드 검색:

"지난주 트위터와 레딧에서 '인공지능'에 관한 게시물을 검색해줘"

사용자 프로필 분석:

"트위터에서 @elonmusk를 찾아 최근 게시물을 분석해줘"

주제 분석 확인:

"내 키워드 검색 #123에 대한 주제 트리를 보여줘"

API 사용량 확인:

"이번 달에 검색을 몇 번 사용했어?"

웹훅 설정:

"내 웹훅 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