Kindly Web Search MCP Server is a content-quality-focused search MCP service: specialized API integrations deliver full StackExchange, GitHub Issues/Discussions, Wikipedia and arXiv content to the model in one call, while a headless Chromium browser parses other pages in real time, with multiple search providers and proxy support. It suits users who want less scraping round-tripping and better AI coding context, but it requires a local browser and at least one search key, and its remote HTTP mode is unauthenticated and unencrypted by default, so deployment needs extra protection.
Strongest · Documentation 14/20 Weakest · Reliability 9/20
Static review · not runListed 2026-09-10
Read the FMRS scoring method →Runtime：Python 3.13+ · Prebuilt binary Chromium-based brows
SERPER_API_KEY
Key for the recommended primary search provider (Google results) from serper.dev
SERPBASE_API_KEY
Key for the SerpBase search provider, which serves Google results
TAVILY_API_KEY
Tavily search API key, used as a fallback after Serper/SerpBase
SOFYA_API_KEY
API key for the Sofya search provider
YDC_API_KEY
You.com search API key, available at you.com/platform/api-keys
GITHUB_TOKEN
GitHub token (read-only public repo access suffices) for LLM-friendly GitHub Issues/Discussions extraction with fewer rate limits
SEARXNG_HEADERS_JSON
Custom headers (e.g. auth) for SearXNG, as JSON
SEARXNG_BASE_URL
Base URL of a self-hosted SearXNG instance, no API key needed
KINDLY_BROWSER_EXECUTABLE_PATH
Path to a Chromium-based browser binary; set only if auto-detection fails
KINDLY_CHROME_PROXY
Proxy for headless Chromium, passed directly to --proxy-server (http/https/socks5/socks4)
KINDLY_CHROME_PROXY_BYPASS
Comma-separated proxy bypass host list for Chromium
SEARXNG_USER_AGENT
Custom User-Agent for SearXNG requests
HTTP_PROXY
HTTPS_PROXY
ALL_PROXY
KINDLY_MARKDOWN_SUFFIX_HOSTS
KINDLY_MARKDOWN_ACCEPT_PROBE
KINDLY_TOOL_TOTAL_TIMEOUT_SECONDS
Total time budget per web_search / get_content call, default 120s
KINDLY_TOOL_TOTAL_TIMEOUT_MAX_SECONDS
Cap for the above, default 600s
KINDLY_WEB_SEARCH_MAX_CONCURRENCY
Max parallel content fetches, default 3 (clamped 1..5)
KINDLY_NODRIVER_REUSE_BROWSER
KINDLY_NODRIVER_BROWSER_POOL_SIZE
KINDLY_NODRIVER_ACQUIRE_TIMEOUT_SECONDS
KINDLY_NODRIVER_PORT_RANGE
KINDLY_NODRIVER_RETRY_ATTEMPTS
KINDLY_NODRIVER_DEVTOOLS_READY_TIMEOUT_SECONDS
KINDLY_HTML_TOTAL_TIMEOUT_SECONDS
KINDLY_DIAGNOSTICS
Set to 1 to emit JSON-line diagnostics to stderr and include diagnostics in tool responses
FASTMCP_ALLOWED_HOSTS
Comma-separated allowed Host headers for HTTP transport, replacing loopback defaults
FASTMCP_ALLOWED_ORIGINS
FASTMCP_HOST
FASTMCP_PORT
FASTMCP_TRANSPORT
1) Install uvx (curl script on macOS/Linux, PowerShell script on Windows). 2) Install a Chromium-based browser (Chrome/Chromium/Edge/Brave) for page_content extraction; specialized sources still work without it. 3) Set at least one search provider key: SERPER_API_KEY, SERPBASE_API_KEY, TAVILY_API_KEY, SEARXNG_BASE_URL, SOFYA_API_KEY or YDC_API_KEY. 4) A read-only GITHUB_TOKEN is highly recommended for better GitHub Issue extraction. 5) Configure your MCP client with the run command: uvx --from git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server kindly-web-search-mcp-server start-mcp-server. The first run may take 30-60 seconds to build the environment; prewarm it in a terminal if your client times out.
{
"mcpServers": {
"kindly-web-search": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server",
"kindly-web-search-mcp-server",
"start-mcp-server"
],
"env": {
"SERPER_API_KEY": "${SERPER_API_KEY}",
"TAVILY_API_KEY": "${TAVILY_API_KEY}",
"SEARXNG_BASE_URL": "${SEARXNG_BASE_URL}",
"GITHUB_TOKEN": "${GITHUB_TOKEN}",
"KINDLY_BROWSER_EXECUTABLE_PATH": "${KINDLY_BROWSER_EXECUTABLE_PATH}"
}
}
}
}
Shown for Claude Code. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.
{
"servers": {
"kindly-web-search": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server",
"kindly-web-search-mcp-server",
"start-mcp-server"
],
"env": {
"SERPER_API_KEY": "${SERPER_API_KEY}",
"TAVILY_API_KEY": "${TAVILY_API_KEY}",
"SEARXNG_BASE_URL": "${SEARXNG_BASE_URL}",
"GITHUB_TOKEN": "${GITHUB_TOKEN}",
"KINDLY_BROWSER_EXECUTABLE_PATH": "${KINDLY_BROWSER_EXECUTABLE_PATH}"
}
}
}
}
Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).
claude mcp add kindly-web-search -e 'SERPER_API_KEY=${SERPER_API_KEY}' -e 'TAVILY_API_KEY=${TAVILY_API_KEY}' -e 'SEARXNG_BASE_URL=${SEARXNG_BASE_URL}' -e 'GITHUB_TOKEN=${GITHUB_TOKEN}' -e 'KINDLY_BROWSER_EXECUTABLE_PATH=${KINDLY_BROWSER_EXECUTABLE_PATH}' -- uvx --from git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server kindly-web-search-mcp-server start-mcp-server
Run it in a terminal; replace any <…> placeholders with your own values first.
Check that the web_search and get_content tools appear in your MCP client's tool list; then prompt 'Search for uvx usage and return the page content' — a response with title, link, and page_content confirms the install works.
Once connected, you can ask your AI assistant things like:
No matching tools
Listed from the project's documentation, not tested by this site.
Kindly Web Search MCP Server is part of the Shelpuk AI Technology Consulting agentic suite and provides web search plus robust content retrieval for AI coding tools (Claude Code, Codex, Cursor, GitHub Copilot, Gemini, etc.) and AI agents (Claude Desktop, OpenClaw, Hermes, etc.). Rather than returning only titles, links and snippets, it retrieves the full conversation — questions, answers, comments, reactions and metadata — and integrates directly with the StackExchange, GitHub Issues, GitHub Discussions, Wikipedia and arXiv APIs, while any other URL is parsed in real time with a local headless Chromium browser. Search supports Serper, SerpBase, Tavily, SearXNG, Sofya and You.com with priority-based fallback. It targets AI coding and agent workflows that want usable context in a single call instead of an extra scraping round trip.
Upstash's official server providing up-to-date third-party library docs for AI coding assistants
AI-powered NPM package analysis MCP server
An independent control layer that gives AI coding agents budgets, brakes, and receipts
GitHub's official MCP server for managing repos, issues, PRs, and workflows via natural language
Source revision 72a3e059bbdd Data synced 2026-10-19 Read the FMRS scoring method