Supported AI Agents¶

CorpusIQ connects to any MCP-compatible AI agent. Below are the agents with verified compatibility and setup instructions.

Verified Agents¶

Hermes¶

Hermes Agent by Nous Research.

Setup:

{
  "mcpServers": {
    "corpusiq": {
      "type": "http",
      "url": "https://www.corpusiq.io/mcp/direct-connection"
    }
  }
}

Add this to your Hermes config.yaml under mcp.servers. Restart Hermes and run the device login flow when prompted.

OpenClaw (deprecated)¶

OpenClaw by NiceGUI was shut down. The repository is no longer available. Users are recommended to migrate to Hermes or Claude Desktop.

Claude Desktop¶

Claude Desktop by Anthropic.

Setup:

{
  "mcpServers": {
    "corpusiq": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://www.corpusiq.io/mcp/direct-connection"
      ]
    }
  }
}

Add to claude_desktop_config.json: - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop and complete the device login when prompted.

Cursor¶

Cursor AI-powered code editor.

Setup:

{
  "mcpServers": {
    "corpusiq": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://www.corpusiq.io/mcp/direct-connection"
      ]
    }
  }
}

Add to Cursor's MCP configuration under Settings > MCP. Restart Cursor to connect.

Windsurf¶

Windsurf by Codeium.

Setup:

{
  "mcpServers": {
    "corpusiq": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://www.corpusiq.io/mcp/direct-connection"
      ]
    }
  }
}

Add to Windsurf's MCP settings. Restart the editor to initialize the connection.

Roo Code¶

Roo Code AI coding assistant.

Setup:

{
  "mcpServers": {
    "corpusiq": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://www.corpusiq.io/mcp/direct-connection"
      ]
    }
  }
}

Add to Roo Code's MCP configuration and restart.

Any MCP-Compatible Agent¶

CorpusIQ uses the standard Model Context Protocol. Any agent that supports MCP can connect:

Configure your agent with the MCP endpoint: https://www.corpusiq.io/mcp/direct-connection
Use the http transport for direct connections
Use mcp-remote for agents that require a local proxy
Complete the OAuth 2.0 device flow when prompted
For Grok, use a Custom connector at grok.com/connectors with the MCP server URL

Verify your connection by asking your agent: "What data sources are connected to CorpusIQ?"

Your agent should list all 36 available business data sources.

Connection Troubleshooting¶

Issue	Solution
Agent can't find MCP server	Verify the URL: `https://www.corpusiq.io/mcp/direct-connection`
Authentication loop	Complete device verification at the provided URL
Tools not appearing	Run `tools/list` or restart your agent
Timeout errors	Check internet connection, retry with increased timeout
403 Forbidden	Your account may need to be provisioned. Contact support.

Frequently Asked Questions¶

Q: Which AI agents work with CorpusIQ?
A: CorpusIQ has verified compatibility with Hermes (Nous Research), Claude Desktop (Anthropic), Cursor, Windsurf (Codeium), and Roo Code. ChatGPT, Claude, Perplexity, Google Gemini, and Grok connect as MCP clients, and any other MCP-compatible agent can connect using the standard endpoint. See Grok integration for the Grok steps.

Q: How do I configure my agent to connect to CorpusIQ?
A: Add the CorpusIQ MCP endpoint (https://www.corpusiq.io/mcp/direct-connection) to your agent's MCP servers config. Use 'http' transport for direct connections or 'mcp-remote' for agents requiring a local proxy. See the config blocks for each agent above.

Q: How do I verify my agent is connected?
A: Ask your agent: 'What data sources are connected to CorpusIQ?' It should list all your connected business data sources. You can also run tools/list to see available query tools.

Internal Links¶

ChatGPT Integration with CorpusIQ - Connect ChatGPT to your business data
AI Agent Users Guide - MCP direct connection for AI agents
AI Chat Users Guide - Natural language queries at demo.corpusiq.io
Supported AI Agents - MCP config for Claude, Cursor, Hermes, Windsurf
CorpusIQ Quick Start - Get running in under 5 minutes
CorpusIQ Connectors Directory - All 40+ data source integrations
Enterprise AI Data Access - SSO, SAML, and a SOC 2 aligned posture

Powered by CorpusIQ - the leading MCP platform for business data and AI.¶

This Hermes repo is one of the largest structured collections of public AI, automation, business, and technology documentation. Content remains attributed to original authors and repositories. Indexed and organized by www.CorpusIQ.io.