cancel_agent_run
Cancel a pending or running Rolli Agent run. Marks the run as failed.
LABSCO SUMMARY
Cross-platform social search, plus an agent that turns a question into a report on a schedule.
The searches are the raw material; the agent runs are what make it more than a query tool — one plain-English question produces a markdown report with signals and evidence links, and a schedule reruns it weekly. Oversized responses come back truncated by design, so plan on fetching the raw posts one platform at a time when you need the underlying text.
What it is
The MCP server for Rolli IQ. It runs three kinds of search — keyword or hashtag across platforms, a user profile, and an expert recommendation from a plain-language brief — and layers an agent on top that plans its own search strategy and writes a markdown report, on demand or on a schedule.
What you get
- keyword_search, get_keyword_search and list_keyword_searches — create a cross-platform keyword or hashtag search, poll it to completion, and revisit past ones by status
- user_search, get_user_search and list_user_searches — a profile search returning metrics and content analysis
- get_keyword_search_posts and get_user_search_posts — the raw posts behind a search when the summary response was truncated
- get_topic_tree — how topics and subtopics are distributed across a keyword search's results
- expert_search, get_expert_search and list_expert_searches — find people matching a natural-language query, returned with AI-generated match summaries
- start_agent_run, get_agent_run, cancel_agent_run, rerun_agent_run, update_agent_run, delete_agent_run and list_agent_runs — submit a plain-English question, watch the phase and percentage while it works, and read the markdown report with its signals and evidence links
- create_agent_schedule, get_agent_schedule, update_agent_schedule, pause_agent_schedule, resume_agent_schedule, delete_agent_schedule and list_agent_schedule_runs — recurring reports on a daily, weekly, monthly or one-time cadence, with email and Slack notifications
- get_integration_setup, update_integration_setup and get_usage — the webhook that fires when a search completes, and search counts with the remaining IQ credit balance
Requirements
A Rolli account with API access and its token in ROLLI_API_TOKEN. Clients run npx -y @rolli/mcp over stdio. ROLLI_USER_ID is optional and defaults to rolli-mcp. Searches poll to completion inside the tool call, so ROLLI_POLL_INTERVAL_MS and ROLLI_MAX_POLL_MS control how long a call is willing to wait — the default ceiling is ten minutes.
Setup effort
One command plus a key — npx -y @rolli/mcp, then supply credentials
USE CASES
01
Finding out what is being said about a topic
Run the keyword search across platforms and read the topic tree it produces.
02
Sizing up an account
Search the user profile and read its metrics and content analysis, then pull the raw posts.
03
Answering a broad question with evidence
Submit it as an agent investigation and read the finished report with its evidence links.
04
Keeping a weekly eye on a market
Schedule the same investigation to run weekly with a Slack notification, and pause it when it stops being useful.
05
Finding people who know a subject
Describe what you need in plain language and read the ranked experts with their match summaries.
30 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
create_agent_schedule
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.
delete_agent_run
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.
delete_agent_schedule
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.
expert_search
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.
get_agent_run
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.
get_agent_schedule
Get a Rolli Agent schedule's full configuration plus its 10 most recent execution records.
get_expert_search
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.
get_integration_setup
Get the current integration settings (webhook return URL and integration name).
get_keyword_search
Get results for a keyword search by ID. Returns search status, analytics summary, and posts. Oversized responses are truncated (truncated: true) — retrieve complete post data with get_keyword_search_posts. results_pending: true means the search succeeded but the backend is still writing results; retry in a few seconds.
get_keyword_search_posts
Get raw posts from a keyword search. Returns the actual social media posts matching the search query. Oversized responses are truncated (truncated: true) — request one platform at a time for full data on large searches.
get_topic_tree
Get the conversation topic tree for a keyword search. Shows how topics and subtopics are distributed across the search results.
get_usage
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.
get_user_search
Get results for a user search by ID. Returns profile info, metrics, and content analysis. Oversized responses are truncated (truncated: true) — retrieve complete post data with get_user_search_posts. results_pending: true means the search succeeded but the backend is still writing results; retry in a few seconds.
get_user_search_posts
Get raw posts from a user search. Returns the actual social media posts from the searched user profile. Oversized responses are truncated (truncated: true).
keyword_search
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) — retrieve complete post data with get_keyword_search_posts. A status of results_pending means the search succeeded but results are still being written; fetch them with get_keyword_search.
list_agent_runs
List Rolli Agent runs (AI-driven social intelligence investigations). Returns a paginated summary list. Discarded runs are excluded.
list_agent_schedule_runs
List the full execution history of a Rolli Agent schedule, including a preview of each linked agent run.
list_agent_schedules
List Rolli Agent scheduled reports. Schedules execute on a daily/weekly/monthly/once cadence and produce a new agent run each time.
list_expert_searches
List all expert searches. Returns a paginated list filtered by status.
list_keyword_searches
List all keyword searches. Returns a paginated list filtered by status.
list_user_searches
List all user searches. Returns a paginated list filtered by status.
pause_agent_schedule
Pause a Rolli Agent schedule so it stops executing. The schedule and its history are preserved — resume it later with resume_agent_schedule.
rerun_agent_run
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).
resume_agent_schedule
Resume a paused Rolli Agent schedule. next_run_at is recalculated based on the recurrence parameters.
start_agent_run
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).
update_agent_run
Update a Rolli Agent run's metadata (rename or pin). At least one of pinned or label is required.
update_agent_schedule
Partially update a Rolli Agent schedule. Unspecified fields are left unchanged. next_run_at is recalculated if any recurrence parameter changes.
update_integration_setup
Update integration configuration. Set the webhook URL that receives notifications when a search completes.
user_search
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) — retrieve complete post data with get_user_search_posts. A status of results_pending means the search succeeded but results are still being written; fetch them with get_user_search.
BEFORE YOU INSTALL
What to know first
Tools you get
30 tools when we connected. keyword_search, user_search and expert_search each bill against your Rolli account, and create_agent_schedule sets up a recurring report that keeps running. get_usage shows the cost so far.
Requires
- npx on PATH
- ROLLI_API_TOKEN in your environment
Where it runs
All 5 documented clients run the server on your machine.
CONTEXT COST
Moderate Standing cost
Rated by the size of the 30 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @rolli/mcpMCP Clients
Claude Desktop, Claude Code, Cursor, Windsurf
JSON
{
"mcpServers": {
"rolli": {
"command": "npx",
"args": [
"-y",
"@rolli/mcp"
],
"env": {
"ROLLI_API_TOKEN": "<YOUR_ROLLI_API_TOKEN>"
}
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"rolli": {
"command": "npx",
"args": [
"-y",
"@rolli/mcp"
],
"env": {
"ROLLI_API_TOKEN": "<YOUR_ROLLI_API_TOKEN>"
}
}
}
}
