Rolli MCP Server

The Rolli MCP Server exposes the full Rolli Experts & IQ API through the Model Context Protocol (MCP), enabling ChatGPT, Cursor, or any MCP-enabled client to perform expert searches and social intelligence queries without manually issuing HTTP requests.

What is the Rolli MCP Server?

MCP (Model Context Protocol) allows tools to run directly inside ChatGPT or other AI-powered development environments. The Rolli MCP Server wraps all Rolli API endpoints into MCP tools, enabling you to:

Submit expert searches
Run keyword-based social media searches
Run user-based social media searches
Fetch posts, analytics, topic trees, and more

Each tool corresponds to an API endpoint, and for all submit search tools, the MCP returns the full results immediately, equivalent to calling:

GET /api/search/{id}

GET /api/iq/keyword_search/{id}

The MCP abstracts away polling—so you receive complete data when the search finishes.

Adding the Rolli MCP to AI Clients

Add this to your MCP config:

{
  "mcpServers": {
    "rolli-mcp": {
      "type": "streamable-http",
      "url": "https://rolli-mcp.fastmcp.app/mcp",
      "headers": {
        "ROLLI_API_TOKEN": "YOUR_ROLLI_API_TOKEN",
        "ROLLI_API_USER": "YOUR_ROLLI_API_USER"
      }
    }
  }
}

Replace YOUR_ROLLI_API_TOKEN and YOUR_ROLLI_API_USER with your provided credentials. You can rotate the token at any time.

Authentication

Requests made through the MCP Server automatically include the correct authentication headers for the API. You do not need to manually set X-ROLLI-TOKEN or X-ROLLI-USER-ID.

Your MCP client forwards the Rolli's authorization headers into the server:

X-ROLLI-TOKEN: YOUR_ROLLI_API_TOKEN

X-ROLLI-USER-ID: YOUR_ROLLI_API_USER

No other credentials are required.

Exposed Tools

The MCP server exposes the following tools, which map 1:1 to Rolli's API endpoints:

Expert Search Tools

submit_expert_search — submits a POST /api/search request and returns the full results
get_expert_search — GET /api/search/{id} to retrieve an Expert Search by ID
get_expert_searches — GET /api/search to list all Expert Searches

Rolli IQ – Keyword Search Tools

submit_keyword_search — submits a POST /api/iq/keyword_search request and returns the full results
get_keyword_search — GET /api/iq/keyword_search/{id} to retrieve a Keyword Search by ID
get_keyword_searches — GET /api/iq/keyword_search to list all Keyword Searches
get_keyword_search_topic_tree — GET /api/iq/keyword_search/{id}/topic_tree to fetch the topic tree for a Keyword Search
get_keyword_search_posts_data — GET /api/iq/keyword_search/{id}/posts_data to fetch posts data for a Keyword Search

Rolli IQ – User Search Tools

submit_user_search — submits a POST /api/iq/user_search request and returns full results
get_user_search — GET /api/iq/user_search/{id} to retrieve a User Search by ID
get_user_searches — GET /api/iq/user_search to list all User Searches
get_user_search_posts_data — GET /api/iq/user_search/{id}/posts_data to fetch posts data for a User Search

Integration Setup

You can manage and update your Rolli API integration settings through the MCP server. To update the webhook URL for Rolli API or view your integration setup, use the following tools:

Integration Setup Tools

get_integration_setup — retrieves the current integration setup information for your Rolli API
update_integration_setup — updates the integration setup, including the webhook URL

Usage Statistics

Monitor your usage statistics for the Rolli API through these tools:

Usage Tools

usage — gets the general usage statistics for your Rolli API account
get_usage_by_month — retrieves usage statistics by month for your Rolli API

Example Workflow in ChatGPT / Cursor

After adding the MCP, you can simply type:

"Search for experts in AI ethics"

ChatGPT will call:

submit_expert_search

For keyword-based social media searches, try:

"Analyze conversations about election integrity across Twitter and Reddit"

ChatGPT will call:

submit_keyword_search

For user-based searches, you can do:

"Find users discussing privacy laws on social media"

ChatGPT will call:

submit_user_search

You will receive full results when the search is completed.

Advantages of MCP vs REST API

No need for credentials in your code — only in MCP config
No polling — submit tools return full, completed results
Tools function like natural language actions
Ideal for ChatGPT Agents, Cursor workflows, and automation