Provides web search capabilities using the Brave Search API.
Offers fallback web search using DuckDuckGo (DDG/DDGS).
Includes old.reddit fallback for fetching Reddit pages with improved compatibility.
Click on "Install 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., "@AtlasForge-WebProxy search for SpaceX Starship updates"
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.
Self-hosted web search/fetch proxy plus stdio MCP server for AI agents. It provides Brave-backed search, page fetch with retries and browser-like user-agent fallback, old.reddit hardening, response caching, paper PDF fetch, image search/download, and SSRF guards.
./install.sh
mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}/atlasforge-webproxy"
$EDITOR "${XDG_CONFIG_HOME:-$HOME/.config}/atlasforge-webproxy/config.env"
chmod 600 "${XDG_CONFIG_HOME:-$HOME/.config}/atlasforge-webproxy/config.env"Set BRAVE_API_KEY in that file. Get a key at
https://brave.com/search/api/. Without a key, the proxy falls back to DDG/DDGS
where available.
Run directly:
.venv/bin/python -m atlasforge_webproxy.service --host 127.0.0.1 --port 8765
curl http://127.0.0.1:8765/healthWire MCP into a client:
{
"mcpServers": {
"atlasforge-web-proxy": {
"command": "/path/to/AtlasForge-WebProxy/.venv/bin/python",
"args": ["-m", "atlasforge_webproxy.mcp_server"],
"env": {}
}
}
}Related MCP server: Crawl4AI+SearXNG MCP Server
Priority: environment variables, then
${XDG_CONFIG_HOME:-~/.config}/atlasforge-webproxy/config.env, then defaults.
For migration, ~/.config/atlasforge/web-proxy.env is read only when the new
file does not exist, and a deprecation warning is logged.
Setting | Default | Purpose |
| empty | Brave Search API key. |
|
| Flask bind host. |
|
| Flask bind port. |
| host/port above | MCP/client target URL. |
| XDG cache | Search/fetch/image cache. |
| XDG cache | Paper PDF/text artifacts. |
|
|
|
|
| Service outbound timeout. |
|
| Python client timeout. |
|
| MCP-to-service timeout. |
|
| Search cache TTL. |
|
| Page fetch cache TTL. |
|
| Paper fetch cache TTL. |
|
| Fetch retry attempts. |
|
| Retry base delay. |
|
| Max |
|
| Enable retry jitter. |
|
| Retry 403 with browser UA. |
|
| Try old.reddit fallback. |
|
| Legacy DNS fail-open mode. |
|
| Optional AtlasForge JSON mirroring. |
|
| Optional AtlasForge stage tools. |
See config.env.example for the full list, including user-agent and size-limit
knobs.
./install.sh creates .venv, installs the package, copies
config.env.example if no config exists, installs
~/.config/systemd/user/atlasforge-webproxy.service, and runs
systemctl --user daemon-reload.
It does not enable or start the service unless passed --start:
./install.sh --start
systemctl --user status atlasforge-webproxy.service.venv/bin/python -m pip install -e ".[test]"
.venv/bin/python -m pytestUse an unused non-8765 port for live smoke tests:
ATLASFORGE_WEB_PROXY_PORT=8799 .venv/bin/python -m atlasforge_webproxy.service --port 8799Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
The best web search for your AI Agent
Reliable web access for AI agents: smart HTTP, rotating proxies, and full-browser rendering.
Web search for AI agents — one tool across 6 engines, routed to the cheapest + cached.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/DragonShadows1978/AtlasForge-WebProxy'
If you have feedback or need assistance with the MCP directory API, please join our Discord server