Rolli MCP
도구
도구 | 설명 |
| 상태별로 필터링된 모든 키워드 검색 목록을 가져옵니다 |
| 키워드/해시태그 검색을 생성하고 완료 시 결과를 반환합니다 |
| 키워드 검색 결과(상태, 분석, 게시물)를 가져옵니다 |
| 상태별로 필터링된 모든 사용자 검색 목록을 가져옵니다 |
| 사용자 프로필 검색을 생성하고 완료 시 결과를 반환합니다 |
| 사용자 검색 결과(프로필, 지표, 콘텐츠 분석)를 가져옵니다 |
| 키워드 검색에 대한 대화 주제 트리를 가져옵니다 |
| 키워드 검색에서 원본 게시물을 가져옵니다 |
| 사용자 검색에서 원본 게시물을 가져옵니다 |
| 현재 통합 설정(웹훅 URL, 이름)을 가져옵니다 |
| 검색 완료 알림을 위한 웹훅 URL을 설정합니다 |
| 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로 재정의하려면 설정하세요.
선택적 환경 변수
변수 | 기본값 | 설명 |
|
| API 요청과 함께 전송되는 사용자 ID |
|
| 검색 결과를 기다릴 때의 폴링 간격(ms) |
|
| 검색 시간 초과 전 대기할 최대 시간(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 # VitestCI는 master 브랜치에 대한 모든 푸시 및 PR 시 실행됩니다. GitHub에 게시된 릴리스는 자동으로 npm에 게시됩니다(NPM_TOKEN 저장소 비밀값이 필요함).
라이선스
MIT
Available Tools
30 toolscancel_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).
expert_searchA
Find experts matching a natural-language query using Rolli's AI-driven recommendation engine. Polls until the search is complete and returns the full list of recommended experts (name, professional title, location, contact info, expertise keywords, and an AI-generated summary explaining why each expert matches). A status of results_pending means the search succeeded but results are still being written; fetch them with get_expert_search.
Inputs: query (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_expert_searchA
Get results for an expert search by ID. Returns search status and, once complete, the array of recommended experts with their profiles and AI-generated match summaries. results_pending: true means the search succeeded but the backend is still writing results; retry in a few seconds.
Inputs: id (required).
get_integration_setupA
Get the current integration settings (webhook return URL and integration name).
Inputs: no named parameters.
get_keyword_searchA
Get results for a keyword search by ID. Returns search status, analytics summary, and posts. Oversized responses are truncated (truncated: true) — read the complete post list in pages with get_keyword_search_posts (offset, limit, fields=lean, one platform at a time). results_pending: true means the search succeeded but the backend is still writing results; retry in a few seconds.
Inputs: id (required).
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_searchA
Get results for a user search by ID. Returns profile info, metrics, and content analysis. Oversized responses are truncated (truncated: true) — read the complete post list in pages with get_user_search_posts (offset, limit, fields=lean). results_pending: true means the search succeeded but the backend is still writing results; retry in a few seconds.
Inputs: id (required).
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.
keyword_searchA
Create a keyword/hashtag search across social media platforms (X, Reddit, YouTube, Facebook, Instagram, Threads, Bluesky, and more). Polls until the search is complete and returns the full results. Oversized responses are truncated (truncated: true, largest post arrays shortened) — read the complete post list in pages with get_keyword_search_posts (offset, limit, fields=lean, one platform at a time). A status of results_pending means the search succeeded but results are still being written; fetch them with get_keyword_search.
Inputs: query (required), sort_by, end_date, max_post, +4 more.
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).
user_searchA
Create a user profile search on a social media platform. Polls until the search is complete and returns the full results. Oversized responses are truncated (truncated: true) — read the complete post list in pages with get_user_search_posts (offset, limit, fields=lean). A status of results_pending means the search succeeded but results are still being written; fetch them with get_user_search.
Inputs: query (required), platform (required), end_date, enable_ai, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 30 tools
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.
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.
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.
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
Related MCP Connectors
Search and read public data from X/Twitter, Reddit, YouTube, Instagram, TikTok, Facebook, Threads, Bluesky, Trustpilot, Amazon, Google Maps, news, forums and the web. 90+ read-only tools plus ready-made research playbooks (lead finding, brand monitoring, review mining). Hosted: connect with an API key; 50 free requests per endpoint each month.
Live public data from TikTok, LinkedIn, YouTube, X, Reddit and 17 more networks, via one key.
Instagram, X, TikTok, YouTube, Facebook and Reddit data. Approved OAuth or API-key access required.
8 social listening tools over one MCP endpoint: Reddit, X, Threads, YouTube, Google Trends, news.
Related MCP Servers
AlicenseAqualityCmaintenanceSocialCrawl 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.5569 npm28MIT- AlicenseNot gradedqualityDmaintenanceReal-time X/Twitter social intelligence for AI agents and developers, powered by Grok's live search capabilities.16 npm3MIT

insightsocialofficial
AlicenseNot gradedqualityBmaintenanceEnables 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 npmMIT
SocialToAI MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables 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