A server for performing deep web searches using the @just-every/search library, requiring API keys via an environment file.
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.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.env
Option B: Use an existing .env
file (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
Add to your MCP configuration:
{
"mcpServers": {
"deep-search": {
"command": "npx",
"args": ["-y", "@just-every/mcp-deep-search"],
"env": {
"ENV_FILE": "/path/to/.llm.env"
}
}
}
}
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)Provider | API Key Required | Description |
---|---|---|
brave | BRAVE_API_KEY | Privacy-first search with structured results |
anthropic | ANTHROPIC_API_KEY | Deep multi-hop research |
openai | OPENAI_API_KEY | ChatGPT-grade contextual search |
google | GOOGLE_API_KEY | Gemini grounding search |
sonar / sonar-pro | OPENROUTER_API_KEY | Perplexity search variants |
xai | XAI_API_KEY | Real-time Grok search |
# 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
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 -e
for 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:
claude mcp list
Debug Mode: For detailed error messages, run manually:
ENV_FILE=/path/to/.env npx @just-every/mcp-deep-search
The MCP server includes automatic restart capability by default for improved reliability:
For development/debugging without auto-restart:
# Run directly without restart wrapper
npm run serve:dev
MIT © Just Every
Search the web using Kagi's search API
An enhanced MCP server for SearXNG web searching, utilizing a category-aware web-search, web-scraping, and includes a date/time retrieval tool.
Search for IP addresses using Chaitin's IP Intelligence API.
Google News search capabilities with automatic topic categorization and multi-language support via SerpAPI integration.
Fetch, convert, and search AWS documentation pages, with recommendations for related content.
Provides AI assistants with direct access to Mastra.ai's complete knowledge base.
Best people search engine that reduces the time spent on talent discovery.
A Model Context Protocol (MCP) server providing access to Google Programmable Search Engine (PSE) and Custom Search Engine (CSE).
Search for npm packages
Search engine for AI agents (search + extract) powered by Tavily