Free Search MCP
A local-first Model Context Protocol server that enables LLMs to search the web, fetch pages, and read documents without requiring API keys. It supports multiple search engines like DuckDuckGo, Mojeek, and Startpage, includes a Playwright fallback for JavaScript-heavy pages, and uses an FTS5 cache for performance.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
Checks and signals
Each line is separate evidence, not a trust score.
- Popularity 171 GitHub stars
What you can do with it
- Search the web across multiple engines without API keys
- Fetch and clean up web pages for LLM consumption
- Read documents like PDFs and DOCX files
- Perform verified research by checking snippets against full page content
Source and maintenance
- Last repository push
- Latest release
- v0.18.0
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
free-search-mcp 0.18.0
{
"version": "0.18.0",
"transport": "stdio",
"identifier": "free-search-mcp",
"runtimeHint": "uvx",
"registryType": "pypi",
"environmentVariables": [
{
"name": "SEARCH_MCP_PROXY",
"description": "Optional outbound proxy URL (http://, https:// or socks5://) for engines that block your network."
},
{
"name": "SEARCH_MCP_REGION",
"description": "Optional default region-language for results, e.g. us-en, uk-en, cn-zh. Default: us-en."
},
{
"name": "SEARCH_MCP_CACHE_DIR",
"format": "filepath",
"description": "Optional directory for the local search/page cache. Default: ~/.cache/search-mcp."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · repository · passed · metadata changed · updated
- · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"free-search-mcp": {
"command": "uvx",
"args": [
"free-search-mcp==0.18.0"
],
"env": {
"SEARCH_MCP_PROXY": "<YOUR_SEARCH_MCP_PROXY>",
"SEARCH_MCP_REGION": "<YOUR_SEARCH_MCP_REGION>",
"SEARCH_MCP_CACHE_DIR": "<YOUR_SEARCH_MCP_CACHE_DIR>"
}
}
}
}Cline
{
"mcpServers": {
"free-search-mcp": {
"command": "uvx",
"args": [
"free-search-mcp==0.18.0"
],
"env": {
"SEARCH_MCP_PROXY": "<YOUR_SEARCH_MCP_PROXY>",
"SEARCH_MCP_REGION": "<YOUR_SEARCH_MCP_REGION>",
"SEARCH_MCP_CACHE_DIR": "<YOUR_SEARCH_MCP_CACHE_DIR>"
}
}
}
}VS Code
{
"servers": {
"free-search-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"free-search-mcp==0.18.0"
],
"env": {
"SEARCH_MCP_PROXY": "<YOUR_SEARCH_MCP_PROXY>",
"SEARCH_MCP_REGION": "<YOUR_SEARCH_MCP_REGION>",
"SEARCH_MCP_CACHE_DIR": "<YOUR_SEARCH_MCP_CACHE_DIR>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"free-search-mcp": {
"command": "uvx",
"args": [
"free-search-mcp==0.18.0"
],
"env": {
"SEARCH_MCP_PROXY": "<YOUR_SEARCH_MCP_PROXY>",
"SEARCH_MCP_REGION": "<YOUR_SEARCH_MCP_REGION>",
"SEARCH_MCP_CACHE_DIR": "<YOUR_SEARCH_MCP_CACHE_DIR>"
}
}
}
}Let your agent find its tools
Find servers like Free Search MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.