MCP Deep Search
Provides privacy-first web search with structured results through the Brave Search API
Provides web search capabilities through DuckDuckGo's search service
Enables Gemini grounding search for web queries through Google's API
Provides ChatGPT-grade contextual web search using OpenAI's search capabilities
Enables web search through Perplexity's Sonar and Sonar Pro search variants via OpenRouter
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Deep Search research the latest quantum computing breakthroughs"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Deep Search
MCP server for deep web search using @just-every/search. Search across multiple providers including Google, Bing, Brave, DuckDuckGo, Perplexity, and more.
Quick Start
1. Create or use an environment file
Option A: Create a new .llm.env file in your home directory:
# Download example env file
curl -o ~/.llm.env https://raw.githubusercontent.com/just-every/mcp-deep-search/main/.env.example
# Edit with your API keys
nano ~/.llm.envOption B: Use an existing .env file (must use absolute path):
# Example: /Users/yourname/projects/myproject/.env
# Example: /home/yourname/workspace/.env2. Install
Claude Code
# Using ~/.llm.env
claude mcp add deep-search -s user -e ENV_FILE=$HOME/.llm.env -- npx -y @just-every/mcp-deep-search
# Using existing .env file (absolute path required)
claude mcp add deep-search -s user -e ENV_FILE=/absolute/path/to/your/.env -- npx -y @just-every/mcp-deep-search
# For debugging, check if ENV_FILE is being passed correctly:
claude mcp listOther MCP Clients
Add to your MCP configuration:
{
"mcpServers": {
"deep-search": {
"command": "npx",
"args": ["-y", "@just-every/mcp-deep-search"],
"env": {
"ENV_FILE": "/path/to/.llm.env"
}
}
}
}Related MCP server: MCP MixSearch
MCP Tools
deep_search
Perform web searches using a specific provider.
Parameters:
query(required): The search queryprovider: Search provider (default: brave)maxResults: Maximum results (default: 10)includeAnswer: Include AI answer if available (default: false)
comprehensive_research
Perform comprehensive research using AI agents that intelligently select and query multiple search engines.
Parameters:
query(required): The research topicmodelClass: AI model class (default: reasoning_mini)
Search Providers
Provider | API Key Required | Description |
|
| Privacy-first search with structured results |
|
| Deep multi-hop research |
|
| ChatGPT-grade contextual search |
|
| Gemini grounding search |
|
| Perplexity search variants |
|
| Real-time Grok search |
CLI Usage
# Basic search
mcp-deep-search search "your query"
# Search with specific provider
mcp-deep-search search "your query" -p brave
# Get more results
mcp-deep-search search "your query" -n 20Troubleshooting
MCP Server Shows "Failed" in Claude
If you see "deep-search ✘ failed" in Claude, check these common issues:
Missing API Keys: The most common issue is missing API keys. Check that your ENV_FILE is properly configured:
# Test if ENV_FILE is working ENV_FILE=/path/to/your/.env npx @just-every/mcp-deep-search search "test"Incorrect Installation Command: Make sure you're using
-efor environment variables:# Correct - environment variable passed with -e flag before -- claude mcp add deep-search -s user -e ENV_FILE=$HOME/.llm.env -- npx -y @just-every/mcp-deep-search # Incorrect - trying to pass as argument claude mcp add deep-search -s user -- npx -y @just-every/mcp-deep-search --env ENV_FILE=$HOME/.llm.envPath Issues: ENV_FILE must use absolute paths:
# Good ENV_FILE=/Users/yourname/.llm.env ENV_FILE=$HOME/.llm.env # Bad ENV_FILE=.env ENV_FILE=~/.llm.env # ~ not expanded in some contextsVerify Installation: Check your MCP configuration:
claude mcp listDebug Mode: For detailed error messages, run manually:
ENV_FILE=/path/to/.env npx @just-every/mcp-deep-search
Getting API Keys
Brave: brave.com/search/api
Anthropic: console.anthropic.com
OpenAI: platform.openai.com
Google: makersuite.google.com
OpenRouter: openrouter.ai
xAI: x.ai
Auto-Restart Feature
The MCP server includes automatic restart capability by default for improved reliability:
Automatically restarts the server if it crashes
Handles unhandled exceptions and promise rejections
Implements exponential backoff (max 10 attempts in 1 minute)
Logs all restart attempts for monitoring
Gracefully handles shutdown signals (SIGINT, SIGTERM)
For development/debugging without auto-restart:
# Run directly without restart wrapper
npm run serve:devLicense
MIT © Just Every
Available Tools
2 toolscomprehensive_researchARead-only
Perform in-depth research on complex topics using AI agents that automatically search multiple sources, analyze findings, and compile comprehensive reports. Ideal for thorough investigations, market research, technical analysis, or any topic requiring deep understanding from multiple perspectives.
Inputs: query (required), modelClass.
deep_searchARead-only
Perform deep web searches to find current information, research topics, or answer questions using real-time data from multiple search providers. Use this when you need up-to-date information beyond your knowledge cutoff.
Inputs: query (required), provider, maxResults, includeAnswer.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have overlapping purposes, both focused on research and searching for information, with 'comprehensive_research' emphasizing analysis and reports and 'deep_search' focusing on real-time data. The boundaries are unclear, as an agent might struggle to choose between them for tasks like market research or technical analysis, leading to potential misselection.
The tool names use a consistent snake_case pattern, but they lack a predictable verb_noun structure. 'comprehensive_research' uses an adjective-noun format, while 'deep_search' uses an adjective-noun format as well, but the verbs are implied rather than explicit, making it readable but not fully consistent in action-oriented naming.
With only 2 tools, the server feels thin for a domain like 'Deep Search' that implies broad research capabilities. This limited set may not adequately cover the scope, as it lacks tools for specific operations like filtering results, saving reports, or handling different data types, making it borderline too few for the apparent purpose.
There are significant gaps in the tool surface for a research domain. The server lacks essential operations such as retrieving saved reports, updating research parameters, deleting old data, or managing search sessions. This incompleteness will likely cause agent failures when trying to perform end-to-end research workflows.
Maintenance
Related MCP Connectors
Real-time web and scholarly search with cited answers and multi-step deep research.
8-tool AI web intelligence suite: search, scrape, screenshot, SEO, docs, crypto, code.
Multi-engine web and platform search, news, Google Maps places, page reading, sitemaps, and trends.
Agent-native search engine with live web research optimized for AI agents.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides privacy-focused web search capabilities through SearXNG metasearch engine, enabling web, image, video, and news searches without tracking. Includes comprehensive research tools that aggregate and analyze results from multiple search engines.34MIT
- AlicenseAqualityCmaintenanceEnables advanced web search across multiple search engines (Brave, DuckDuckGo, Google, Bing, Yandex) with intelligent backend selection, full content extraction, and advanced filtering by time, language, geography, and content type.3MIT
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive web research through multi-engine search, intelligent website crawling, content analysis, trends data exploration, and automated research workflows with anti-detection measures and rich snippet detection.140MIT
- AlicenseCqualityBmaintenanceEnables unified web search across multiple providers (AnySearch, SearXNG, Tavily) and deep research via DeepSeek's web_search_20250305 tool, with optional OpenRouter reranking for improved result ordering.22MIT