MCP Deep Search
About
A server for performing deep web searches using the @just-every/search library, requiring API keys via an environment file.
Details
- Author
- just-every
- Categories
- Search, Other, API
Jump to
Setup
Install MCP Deep Search in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/just-every/mcp-deep-search
Follow the installation instructions in the repository README, then restart your MCP client.
MCP server for deep web search using@just-every/search. Search across multiple providers including Google, Bing, Brave, DuckDuckGo, Perplexity, and more.
Option A: Create a new.llm.envfile 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.env
Option B: Use an existing.envfile (must use absolute path):
# Example: /Users/yourname/projects/myproject/.env # Example: /home/yourname/workspace/.env
# 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 list
{ "mcpServers": { "deep-search": { "command": "npx", "args": ["-y", "@just-every/mcp-deep-search"], "env": { "ENV_FILE": "/path/to/.llm.env" } } } }
Perform web searches using a specific provider.
- query(required): The search query
- provider: Search provider (default: brave)
- maxResults: Maximum results (default: 10)
- includeAnswer: Include AI answer if available (default: false)
Perform comprehensive research using AI agents that intelligently select and query multiple search engines.
- query(required): The research topic
- modelClass: AI model class (default: reasoning_mini)
# 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 20
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.env
Path 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 contexts
Verify Installation: Check your MCP configuration:
Debug Mode: For detailed error messages, run manually:
ENV_FILE=/path/to/.env npx @just-every/mcp-deep-search
- Brave:brave.com/search/api
- Anthropic:console.anthropic.com
- OpenAI:platform.openai.com
- Google:makersuite.google.com
- OpenRouter:openrouter.ai
- xAI:x.ai
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:dev
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
Search the web using Kagi's search API
Multi-provider search broker for AI agents. Routes across SearXNG, Brave, Serper, Tavily, and Exa with automatic fallback, RRF ranking, content extraction, and budget enforcement.
A search server for the Model Context Protocol (MCP) that uses the Baidu Wenxin API.
Perform web, news, and image searches using the Microsoft Bing Search API.
An MCP server for web and local search using the Brave Search API.
Integrates the Brave Search API for both web and local search capabilities. Requires a BRAVE_API_KEY.
An MCP server for the Brave Search API, providing web and local search capabilities via a streaming SSE interface.
An MCP server for the Brave Search API, providing both web and local search capabilities.
Search for cocktail recipes using the cezzis.com API.
Free search API for AI agents — 105 engines, 22 profiles, 94.3% SimpleQA accuracy, MCP server with 5 tools
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
