Guide

MCP

npm version

A Model Context Protocol (MCP) server lets clients like Claude or Cursor use the Desearch AI for real-time AI X search and web search.

Tools

The Desearch MCP server includes the following tools:

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

Prerequisites 📋

Installation 🛠️

NPM Installation

npm install -g desearch-mcp-server

Using Smithery

To install the Desearch MCP server for Claude Desktop automatically via Smithery:

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

Or for Cursor IDE:

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

Configuration ⚙️

1. Configure Cursor IDE to run the Desearch MCP server

Open Cursor IDE, access command palette Cmd+Shift+P or Ctrl+Shift+P, and search for Open MCP Settings. Click on Add new global MCP server to open the mcp.json file.

2. Add the Desearch server configuration:

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

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

3. Restart Cursor IDE

For the changes to take effect:

  1. Completely quit Cursor IDE
  2. Start Cursor IDE again

1) Configure Claude Desktop to run the Desearch MCP server

Open the Claude Desktop app and enable Developer Mode from the top-left menu bar.

Once enabled, open Settings (also from the top-left menu bar) and navigate to the Developer Option, where you'll find the Edit Config button. Clicking it will open the claude_desktop_config.json file, allowing you to make the necessary edits.

OR (if you want to open claude_desktop_config.json from terminal)

For macOS:

  1. Open your Claude Desktop config:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

For Windows:

  1. Open your Claude Desktop configuration:
code %APPDATA%\Claude\claude_desktop_config.json

2. Add the Desearch server configuration:

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

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

3. Restart Claude Desktop

For the changes to take effect:

  1. Completely quit Claude Desktop
  2. Start Claude Desktop again
  3. You can verify the server by checking status in Settings > Developer > desearch

Troubleshooting 🔧

Common Issues

  1. Server Not Found

    • Check Claude or Cursor Desktop configuration syntax
    • Ensure Node.js is installed
  2. API Key Issues

    • Confirm your DESEARCH_API_KEY is valid
    • Check the DESEARCH_API_KEY is correctly set in the Cursor or Claude Desktop config
    • Verify that there are no spaces around the API key
  3. Connection Issues

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