Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LOG_MODENoLogging mode: local or prod.local
MCP_NAMENoServer name advertised to clients.mcp-retrieval
MCP_PATHNoHTTP route (http transport only)./mcp
MAX_IMAGESNoMaximum number of images per query.10
PROXY_HOSTNoProxy host. If set, all proxy credentials are required.
PROXY_PORTNoProxy port. Required when PROXY_HOST is set.
MAX_QUERIESNoMaximum number of queries/URLs per call.10
MAX_RESULTSNoMaximum number of search results per query.20
MCP_VERSIONNoServer version advertised to clients.0.1.0
PROXY_LOGINNoProxy login. Required when PROXY_HOST is set.
SERVER_PORTNoHTTP server port (http transport only).8080
PROXY_SCHEMENoProxy scheme. Required when PROXY_HOST is set.
MCP_TRANSPORTNoTransport: stdio or http.stdio
DEFAULT_IMAGESNoDefault number of images per query.5
MAX_TIMEOUT_MSNoMaximum timeout in milliseconds.10000
MIN_TIMEOUT_MSNoMinimum timeout in milliseconds.1000
PROXY_PASSWORDNoProxy password. Required when PROXY_HOST is set.
DEFAULT_RESULTSNoDefault number of search results per query.5
DEFAULT_TIMEOUT_MSNoDefault timeout in milliseconds.5000
MAX_DOCUMENT_CHARSNoMaximum characters for scraped pages.20000
SERVER_READ_TIMEOUTNoHTTP server read timeout.60s
SERVER_WRITE_TIMEOUTNoHTTP server write timeout.60s
DEFAULT_DOCUMENT_CHARSNoDefault maximum characters for scraped pages.20000
MAX_IDLE_CONNS_PER_HOSTNoHTTP connection pooling.100

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

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
web_scrapeA

Downloads pages by their links and returns the main text as markdown. Use this to read a page in full after 'web_search' found it; snippets alone are often not enough. Links are fetched in parallel, up to 10 per call, so batch all links into one call.

Size: 'max_chars' is a per-page character limit (not tokens). A page cut short ends with '[truncated]' and has 'truncated' set; the rest cannot be fetched afterwards.

Results are reported per URL with a 'status' field (success, failed or timeout). A failed URL does not fail the others; the call errors only if every URL fails. Target sites may block or rate-limit the request, which shows up as a failed URL.

web_searchA

Searches the web for one or more queries and returns snippets with links. Queries run in parallel. IMPORTANT: Always write search queries in English for best results and relevance. Use this to find sources; then call 'web_scrape' to read a full page, or 'web_search_images' when you need pictures (both can be called in the same turn).

Freshness: set the 'date' field to restrict results by recency - 'd' (past day), 'w' (past week), 'm' (past month), 'y' (past year). Use it to prefer the most recent pages when the user asks about news or anything time-sensitive; leave it empty for all time.

Query operators (put them inside the query string itself): 'site:example.com term' limits the search to one site; 'filetype:pdf term' restricts to a file type; double quotes "exact phrase" force an exact match; a leading '-' excludes a word (term -foo); 'intitle:term' requires the word in the page title. Operators can be combined, e.g. 'site:arxiv.org filetype:pdf transformers'.

Results are reported per query with a 'status' field (success, failed or timeout). A failed query does not fail the others; the call errors only if every query fails. The upstream search engines may rate-limit or block requests, which shows up as a failed or timed-out query - retry later or rephrase.

web_search_imagesA

Searches for images by one or more queries, executed in parallel. IMPORTANT: Queries must be in English ONLY. Use this only when you need pictures; use 'web_search' for text answers and links, and 'web_scrape' to read a page.

Freshness: set the 'date' field to restrict results by recency - 'd' (past day), 'w' (past week), 'm' (past month), 'y' (past year); leave it empty for all time.

Query operators can be embedded in the query string: 'site:example.com term' limits to one site, double quotes "exact phrase" force an exact match, and a leading '-' excludes a word.

Results are reported per query with a 'status' field (success, no relevant, failed or timeout). A failed query does not fail the others; the call errors only if every query fails. The upstream image search may rate-limit or block requests, which shows up as a failed or timed-out query.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.7/5.0

Scored across 3 tools

Disambiguation5/5

Each tool targets a distinct modality+action: text search, image search, and full-page fetching. The descriptions explicitly cross-reference each other ('use web_search for text, web_scrape to read a page'), leaving no realistic chance of misselection.

Naming Consistency5/5

All three names follow the same snake_case verb_noun pattern sharing the 'web_' prefix (web_search, web_search_images, web_scrape). The shared prefix makes the family immediately recognizable while the distinguishing suffix stays descriptive.

Tool Count5/5

Three tightly scoped tools for a retrieval-only server; none is redundant and no filler exists. Search-text, search-images, and scrape cover the full surface without bloat.

Completeness4/5

The retrieve-then-read workflow is fully supported, with batching, truncation signaling, and per-URL status handling. Minor gaps remain (no structured/raw fetch beyond markdown extraction, no crawl or sitemap traversal), but agents can work around these via repeated scrape calls.

Maintenance

ActivityMaintained
ResponsivenessSlow