Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MCP_HOSTNoServer host addresslocalhost
MCP_ONLYNoRun in MCP-only mode (true) or include REST API (false)
MCP_PORTNoServer port number3000
LOG_LEVELNoLogging levelINFO
BRAVE_API_KEYNoYour Brave API key for web search
MCP_TRANSPORTNoTransport mode: 'stdio' or 'http'stdio
MCP_AUTH_ENABLEDNoEnable authenticationtrue
MCP_CORS_ORIGINSNoComma-separated list of allowed CORS originshttp://localhost:3000,http://localhost:5173
MAX_CONTENT_LENGTHNoMaximum content length for extraction500000
MAX_CONCURRENT_REQUESTSNoMaximum number of concurrent requests5

Tools

Functions exposed to the LLM to take actions

NameDescription
full_web_search

Get comprehensive web search results with full page content extraction.

Use this when you need detailed content from web sources for comprehensive research and analysis. This searches the web and extracts the full content from each result page.

Use this for comprehensive research or detailed information from web sources.

Args: query: Search query string (1-200 characters) limit: Number of results to return with full content (1-10, default 5) include_content: Whether to extract full page content (default true) max_content_length: Maximum characters per result content (0 = no limit) top_n: Alternative name for limit (for compatibility) recency_days: Days to look back for recent content (time filtering) source: Content type filter ("news", "images", "videos", etc.) language: Language filter (e.g., "en", "es", "fr", "de") country: Geographic filter (e.g., "US", "GB", "FR", "DE")

Returns: Formatted text containing search results with full extracted content

Parameter Usage Guidelines

query (required)

  • Search query string (1-200 characters)

  • Use specific, descriptive search terms

limit (optional, default 5)

  • Range: 1-10 results

  • Higher limits take longer due to content extraction

include_content (optional, default true)

  • Set to true for full content extraction (default)

  • Set to false to get only titles, URLs, and descriptions

max_content_length (optional, default unlimited)

  • Limits characters per result to manage response size

  • Common values: 10000 (focused content), 50000 (detailed research), null (no limit)

top_n (optional, compatibility parameter)

  • Alternative name for limit parameter

  • Range: 1-10 results

recency_days (optional, time filtering)

  • Filters results to recent content only

  • Common values: 1 (past day), 7 (past week), 30 (past month), 365 (past year)

  • Use -1 or null for no time filter

source (optional, content type filtering)

  • Filters by content type

  • Supported values:

    • "news": News articles and current events

    • "images": Image search results

    • "videos": Video content

    • "web" or null: Regular web search (default)

language (optional, language filtering)

  • Filters results by language

  • Supported values: Language codes like "en", "es", "fr", "de", "zh"

country (optional, geographic filtering)

  • Filters results by geographic region/country

  • Supported values: Country codes like "US", "GB", "FR", "DE", "CA"

Usage Examples

Basic search with default settings:

{ "query": "sustainable energy solutions 2024" }

Quick overview (smaller limit):

{ "query": "latest AI developments", "limit": 3 }

Recent news search with time filtering:

{ "query": "AI technology breakthroughs", "source": "news", "recency_days": 7, "language": "en" }

Geographic and language filtering:

{ "query": "climate change policy", "country": "FR", "language": "fr", "limit": 5 }

Comprehensive research with all parameters:

{ "query": "machine learning frameworks comparison", "limit": 8, "include_content": true, "max_content_length": 25000, "recency_days": 30, "language": "en" }
{ "query": "python tutorial", "source": "videos", "limit": 5, "include_content": false }

Source identification only:

{ "query": "quantum computing breakthroughs", "limit": 5, "include_content": false }

When to Use This

  • Use when you need detailed content from multiple sources

  • Use for comprehensive research on complex topics

  • Use when analyzing and comparing information across sources

  • Use for gathering supporting evidence or documentation

  • Use when you need the full context from web pages

  • For quick topic exploration without content, use the search summaries functionality

  • When you have a specific URL to extract, use the single page content extraction functionality

get_web_search_summaries

Get lightweight web search results with only result summaries.

Use this when you need a quick overview of available sources without full content. This gets search result titles, URLs, and descriptions for quick research or when you only need an overview of available information.

Use this when you want to quickly understand what information is available on a topic before diving deeper with full content extraction.

Args: query: Search query string (1-200 characters) limit: Number of search result summaries to return (1-10, default 5) top_n: Alternative name for limit (for compatibility) recency_days: Days to look back for recent content (time filtering) source: Content type filter ("news", "images", "videos", etc.) language: Language filter (e.g., "en", "es", "fr", "de") country: Geographic filter (e.g., "US", "GB", "FR", "DE")

