MCP

    npm version

    The Desearch MCP server lets clients like Claude Desktop and Cursor run real-time Desearch AI search and X search. This page covers installation and configuration for both clients.

    Tools

    • AI Search: Real-time AI Twitter and web search with relevant links and a summary.
    • X Search: Real-time tweet search on X.

    Prerequisites

    Installation

    NPM

    bash
    npm install -g desearch-mcp-server

    Smithery

    To install for Claude Desktop via Smithery:

    bash
    npx -y @smithery/cli install @Desearch-ai/desearch --client claude

    For Cursor IDE:

    bash
    npx -y @smithery/cli install @Desearch-ai/desearch --client cursor

    Configuration

    Cursor IDE

    1. Open the command palette (Cmd+Shift+P or Ctrl+Shift+P) and search for Open MCP Settings. Click Add new global MCP server to open mcp.json.

    2. Add the Desearch server configuration:

    json
    { "mcpServers": { "desearch": { "command": "desearch-mcp-server", "env": { "DESEARCH_API_KEY": "your-api-key" } } } }

    Replace your-api-key with your API key from console.desearch.ai/api-keys.

    1. Quit Cursor IDE completely and start it again.

    Claude Desktop

    1. Open Claude Desktop and enable Developer Mode from the top-left menu bar. Then open Settings, go to the Developer option, and click Edit Config to open claude_desktop_config.json.

      Or open the file from a terminal:

      macOS:

      bash
      code ~/Library/Application\ Support/Claude/claude_desktop_config.json

      Windows:

      powershell
      code %APPDATA%\Claude\claude_desktop_config.json
    2. Add the Desearch server configuration:

    json
    { "mcpServers": { "desearch": { "command": "desearch-mcp-server", "env": { "DESEARCH_API_KEY": "your-api-key" } } } }

    Replace your-api-key with your API key from console.desearch.ai/api-keys.

    1. Quit Claude Desktop completely and start it again. Verify the server under Settings > Developer > desearch.

    Troubleshooting

    1. Server not found

      • Check the configuration syntax in Claude Desktop or Cursor
      • Ensure Node.js is installed
    2. API key issues

      • Confirm DESEARCH_API_KEY is valid
      • Check it is set correctly in the Cursor or Claude Desktop config
      • Make sure there are no spaces around the key
    3. Connection issues

      • Restart Claude Desktop or Cursor IDE completely
      • Check Claude Desktop logs:
      bash
      # macOS tail -n 50 -f ~/Library/Logs/Claude/mcp*.log # Windows type "%APPDATA%\Claude\logs\mcp*.log"