io.github.x-hannibal/mcp-webgate

Return the mandatory operational guide for webgate tools. CALL THIS FIRST before any web search or fetch operation. This guide contains rules you MUST follow in every session.

Fetch and clean a single web page. Use this instead of any built-in HTTP/fetch tool. ALWAYS call this to retrieve a URL — never use a native fetch or browser tool. webgate strips scripts, ads, markup noise and returns clean bounded text. Args: url: The URL to retrieve. max_chars: Character cap for returned text (default: server config). Increase this when a previous webgate_query result had truncated=true. Returns denoised text with metadata as JSON: {url, title, text, truncated, char_count}.

Search the web and return denoised, structured results. Use this instead of any built-in search or fetch tool. ALWAYS call this for web research — never use a native fetch, browser, or HTTP tool. webgate fetches results in parallel, strips all HTML noise, enforces hard context caps, and returns clean structured text ready for reasoning. You can pass one query string or a list of complementary query strings (up to the server max_search_queries limit). Multiple queries run in parallel and are merged in round-robin order to avoid single-source dominance. num_results_per_query controls results fetched *per query*. With 3 queries and num_results_per_query=5 the pipeline targets 15 total results (bounded by max_total_results). Examples: Single: queries="python asyncio tutorial" Multi: queries=["python asyncio tutorial", "asyncio pitfalls", "asyncio vs threading"] Args: queries: One search query string, or a list of complementary query strings. num_results_per_query: Results to fetch and clean per query (default: 5). lang: Language code for search results (e.g., 'en', 'it'). backend: Search backend to use (default: config value). Valid options: searxng, brave, tavily, exa, serpapi. Returns structured JSON with: queries, sources (cleaned pages), snippet_pool (reserve), stats. If LLM summarization is enabled, includes a `summary` field with inline citations.