Which integrations are available for this server?

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.

How do I use AtlasForge-WebProxy?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. 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.

AtlasForge-WebProxy

by DragonShadows1978

Overview Schema Related Servers Score Discussions

Python

Local

AtlasForge-WebProxy

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.

Quickstart

./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/health

Wire 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

Config

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
`BRAVE_API_KEY`	empty	Brave Search API key.
`ATLASFORGE_WEB_PROXY_HOST`	`127.0.0.1`	Flask bind host.
`ATLASFORGE_WEB_PROXY_PORT`	`8765`	Flask bind port.
`ATLASFORGE_WEB_PROXY_URL`	host/port above	MCP/client target URL.
`ATLASFORGE_WEB_PROXY_CACHE_DIR`	XDG cache	Search/fetch/image cache.
`ATLASFORGE_WEB_PROXY_PAPER_DIR`	XDG cache	Paper PDF/text artifacts.
`ATLASFORGE_WEB_PROXY_PROVIDER`	`auto`	`auto`, `brave`, `duckduckgo`, or `ddgs`.
`ATLASFORGE_WEB_PROXY_TIMEOUT_S`	`20`	Service outbound timeout.
`ATLASFORGE_WEB_PROXY_CLIENT_TIMEOUT_S`	`30`	Python client timeout.
`ATLASFORGE_WEB_PROXY_MCP_TIMEOUT_S`	`30`	MCP-to-service timeout.
`ATLASFORGE_WEB_PROXY_SEARCH_TTL_S`	`1800`	Search cache TTL.
`ATLASFORGE_WEB_PROXY_FETCH_TTL_S`	`86400`	Page fetch cache TTL.
`ATLASFORGE_WEB_PROXY_PAPER_TTL_S`	`604800`	Paper fetch cache TTL.
`ATLASFORGE_WEB_PROXY_RETRY_ATTEMPTS`	`3`	Fetch retry attempts.
`ATLASFORGE_WEB_PROXY_RETRY_BASE_S`	`0.5`	Retry base delay.
`ATLASFORGE_WEB_PROXY_RETRY_AFTER_MAX_S`	`60`	Max `Retry-After` delay.
`ATLASFORGE_WEB_PROXY_RETRY_JITTER`	`1`	Enable retry jitter.
`ATLASFORGE_WEB_PROXY_UA_RETRY_ON_403`	`1`	Retry 403 with browser UA.
`ATLASFORGE_WEB_PROXY_REDDIT_OLD_FALLBACK`	`1`	Try old.reddit fallback.
`WEB_PROXY_ALLOW_DNS_FAIL`	`0`	Legacy DNS fail-open mode.
`ATLASFORGE_WEB_PROXY_ENABLE_INVESTIGATION_CAPTURE`	`0`	Optional AtlasForge JSON mirroring.
`ATLASFORGE_WEB_PROXY_ENABLE_ATLASFORGE_TOOLS`	`0`	Optional AtlasForge stage tools.

See config.env.example for the full list, including user-agent and size-limit knobs.

systemd

./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

Tests

.venv/bin/python -m pip install -e ".[test]"
.venv/bin/python -m pytest

Use an unused non-8765 port for live smoke tests:

ATLASFORGE_WEB_PROXY_PORT=8799 .venv/bin/python -m atlasforge_webproxy.service --port 8799

Install Server

license - not found

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

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