Skip to main content
Glama

Parallel Web Search and Extract

search_parallel

Run 2–12 independent live web searches in one call, then optionally extract abstracts or full text from public pages, PDFs, and GitHub repos to gather ranked evidence for research tasks.

Instructions

PRIMARY MULTI-QUERY LIVE DISCOVERY AND CONTENT INGESTION TOOL. ALWAYS PERFORMS MULTIPLE LIVE WEB SEARCHES. With research enabled, one local broker lets multiple MCP sessions query the same knowledge base concurrently and orders writes safely. Use this tool only when 2-12 new external queries are required. Providing project_id adds stored evidence but never makes the searches local-only. When the task requires broad discovery plus reading public web pages, PDFs, papers, or GitHub repositories, set extract_mode=abstract or full in this call. Do not download public PDFs, clone repositories, or invoke local parsers first. Select extract_mode=full, not abstract, when the user asks to read originals, full text, document bodies, or code, or to compare source contents. Use extract separately only when the exact public URL is already known and no new discovery is required. Use general repository tools only for editing, building, testing, or full Git history. For stored project knowledge without live web discovery, use project_memory_search. Each query limit accepts integers from 1 to 20. Call-wide extract_limit accepts 1-20 with default 12 for abstract, and 1-10 with default 10 for full. Final results use one call-wide bounded response budget after ranking; at most 36 ranked rows are returned across query groups and full captured bodies remain local. Use extract on one selected URL when longer response text is explicitly required. The response includes applied, skipped, truncated, total_chars, and a bounded remaining_urls list. GitHub none mode reads the README; abstract and full can sparse-index eligible repositories with Tree-sitter. With research enabled and project_id set, each query fuses live, exact, BM25, vector, code, and graph lanes through RRF and one reranker. With research disabled, each query independently fuses provider order and query BM25 rank through a lightweight in-memory RRF reranker without opening local storage or loading the vector model. research_context returns prior project searches; capture retains data lineage and include_project_ids uses versioned ontology and verified cross-project schema/entity links. Extracted bodies become evidence while unread hits remain metadata. Native Chrome uses one authenticated local broker across MCP sessions and keeps one hidden process with up to four reusable tabs. Query starts are staggered and each tab continuously consumes the remaining queue. SearchApi fallback replaces failed queries individually.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoMaximum results per query. Integer 1-20, default 10.
queriesYes2-12 independent live queries.
max_charsNoMaximum returned characters per extracted result in response_content=full. Defaults to 1500 for abstract and 50000 for full.
project_idNoProject memory id.
session_idNoStable host task id. Reuses the same project session after restart.
extract_modeNoContent depth in this search call. Use none only when titles and snippets are enough, abstract for relevance evidence, and full when the user asks to read originals, full text, document bodies, or code, or to compare source contents. Use abstract or full here instead of following search with separate extraction, PDF download, or repository clone. For GitHub results, none reads the README; abstract and full use the same repository eligibility gate but index different source amounts.none
extract_limitNoCall-wide maximum unique result URLs to extract. Integer 1-20, default 12 for abstract; full defaults to and allows at most 10.
memory_handleNoReuse the handle returned by a prior project-aware call.
session_intentNoCurrent durable task intent. A changed value creates an immutable revision.
response_contentNoControls only returned bodies. summary is the default and returns 1500-character evidence excerpts; full returns up to max_chars. Research storage keeps the full captured text in deterministic chunks.summary
include_project_idsNoAdditional read-only projects joined through ontology-aligned schema and identity links. New records stay in project_id.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
metaNo
errorNo
memoryNo
resultsNo
elapsed_msNo
memory_handleNo
research_contextNo

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed1 schema field changedv1.0.4
    • changedInput schema / properties / extract_mode / description
      Previous value: -"Content depth in this search call. Use abstract or full during research instead of following search with separate extract calls. For GitHub results, none reads the README; abstract and full use the same repository eligibility gate but index different source amounts."New value: +"Content depth in this search call. Use none only when titles and snippets are enough, abstract for relevance evidence, and full when the user asks to read originals, full text, document bodies, or code, or to compare source contents. Use abstract or full here instead of following search with separate extraction, PDF download, or repository clone. For GitHub results, none reads the README; abstract and full use the same repository eligibility gate but index different source amounts."
  2. Changed8 schema fields changedv1.0.2
    • removedInput schema / properties / extract_limit / default
      Removed value: -5
    • changedInput schema / properties / extract_limit / description
      Previous value: -"Maximum unique result URLs to extract. For parallel search this is one call-wide limit, not a per-query limit."New value: +"Call-wide maximum unique result URLs to extract. Integer 1-20, default 12 for abstract; full defaults to and allows at most 10."
    • changedInput schema / properties / extract_limit / maximum
      Previous value: -10New value: +20
    • changedInput schema / properties / limit / description
      Previous value: -"Max results per query."New value: +"Maximum results per query. Integer 1-20, default 10."
    • changedInput schema / properties / max_chars / description
      Previous value: -"Maximum characters per extracted result. Defaults to 1500 for abstract and 50000 for full."New value: +"Maximum returned characters per extracted result in response_content=full. Defaults to 1500 for abstract and 50000 for full."
    • addedInput schema / properties / response_content
      Added value: +{
      +  "default": "summary",
      +  "description": "Controls only returned bodies. summary is the default and returns 1500-character evidence excerpts; full returns up to max_chars. Research storage keeps the full captured text in deterministic chunks.",
      +  "enum": [
      +    "summary",
      +    "full"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / source_length
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / truncated
      Added value: +{
      +  "type": "boolean"
      +}
  3. Changed43 schema fields changedv1.0.0
    • addedInput schema / properties / extract_limit
      Added value: +{
      +  "default": 5,
      +  "description": "Maximum unique result URLs to extract. For parallel search this is one call-wide limit, not a per-query limit.",
      +  "maximum": 10,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / extract_mode
      Added value: +{
      +  "default": "none",
      +  "description": "Content depth in this search call. Use abstract or full during research instead of following search with separate extract calls. For GitHub results, none reads the README; abstract and full use the same repository eligibility gate but index different source amounts.",
      +  "enum": [
      +    "none",
      +    "abstract",
      +    "full"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / include_project_ids
      Added value: +{
      +  "description": "Additional read-only projects joined through ontology-aligned schema and identity links. New records stay in project_id.",
      +  "items": {
      +    "maxLength": 64,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "maxItems": 8,
      +  "type": "array"
      +}
    • addedInput schema / properties / max_chars
      Added value: +{
      +  "description": "Maximum characters per extracted result. Defaults to 1500 for abstract and 50000 for full.",
      +  "maximum": 50000,
      +  "minimum": 200,
      +  "type": "integer"
      +}
    • addedInput schema / properties / memory_handle
      Added value: +{
      +  "description": "Reuse the handle returned by a prior project-aware call.",
      +  "format": "uuid",
      +  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      +  "type": "string"
      +}
    • addedInput schema / properties / project_id
      Added value: +{
      +  "description": "Project memory id.",
      +  "maxLength": 64,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • changedInput schema / properties / queries / description
      Previous value: -"2-10 queries to run concurrently."New value: +"2-12 independent live queries."
    • addedInput schema / properties / queries / items / maxLength
      Added value: +400
    • addedInput schema / properties / queries / items / minLength
      Added value: +1
    • changedInput schema / properties / queries / maxItems
      Previous value: -10New value: +12
    • changedInput schema / properties / queries / minItems
      Previous value: -1New value: +2
    • addedInput schema / properties / session_id
      Added value: +{
      +  "description": "Stable host task id. Reuses the same project session after restart.",
      +  "maxLength": 200,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / session_intent
      Added value: +{
      +  "description": "Current durable task intent. A changed value creates an immutable revision.",
      +  "maxLength": 2000,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedOutput schema / properties / memory
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / memory_handle
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / research_context
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "prior_searches": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "query": {
      +            "type": "string"
      +          },
      +          "relation": {
      +            "enum": [
      +              "same",
      +              "related",
      +              "recent"
      +            ],
      +            "type": "string"
      +          },
      +          "results": {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          "searched_at": {
      +            "type": "string"
      +          },
      +          "surface": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "query",
      +          "relation",
      +          "searched_at",
      +          "results"
      +        ],
      +        "type": "object"
      +      },
      +      "maxItems": 3,
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "prior_searches"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / properties / results / items / properties / provider / enum
      Previous value: -[
      -  "browser",
      -  "searchapi"
      -]New value: +[
      +  "browser",
      +  "searchapi",
      +  "local"
      +]
    • addedOutput schema / properties / results / items / properties / results / items / properties / authors
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / canonical_url
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / content
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / created_at
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / creator
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / document_id
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / doi
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / excerpt
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / extract_error
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / extraction_quality
      Added value: +{
      +  "enum": [
      +    "full_text",
      +    "abstract",
      +    "meta_abstract",
      +    "metadata_only"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / fresh_web
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / is_pdf
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / keywords
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / language
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / length
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / modified_at
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / page_count
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / producer
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / project_ids
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / publication
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / published_at
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / retrieval_families
      Added value: +{
      +  "items": {
      +    "enum": [
      +      "exact",
      +      "bm25",
      +      "vector",
      +      "graph"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / score
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / source_family
      Added value: +{
      +  "enum": [
      +    "live",
      +    "document",
      +    "code",
      +    "graph"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / subject
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / results / items / properties / year
      Added value: +{
      +  "maximum": 9007199254740991,
      +  "minimum": -9007199254740991,
      +  "type": "integer"
      +}
  4. Changed3 schema fields changedv0.8.0
    • addedOutput schema / properties / results / items / properties / degraded_reasons
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / results / items / properties / fallback_reason
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / provider
      Added value: +{
      +  "enum": [
      +    "browser",
      +    "searchapi"
      +  ],
      +  "type": "string"
      +}
  5. Addedv0.6.5
  6. Removedv0.6.1
  7. Addedv0.5.2
  8. Removedv0.5.1
  9. Addedv0.4.8
  10. Removedv0.4.7
  11. Changed6 schema fields changedv0.3.5
    • addedInput schema / $schema
      Added value: +"http://json-schema.org/draft-07/schema#"
    • addedInput schema / properties / limit / default
      Added value: +10
    • changedInput schema / properties / limit / description
      Previous value: -"Max results per query"New value: +"Max results per query."
    • changedInput schema / properties / limit / type
      Previous value: -"number"New value: +"integer"
    • changedInput schema / properties / queries / description
      Previous value: -"Queries"New value: +"2-10 queries to run concurrently."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": false,
      +  "properties": {
      +    "elapsed_ms": {
      +      "type": "number"
      +    },
      +    "error": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "code": {
      +          "type": "string"
      +        },
      +        "message": {
      +          "type": "string"
      +        },
      +        "retry_after_ms": {
      +          "type": "number"
      +        },
      +        "retryable": {
      +          "type": "boolean"
      +        },
      +        "user_action": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "code",
      +        "message",
      +        "retryable"
      +      ],
      +      "type": "object"
      +    },
      +    "meta": {
      +      "additionalProperties": {},
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "results": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "error": {
      +            "type": "string"
      +          },
      +          "query": {
      +            "type": "string"
      +          },
      +          "results": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "description": {
      +                  "type": "string"
      +                },
      +                "title": {
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "title",
      +                "url",
      +                "description"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "query",
      +          "results"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
  12. First observedv0.3.2

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only convey readOnly=false, openWorldHint=true, and idempotentHint=false; the description adds substantial behavioral detail beyond those: writes are ordered, full captured bodies remain local, the response includes applied/skipped/truncated/total_chars and a bounded remaining_urls list, results are capped at 36 ranked rows, GitHub indexing behavior differs by mode, and SearchApi fallback replaces failed queries. This far exceeds what the annotations provide.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well front-loaded and information-dense, but it is very long and contains redundancy, such as repeated extract guidance, and implementation details like 'Native Chrome uses one authenticated local broker...' and tree-sitter sparse-indexing that could be trimmed. Not every sentence earns its place despite the overall usefulness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 11-parameter tool with an output schema, the description is remarkably complete: it covers use cases, parameter semantics, response contents, result budgets, extraction limits, research modes, repository handling, and fallback behavior. An agent has enough context to invoke the tool correctly in most scenarios without additional inference.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is already 100%, and the description still adds meaning: it explains that query limit accepts 1-20, extract_limit defaults differ by mode, extract_mode maps to user intent ('full, not abstract, when the user asks to read originals'), max_chars defaults to 1500/50000 behavior, and project_id never makes searches local-only. This is strong value beyond the structured schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'MULTI-QUERY LIVE DISCOVERY AND CONTENT INGESTION TOOL. ALWAYS PERFORMS MULTIPLE LIVE WEB SEARCHES.' It clearly differentiates from siblings by naming when to use extract, project_memory_search, and repository tools instead, so an agent can distinguish it without ambiguity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives explicit when/when-not guidance: 'Use this tool only when 2-12 new external queries are required,' and it names alternatives: 'Use extract separately only when the exact public URL is already known,' 'For stored project knowledge without live web discovery, use project_memory_search,' and 'Use general repository tools only for editing, building, testing, or full Git history.' This is model usage guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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/HarimxChoi/google-surf-mcp'

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