Connector overview
The same Rolli IQ tools you already use, now available directly inside your AI conversation.
Works with Claude.ai (web), Claude Desktop, and any MCP-compatible client. ChatGPT support coming soon.
Secure OAuth 2.0 with PKCE S256 — no API keys to manage or leak.
Uses your existing Rolli IQ subscription. No additional cost.
12 tools covering keyword search, user search, topic analysis, integration settings, and usage reporting.
Revoke access anytime from your AI client's connector settings or directly in Rolli IQ.
What you can ask your AI assistant
Once connected, the AI assistant treats Rolli IQ tools like any other capability — you ask in natural language and it picks the right tools, passes the right arguments, and synthesizes the response. A few examples of prompts that work well:
“Run a keyword search for 'Brazil election' on X and Reddit for the past week and summarize the top 3 emerging themes.”
“Search for 'climate hoax' across X, Reddit, and Bluesky for the last 7 days, then pull the topic tree and flag any clusters that look like coordinated amplification.”
“Run a user search on the @nytimes Instagram profile for the past month, then show me the 5 most engaged posts and describe the narrative patterns.”
“How many Rolli IQ searches did my team run this month, broken down by user?”
Supported social platforms: X (Twitter), Reddit, YouTube, Facebook, Instagram, Threads, Bluesky, and more.
Install in Claude.ai (web)
Estimated time: under two minutes.
- Sign in at https://claude.ai.
- Open Settings → Connectors (or Profile → Connectors depending on UI version).
- Click Add custom connector.
- Paste the MCP server URL:
https://mcp.rolli.ai/mcp - Click Connect. A browser tab opens to authorize with Rolli IQ.
- Sign in to your Rolli IQ account and grant the requested scopes (
read write). - You’re redirected back to Claude.ai. The 12 Rolli IQ tools are now available in your conversations.
If the tools don’t appear immediately, reload the Claude tab — tool lists are fetched on first connection.
Install in Claude Desktop
Claude Desktop supports custom remote MCP servers via the same Settings → Connectors flow as Claude.ai. Paste the same URL:
https://mcp.rolli.ai/mcpIf your version of Claude Desktop only supports local MCP servers viaclaude_desktop_config.json, follow Anthropic’s official MCP configuration guide and point at the same remote URL using an MCP HTTP client entry. The OAuth flow is identical — you’ll complete it in your default browser and return to the desktop app.
Install in ChatGPT
Native MCP connector support in ChatGPT is rolling out gradually. As OpenAI enables custom MCP servers on your account, you’ll be able to add the same URL:
https://mcp.rolli.ai/mcpIn the meantime, the connector works with any MCP-compatible client that supports OAuth 2.0 authorization code + PKCE. If you’d like us to ping you the moment ChatGPT support is live, get in touch and we’ll add you to the notify list.
Authentication & permissions
The connector uses standard OAuth 2.0 with PKCE S256 and Dynamic Client Registration (RFC 7591). In plain English, here’s what happens when you click Connect:
- You’re redirected to a standard Rolli IQ consent screen in your browser.
- The connector requests
read writescope — the same level your Rolli IQ web app uses. - You sign in to Rolli IQ (the connector never sees your password).
- Your Rolli access token is stored encrypted at rest on Cloudflare Workers, using per-grant AES-256-GCM wrapped with the issued MCP session token.
- Your AI client receives only its own MCP session token — it never sees your raw Rolli credentials.
OAuth discovery endpoint: https://mcp.rolli.ai/.well-known/oauth-authorization-server
Revoke access any time from your AI client’s connector settings or directly inside Rolli IQ. Revocation is immediate.
What's included — 12 tools
All 12 Rolli IQ tools below are available once the connector is authorized. Read-only tools never mutate state; write tools create or update resources on your Rolli IQ account.
| Tool | Title | Purpose | R/W |
|---|---|---|---|
list_keyword_searches | List Keyword Searches | Paginated list of keyword searches | Read |
keyword_search | Create Keyword Search | Create a new keyword/hashtag search across 8+ platforms | Write |
get_keyword_search | Get Keyword Search | Retrieve results for a specific keyword search by ID | Read |
list_user_searches | List User Searches | Paginated list of user profile searches | Read |
user_search | Create User Search | Create a new user profile search on Twitter/Facebook/Instagram | Write |
get_user_search | Get User Search | Retrieve results for a specific user search by ID | Read |
get_topic_tree | Get Topic Tree | Conversation topic taxonomy for a keyword search | Read |
get_keyword_search_posts | Get Keyword Search Posts | Raw posts from a keyword search | Read |
get_user_search_posts | Get User Search Posts | Raw posts from a user profile search | Read |
get_integration_setup | Get Integration Setup | Current webhook URL and integration settings | Read |
update_integration_setup | Update Integration Setup | Update webhook URL for search-complete notifications | Write |
get_usage | Get API Usage | API usage statistics and per-user breakdowns | Read |
Supported social platforms across these tools: X (Twitter), Reddit, YouTube, Facebook, Instagram, Threads, Bluesky, and more.
Rate limits
- 30 tool calls per minute per Rolli user.
- 1,000 tool calls per day per Rolli user.
- These limits are in addition to, not a replacement for, your Rolli IQ plan’s API quota.
If you need higher limits for enterprise use, contact [email protected].
Security & privacy at a glance
- OAuth 2.0 with PKCE S256 for all authentication flows.
- TLS 1.2+ for all traffic to and from
mcp.rolli.ai. - Per-grant AES-256-GCM encryption of stored tokens on Cloudflare Workers KV.
- Prompt-injection defense: tools returning social media content prepend an “untrusted content” notice to the AI.
- No tool response content is persisted by the connector — every response is fetched live per request.
Full details: MCP Privacy Policy · MCP Terms of Service
Troubleshooting
I don't see the tools after adding the connector.
Restart your AI client (or reload the Claude.ai tab). Tool lists are fetched on first connection and cached by the client.
OAuth redirects but nothing happens.
Make sure you're signed into Rolli IQ in the same browser window before starting the flow. Then try again.
"invalid_client" error on authorization.
Contact [email protected] — this usually means there's a configuration issue on our end that we'll fix quickly.
"Rate limit exceeded" error.
You've hit the 30/min or 1,000/day limit. Retry after the reset time shown in the error message.
Still stuck? Email [email protected] — we respond within one business day.