desearch-mcp-server

Desearch MCP Server

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 📋

• An Desearch API Key
• Node.js (v18 or higher)
• Claude Desktop installed
• Cursor IDE

Installation 🛠️

NPM Installation

npm install -g desearch-mcp-server

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:

• Completely quit Cursor IDE
• 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:

• Open your Claude Desktop config:

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

For Windows:

• 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:

• Completely quit Claude Desktop
• Start Claude Desktop again
• You can verify the server by checking status in Settings > Developer > desearch

Troubleshooting 🔧

Common Issues

• Server Not Found

  • Check Claude or Cursor Desktop configuration syntax
  • Ensure Node.js is installed

• 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

• 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"