Rolli MCP
What it does
Social media search, expert discovery, and analytics across X, Reddit, YouTube, and more
- Connects Se ejecuta en tu computadora
- Account or key Needs ROLLI_API_TOKEN
- Category Marketing y redes sociales
Úsalo junto con
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
OpenCreator
Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.
Por qué está en este puesto
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 6/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 18/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Instalación
Elige la app de IA que usas y copia la configuración.
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Que la IA lo instale
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Rolli MCP para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "rolli": { "command": "npx", "args": [ "-y", "@rolli/mcp" ], "env": { "ROLLI_API_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En ROLLI_API_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Rolli MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
node -vSe instala una vez y sirve para todo lo que usa Node.js
Regístrate y crea una clave de Rolli MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Pega esta configuración y guarda el archivo
{ "mcpServers": { "rolli": { "command": "npx", "args": [ "-y", "@rolli/mcp" ], "env": { "ROLLI_API_TOKEN": "your-value" } } } }Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Cierra Claude y vuelve a abrirlo
Pruébalo
Usa Rolli MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Rolli MCP o muestra una herramienta de Rolli MCP en la respuesta, ya está conectado
1 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
ROLLI_USER_IDID de usuario de Rolli (opcional, por defecto "rolli-mcp")Ver original en inglés
Rolli user ID (optional, defaults to "rolli-mcp")
Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Rolli MCP
Rolli MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
Lo que puedes hacer en su lugar
A · Usa una app que pueda conectar Rolli MCP
- Necesitas una clave de Rolli MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
- Necesitas una clave de Rolli MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
- Necesitas una clave de Rolli MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
- Necesitas una clave de Rolli MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
B · Otros en Marketing y redes sociales que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
- Google Ads + Meta Ads + SEO/GEO MCP✓ ChatGPT
- Cargo✓ ChatGPT
- NotFair✓ ChatGPT
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Rolli MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Rolli MCP para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user rolli --env ROLLI_API_TOKEN=your-value -- npx -y @rolli/mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En ROLLI_API_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Rolli MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
node -vSe instala una vez y sirve para todo lo que usa Node.js
Regístrate y crea una clave de Rolli MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Pega este comando y pulsa Enter
claude mcp add --scope user rolli --env ROLLI_API_TOKEN=your-value -- npx -y @rolli/mcpCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Escribe /mcp en Claude Code
Deberías ver Rolli MCP en la lista como conectado
Pruébalo
Usa Rolli MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Rolli MCP o muestra una herramienta de Rolli MCP en la respuesta, ya está conectado
1 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
ROLLI_USER_IDID de usuario de Rolli (opcional, por defecto "rolli-mcp")Ver original en inglés
Rolli user ID (optional, defaults to "rolli-mcp")
Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Rolli MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Rolli MCP para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "rolli": { "command": "npx", "args": [ "-y", "@rolli/mcp" ], "env": { "ROLLI_API_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En ROLLI_API_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Rolli MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
node -vSe instala una vez y sirve para todo lo que usa Node.js
Regístrate y crea una clave de Rolli MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Escribe tu clave
En la configuración de Rolli MCP, ROLLI_API_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Abre el chat de IA de Cursor en modo Agent
Pruébalo
Usa Rolli MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Rolli MCP o muestra una herramienta de Rolli MCP en la respuesta, ya está conectado
1 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
ROLLI_USER_IDID de usuario de Rolli (opcional, por defecto "rolli-mcp")Ver original en inglés
Rolli user ID (optional, defaults to "rolli-mcp")
Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Rolli MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Rolli MCP para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "rolli": { "type": "stdio", "command": "npx", "args": [ "-y", "@rolli/mcp" ], "env": { "ROLLI_API_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En ROLLI_API_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Rolli MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
node -vSe instala una vez y sirve para todo lo que usa Node.js
Regístrate y crea una clave de Rolli MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Escribe tu clave
En la configuración de Rolli MCP, ROLLI_API_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Abre el chat de IA de VS Code en modo Agent
Pruébalo
Usa Rolli MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Rolli MCP o muestra una herramienta de Rolli MCP en la respuesta, ya está conectado
1 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
ROLLI_USER_IDID de usuario de Rolli (opcional, por defecto "rolli-mcp")Ver original en inglés
Rolli user ID (optional, defaults to "rolli-mcp")
Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Para desarrolladores: comandos de Terminal y configuración JSON
Instalado en tu computadora
Claude Code
claude mcp add --scope user rolli --env ROLLI_API_TOKEN=your-value -- npx -y @rolli/mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"rolli": {
"command": "npx",
"args": [
"-y",
"@rolli/mcp"
],
"env": {
"ROLLI_API_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"rolli": {
"command": "npx",
"args": [
"-y",
"@rolli/mcp"
],
"env": {
"ROLLI_API_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"rolli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@rolli/mcp"
],
"env": {
"ROLLI_API_TOKEN": "your-value"
}
}
}
}Valores que debes completar
ROLLI_API_TOKENsecreto obligatorio envToken de API de Rolli (adquirir en rolli.ai)Ver original en inglés
Rolli API token (purchase at rolli.ai)ROLLI_USER_IDenvID de usuario de Rolli (opcional, por defecto "rolli-mcp")Ver original en inglés
Rolli user ID (optional, defaults to "rolli-mcp")
Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
De un vistazo
Qué apps pueden usarlo
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Qué puede hacer
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisiones básicasi
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 16 nov 2026
- ✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con el dominio rolli.ai (el registro comprueba quién es dueño del dominio)
- ✓ Superada
Sigue en mantenimiento
Último cambio de código: hace 5 días
- ✓ Superada
Tiene licencia
Usa MIT
- – No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
- – No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
- … Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Vulnerabilidades publicadas (OSV.dev)
Sin entradas en OSV.dev para @rolli/mcp@1.2.1
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Creadores: pedir otra revisión o avisar de un dato erróneo
Conversación
Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Reseñas de usuarios
Aún no hay reseñas
Comparado con otros en Marketing y redes socialesi
- Más estrellas que el 91% de los otros 3976 servidores de esta categoría
- Publicado en el registro más recientemente que el 7% de los otros 3976 servidores de esta categoría
- Revisiones básicas iguales o mejores que el 100% de los otros 3976 servidores de esta categoría
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Preguntas frecuentes
¿Es seguro Rolli MCP?
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
¿Qué claves o códigos necesita?
Debes completar: ROLLI_API_TOKEN
¿Se ejecuta en mi computadora o en la nube?
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
¿Sigue en mantenimiento?
El repo de GitHub cambió por última vez hace 5 días, y la última versión (1.2.1) llegó al registro hace 6 meses.
¿Qué apps pueden usarlo?
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
¿Qué puedo usar en su lugar?
En la misma categoría: Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer
Alternativas parecidas
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Relaticle
Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.
ChatbotX
Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.
X (Twitter) MCP Server by Xquik
Xquik is the world's fastest and cheapest X (Twitter) data API with the most complete X data.
Betterlytics
Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
- Relaticle — Funciona en la nube, sin instalar nada · Sin clave
- ChatbotX — Funciona en la nube, sin instalar nada · Sin clave
- X (Twitter) MCP Server by Xquik — Funciona en la nube, sin instalar nada · Sin clave
- Betterlytics — Funciona en la nube, sin instalar nada · Necesita clave
- BibiGPT YouTube Video Summarizer — Funciona en la nube, sin instalar nada · Sin clave
README del creador
Abrir el README
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
rolli-mcp
MCP server for Rolli IQ — social media search and analytics across X, Reddit, YouTube, Facebook, Instagram, Threads, Bluesky, and more.
Tools
| Tool | Description |
|---|---|
list_keyword_searches | List all keyword searches, filtered by status |
keyword_search | Create a keyword/hashtag search and return results when complete |
get_keyword_search | Get keyword search results (status, analytics, posts) |
list_user_searches | List all user searches, filtered by status |
user_search | Create a user profile search and return results when complete |
get_user_search | Get user search results (profile, metrics, content analysis) |
list_expert_searches | List all expert searches, filtered by status |
expert_search | Find experts matching a natural-language query and return results when complete |
get_expert_search | Get expert search results (recommended experts with AI-generated match summaries) |
get_topic_tree | Get conversation topic tree for a keyword search |
get_keyword_search_posts | Get raw posts from a keyword search |
get_user_search_posts | Get raw posts from a user search |
list_agent_runs | List Rolli Agent runs (AI-driven social intelligence investigations) |
start_agent_run | Start a Rolli Agent investigation and return the markdown report when complete |
get_agent_run | Get a Rolli Agent run by ID (progress while running, full report when complete) |
cancel_agent_run | Cancel a pending or running Rolli Agent run |
rerun_agent_run | Retry a failed, waiting, or stuck Rolli Agent run |
update_agent_run | Pin or rename a Rolli Agent run |
delete_agent_run | Soft-delete a completed or failed Rolli Agent run |
list_agent_schedules | List Rolli Agent scheduled reports |
create_agent_schedule | Create a recurring Rolli Agent report (daily/weekly/monthly/once) |
get_agent_schedule | Get a Rolli Agent schedule with its 10 most recent runs |
update_agent_schedule | Update a Rolli Agent schedule |
delete_agent_schedule | Permanently delete a Rolli Agent schedule |
pause_agent_schedule | Pause a Rolli Agent schedule |
resume_agent_schedule | Resume a paused Rolli Agent schedule |
list_agent_schedule_runs | List the full execution history of a Rolli Agent schedule |
get_integration_setup | Get current integration settings (webhook URL, name) |
update_integration_setup | Set the webhook URL for search completion notifications |
get_usage | Get API usage data and per-user breakdowns |
Setup
You need a Rolli account with API access. Get your API token from rolli.ai.
Claude Desktop / Claude Code / VS Code / Cursor / Windsurf
Add to your MCP config (claude_desktop_config.json, .vscode/mcp.json, or equivalent):
{"mcpServers": { "rolli": { "command": "npx", "args": ["-y", "@rolli/mcp"], "env": { "ROLLI_API_TOKEN": "your_token" } } } }
ROLLI_USER_ID is optional and defaults to "rolli-mcp". Set it to override with your own user ID.
Optional Environment Variables
| Variable | Default | Description |
|---|---|---|
ROLLI_USER_ID | "rolli-mcp" | User ID sent with API requests |
ROLLI_POLL_INTERVAL_MS | 5000 | Polling interval (ms) when waiting for search results |
ROLLI_MAX_POLL_MS | 600000 | Max time (ms) to wait before search timeout (default: 10 min) |
ROLLI_MAX_RESPONSE_BYTES | 140000 | Max tool-response size in bytes; larger responses are trimmed (truncated: true). claude.ai and Claude Desktop accept ~150,000 characters per tool result, so keep it under that |
Smithery
This server includes a smithery.yaml for deployment via Smithery. It will prompt for your API token during setup.
Usage Examples
Search for a keyword across social media:
"Search for posts about 'artificial intelligence' on Twitter and Reddit from the last week"
Analyze a user profile:
"Look up @elonmusk on Twitter and analyze their recent posts"
Get topic breakdown:
"Show me the topic tree for my keyword search #123"
Check API usage:
"How many searches have I used this month?"
Set up a webhook:
"Set my webhook URL to https://myapp.com/rolli-callback"
Optional X/Twitter Source Context
Rolli is useful for cross-platform social search, topic trees, user analysis, and scheduled social intelligence reports. If an agent also needs reviewed account-scoped X/Twitter source evidence before a Rolli investigation, collect that evidence in an approved OpenClaw workflow such as TweetClaw, then pass only the reviewed handles, post URLs, post IDs, excerpts, or summary notes into Rolli prompts.
Keep Rolli and TweetClaw credentials separate. Do not transfer API tokens, cookies, sessions, or account credentials between tools. Treat TweetClaw output as source context for Rolli searches and reports, not as publishing approval.
Development
npm cinpm run lint # ESLint npm run build # TypeScript npm test # Vitest
CI runs on every push and PR to master. Releases published on GitHub automatically publish to npm (requires NPM_TOKEN repo secret).
License
MIT