// MCP TOOL REFERENCE

ROLLI TOOLS

30 tools from the Rolli MCP Server, categorised by risk level.

// ALL 30 ROLLI TOOLS

READ 19 tools

Read expert_search Find experts matching a natural-language query using Rolli Read get_agent_run Get a Rolli Agent run by ID. While running, returns progress (percentage, phase, current tool). Once comple... Read get_agent_schedule Get a Rolli Agent schedule Read get_expert_search Get results for an expert search by ID. Returns search status and, once complete, the array of recommended ... Read get_integration_setup Get the current integration settings (webhook return URL and integration name). Read get_keyword_search Get results for a keyword search by ID. Returns search status, analytics summary, and posts. Read get_keyword_search_posts Get raw posts from a keyword search. Returns the actual social media posts matching the search query. Read get_topic_tree Get the conversation topic tree for a keyword search. Shows how topics and subtopics are distributed across... Read get_usage Get API usage data. Returns search counts and per-user breakdowns. Optionally filter by month. Read get_user_search Get results for a user search by ID. Returns profile info, metrics, and content analysis. Read get_user_search_posts Get raw posts from a user search. Returns the actual social media posts from the searched user profile. Read keyword_search Create a keyword/hashtag search across social media platforms (X, Reddit, YouTube, Facebook, Instagram, Thr... Read list_agent_runs List Rolli Agent runs (AI-driven social intelligence investigations). Returns a paginated summary list. Dis... Read list_agent_schedule_runs List the full execution history of a Rolli Agent schedule, including a preview of each linked agent run. Read list_agent_schedules List Rolli Agent scheduled reports. Schedules execute on a daily/weekly/monthly/once cadence and produce a ... Read list_expert_searches List all expert searches. Returns a paginated list filtered by status. Read list_keyword_searches List all keyword searches. Returns a paginated list filtered by status. Read list_user_searches List all user searches. Returns a paginated list filtered by status. Read user_search Create a user profile search on a social media platform. Polls until the search is complete and returns the...

WRITE 6 tools

Write create_agent_schedule Create a recurring Rolli Agent report that runs on a cron-like cadence (daily, weekly, monthly, or one-time... Write pause_agent_schedule Pause a Rolli Agent schedule so it stops executing. The schedule and its history are preserved — resume it ... Write resume_agent_schedule Resume a paused Rolli Agent schedule. next_run_at is recalculated based on the recurrence parameters. Write update_agent_run Update a Rolli Agent run Write update_agent_schedule Partially update a Rolli Agent schedule. Unspecified fields are left unchanged. next_run_at is recalculated... Write update_integration_setup Update integration configuration. Set the webhook URL that receives notifications when a search completes.

DESTRUCTIVE 3 tools

Destructive cancel_agent_run Cancel a pending or running Rolli Agent run. Marks the run as failed. Destructive delete_agent_run Soft-delete a Rolli Agent run. The record remains in the database for audit purposes but is hidden from lis... Destructive delete_agent_schedule Permanently delete a Rolli Agent schedule and its execution history. This is irreversible. Use pause_agent_...

EXECUTE 2 tools

Execute rerun_agent_run Rerun a failed, waiting, or stuck Rolli Agent run. Resets the run to pending and re-enqueues it. Running ru... Execute start_agent_run Start a Rolli Agent investigation. Submit a plain-English question; the agent plans a search strategy, quer...

// RUNNING THIS SERVER

The managed route: connect Rolli through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y @rolli/mcp

// FAQ

How many tools does the Rolli MCP server have? +

The Rolli MCP server exposes 30 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Rolli tools? +

Route the Rolli server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Rolli tools fall into? +

Rolli tools are categorised as Read (19), Write (6), Destructive (3), Execute (2). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.