web-research-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DEFAULT_TTL_DAYS | No | TTL for non-version-locked entries | 30 |
| EMBEDDINGS_ENABLED | No | vector search (post-MVP) | 0 |
| WEB_RESEARCH_DB_PATH | No | DB location (global — reused across projects) | ~/.web-research-mcp/research.db |
| WEB_RESEARCH_AUTO_UPDATE | No | advertise updates so the host auto-delegates them; set 0 to disable | 1 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_treeC | Cached hierarchy tech -> version -> topics (names + flags, no content). |
| check_referenceB | Cheap existence/freshness check. No content. Omit version for the latest. |
| get_referenceA | Full cached doc for a slug. Optional section returns one heading block. |
| search_referenceA | Full-text search over cached references when the exact topic is unknown. |
| save_researchB | Store host-researched docs. Supersedes older versions atomically. Only tech/topic/summary/content are required. Omit version for a general (not version-bound) reference; status_tag defaults to "current". Response includes |
| invalidate_referenceC | Force a reference stale so the next check advises re-research. |
| check_for_updateA | Whether a newer server version exists on GitHub. If update_available, the host should delegate a background agent to run
the returned |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose: server version checking, reference existence/content/invalidation, hierarchy listing, research saving, and full-text search. There is no overlap or ambiguity.
All tool names follow a consistent verb_noun pattern with underscores: check_for_update, check_reference, get_reference, invalidate_reference, list_tree, save_research, search_reference. No deviations or mixed conventions.
With 7 tools, the count is well-scoped for a web research server. It covers all essential operations without being excessive or insufficient.
The tool set covers create (save_research), read (get_reference), search (search_reference), list (list_tree), and update/invalidate (invalidate_reference). A possible gap is the lack of a true delete operation, but invalidate serves a similar purpose. Overall, the surface is nearly complete for its domain.