Returns: Formatted text containing search result summaries (title, URL, description)

Parameter Usage Guidelines

query (required)

  • Search query string (1-200 characters)

  • Use specific, descriptive search terms

limit (optional, default 5)

  • Range: 1-10 results

Usage Examples

Basic topic exploration:

{ "query": "artificial intelligence ethics" }

Quick source discovery:

{ "query": "kubernetes security best practices", "limit": 3 }

Recent news exploration:

{ "query": "AI developments", "source": "news", "recency_days": 7, "language": "en" }

Geographic research:

{ "query": "renewable energy policies", "country": "DE", "language": "en", "limit": 8 }

Content type discovery:

{ "query": "machine learning tutorials", "source": "videos", "limit": 5 }

Complete parameter example:

{ "query": "climate change adaptation strategies", "limit": 6, "recency_days": 30, "language": "en", "country": "US" }

When to Choose This Tool

Primary Decision Criteria:

  • Choose this for initial research phase: Understand what sources are available

  • Choose this for topic exploration: Get an overview before deep diving

  • Choose this for source identification: Find relevant URLs for later extraction

  • Choose this for quick fact-checking: Verify if information sources exist

  • Choose this for research planning: Identify the scope of available information

Decision Matrix: When to Use Each Tool

Use get_web_search_summaries when:

  • ✅ You need to explore what's available on a topic

  • ✅ You want to identify relevant sources quickly

  • ✅ You're doing preliminary research

  • ✅ You need to validate if sources exist

  • ✅ You want to see search result diversity

  • ✅ Speed is more important than content depth

Use full_web_search when:

  • ✅ You need actual content from sources

  • ✅ You're doing detailed research or analysis

  • ✅ You need to cite or reference specific information

  • ✅ You want to compare information across sources

  • ✅ Content depth is more important than speed

Use get_single_web_page_content when:

  • ✅ You have specific URLs to extract

  • ✅ You found relevant URLs from summaries

  • ✅ You need to extract from known sources

Workflow Patterns

Two-stage research:

  1. Use get_web_search_summaries to identify sources

  2. Use get_single_web_page_content on promising URLs

  3. Or use full_web_search with focused query

Topic mapping:

  1. Use get_web_search_summaries with broad terms

  2. Analyze result diversity and topics

  3. Use full_web_search for detailed investigation

Source validation:

  1. Use get_web_search_summaries to check if sources exist

  2. Evaluate source quality and relevance

  3. Proceed with content extraction if validated

get_single_web_page_content

Extract and return the full content from a single web page URL.

Use this when you have a specific URL and need the full text content for analysis or reference.

Args: url: The URL of the web page to extract content from max_content_length: Maximum characters for the extracted content (0 = no limit)

Returns: Formatted text containing the extracted page content with word count

Parameter Usage Guidelines

url (required)

  • Must be a valid HTTP or HTTPS URL

  • Include the full URL with protocol (http:// or https://)

  • Examples:

    • "https://example.com/article"

    • "https://docs.python.org/3/library/asyncio.html"

    • "https://github.com/user/repo/blob/main/README.md"

max_content_length (optional, default unlimited)

  • Limits the extracted content to specified character count

  • Common values: 10000 (summaries), 50000 (full pages), null (no limit)

Usage Examples

Basic content extraction:

{ "url": "https://example.com/blog/ai-trends-2024" }

Extract with content limit:

{ "url": "https://docs.example.com/api-reference", "max_content_length": 20000 }

Extract documentation:

{ "url": "https://github.com/project/docs/installation.md", "max_content_length": 10000 }

Extract complete article:

{ "url": "https://techblog.com/comprehensive-guide" }

Complete parameter example:

{ "url": "https://docs.python.org/3/library/asyncio.html", "max_content_length": 50000 }

When to Choose This Tool

  • Choose this when you have a specific URL from search results or references

  • Choose this for extracting content from documentation, articles, or blog posts

  • Choose this when you need to analyze or reference specific webpage content

  • Choose this for following up on URLs found in search results

  • Choose this when extracting content from GitHub README files or documentation

Error Handling

  • If URL is inaccessible, an error message will be provided

  • Some sites may block automated access - try alternative URLs

  • Dynamic content may require multiple attempts

  • Large pages may timeout - use content length limits

Alternative Tools

  • Use full_web_search when you need to find relevant pages first

  • Use get_web_search_summaries for discovering URLs to extract

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

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/geosp/mcp-mixsearch'

If you have feedback or need assistance with the MCP directory API, please join our Discord server