Skip to content

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

OpenClaw by NiceGUI.

Setup: 

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

Add to your OpenClaw configuration. Use OAuth device flow for authentication.

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:

  1. Configure your agent with the MCP endpoint: https://www.corpusiq.io/mcp/direct-connection
  2. Use the http transport for direct connections
  3. Use mcp-remote for agents that require a local proxy
  4. Complete the OAuth 2.0 device flow when prompted

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), OpenClaw (NiceGUI), Claude Desktop (Anthropic), Cursor, Windsurf (Codeium), and Roo Code. Any MCP-compatible agent can connect using the standard endpoint.

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.

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