Skip to main content
Glama

websearch__briefbatch

Up to 3 briefs in one call. Price: $0.01 per call in USDC on Base (eip155:8453), paid with x402 in params._meta["x402/payment"]. HTTP: POST https://api.firstmention.uk/s/websearch/briefbatch

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "websearch__briefbatch"
  }
}

Input Schema

NameRequiredDescriptionDefault
queriesNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • removedInput schema / properties / limit
      Removed value: -{
      -  "type": "number"
      -}
    • addedInput schema / properties / queries
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • removedInput schema / properties / url
      Removed value: -{
      -  "type": "string"
      -}
  2. Changed4 schema fields changed
    • addedInput schema / properties / limit
      Added value: +{
      +  "type": "number"
      +}
    • removedInput schema / properties / q
      Removed value: -{
      -  "type": "string"
      -}
    • removedInput schema / properties / reset
      Removed value: -{
      -  "type": "boolean"
      -}
    • addedInput schema / properties / url
      Added value: +{
      +  "type": "string"
      +}
  3. Changed6 schema fields changed
    • removedInput schema / properties / chars
      Removed value: -{
      -  "type": "integer"
      -}
    • removedInput schema / properties / extract
      Removed value: -{
      -  "type": "integer"
      -}
    • addedInput schema / properties / q
      Added value: +{
      +  "type": "string"
      +}
    • removedInput schema / properties / queries
      Removed value: -{
      -  "items": {
      -    "type": "string"
      -  },
      -  "type": "array"
      -}
    • addedInput schema / properties / reset
      Added value: +{
      +  "type": "boolean"
      +}
    • removedInput schema / required
      Removed value: -[
      -  "queries"
      -]
  4. Changed3 schema fields changed
    • changedInput schema / properties / chars / type
      Previous value: -"number"New value: +"integer"
    • changedInput schema / properties / extract / type
      Previous value: -"number"New value: +"integer"
    • addedInput schema / required
      Added value: +[
      +  "queries"
      +]
  5. Changed2 schema fields changed
    • addedInput schema / properties / chars
      Added value: +{
      +  "type": "number"
      +}
    • addedInput schema / properties / extract
      Added value: +{
      +  "type": "number"
      +}
  6. Changed6 schema fields changed
    • removedInput schema / properties / chars
      Removed value: -{
      -  "description": "Markdown chars per page (200-8000)",
      -  "type": "integer"
      -}
    • removedInput schema / properties / extract
      Removed value: -{
      -  "description": "How many hits get full text (0-5)",
      -  "type": "integer"
      -}
    • removedInput schema / properties / limit
      Removed value: -{
      -  "description": "Max results (1-25)",
      -  "type": "integer"
      -}
    • removedInput schema / properties / q
      Removed value: -{
      -  "description": "Search query",
      -  "type": "string"
      -}
    • addedInput schema / properties / queries
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • removedInput schema / properties / url
      Removed value: -{
      -  "description": "Single URL to convert to markdown instead of searching",
      -  "type": "string"
      -}
  7. Changed7 schema fields changed
    • addedInput schema / properties / chars / description
      Added value: +"Markdown chars per page (200-8000)"
    • addedInput schema / properties / extract / description
      Added value: +"How many hits get full text (0-5)"
    • addedInput schema / properties / limit
      Added value: +{
      +  "description": "Max results (1-25)",
      +  "type": "integer"
      +}
    • addedInput schema / properties / q
      Added value: +{
      +  "description": "Search query",
      +  "type": "string"
      +}
    • removedInput schema / properties / queries
      Removed value: -{
      -  "items": {
      -    "type": "string"
      -  },
      -  "maxItems": 3,
      -  "type": "array"
      -}
    • addedInput schema / properties / url
      Added value: +{
      +  "description": "Single URL to convert to markdown instead of searching",
      +  "type": "string"
      +}
    • removedInput schema / required
      Removed value: -[
      -  "queries"
      -]
  8. Changed8 schema fields changed
    • removedInput schema / properties / chars / description
      Removed value: -"Max characters per extracted page (default 600)"
    • removedInput schema / properties / chars / maximum
      Removed value: -8000
    • removedInput schema / properties / chars / minimum
      Removed value: -200
    • removedInput schema / properties / extract / description
      Removed value: -"How many top hits to extract per query (default 1)"
    • removedInput schema / properties / extract / maximum
      Removed value: -3
    • removedInput schema / properties / extract / minimum
      Removed value: -1
    • removedInput schema / properties / queries / description
      Removed value: -"1 to 3 search queries"
    • removedInput schema / properties / queries / minItems
      Removed value: -1
  9. Changed5 schema fields changed
    • addedInput schema / properties / chars
      Added value: +{
      +  "description": "Max characters per extracted page (default 600)",
      +  "maximum": 8000,
      +  "minimum": 200,
      +  "type": "integer"
      +}
    • addedInput schema / properties / extract
      Added value: +{
      +  "description": "How many top hits to extract per query (default 1)",
      +  "maximum": 3,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • removedInput schema / properties / packages
      Removed value: -{
      -  "type": "string"
      -}
    • addedInput schema / properties / queries
      Added value: +{
      +  "description": "1 to 3 search queries",
      +  "items": {
      +    "type": "string"
      +  },
      +  "maxItems": 3,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • addedInput schema / required
      Added value: +[
      +  "queries"
      +]
  10. Changed4 schema fields changed
    • removedInput schema / properties / limit
      Removed value: -{
      -  "type": "number"
      -}
    • addedInput schema / properties / packages
      Added value: +{
      +  "type": "string"
      +}
    • removedInput schema / properties / q
      Removed value: -{
      -  "type": "string"
      -}
    • removedInput schema / properties / sources
      Removed value: -{
      -  "type": "string"
      -}
  11. Changed10 schema fields changed
    • removedInput schema / properties / chars
      Removed value: -{
      -  "description": "Max markdown chars per page",
      -  "maximum": 8000,
      -  "minimum": 200,
      -  "type": "integer"
      -}
    • removedInput schema / properties / extract
      Removed value: -{
      -  "description": "Pages to extract (default 4)",
      -  "maximum": 6,
      -  "minimum": 0,
      -  "type": "integer"
      -}
    • removedInput schema / properties / format
      Removed value: -{
      -  "description": "json (default) or md",
      -  "enum": [
      -    "json",
      -    "md"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / limit / description
      Removed value: -"Max results, default 10"
    • removedInput schema / properties / limit / maximum
      Removed value: -20
    • removedInput schema / properties / limit / minimum
      Removed value: -1
    • changedInput schema / properties / limit / type
      Previous value: -"integer"New value: +"number"
    • removedInput schema / properties / q / description
      Removed value: -"Search query"
    • removedInput schema / properties / sources / description
      Removed value: -"Comma list of hn,github,wiki,se (default all)"
    • removedInput schema / required
      Removed value: -[
      -  "q"
      -]
  12. Changed2 schema fields changed
    • addedInput schema / properties / chars
      Added value: +{
      +  "description": "Max markdown chars per page",
      +  "maximum": 8000,
      +  "minimum": 200,
      +  "type": "integer"
      +}
    • addedInput schema / properties / extract
      Added value: +{
      +  "description": "Pages to extract (default 4)",
      +  "maximum": 6,
      +  "minimum": 0,
      +  "type": "integer"
      +}
  13. Changed9 schema fields changed
    • removedInput schema / properties / extract
      Removed value: -{
      -  "type": "number"
      -}
    • addedInput schema / properties / format
      Added value: +{
      +  "description": "json (default) or md",
      +  "enum": [
      +    "json",
      +    "md"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / limit / description
      Added value: +"Max results, default 10"
    • addedInput schema / properties / limit / maximum
      Added value: +20
    • addedInput schema / properties / limit / minimum
      Added value: +1
    • changedInput schema / properties / limit / type
      Previous value: -"number"New value: +"integer"
    • addedInput schema / properties / q / description
      Added value: +"Search query"
    • addedInput schema / properties / sources
      Added value: +{
      +  "description": "Comma list of hn,github,wiki,se (default all)",
      +  "type": "string"
      +}
    • addedInput schema / required
      Added value: +[
      +  "q"
      +]
  14. Changed5 schema fields changed
    • removedInput schema / properties / chars
      Removed value: -{
      -  "description": "Max markdown characters per page (200-8000).",
      -  "type": "number"
      -}
    • removedInput schema / properties / extract / description
      Removed value: -"Number of top results to extract (0-4). Ignored when url= is given."
    • addedInput schema / properties / limit
      Added value: +{
      +  "type": "number"
      +}
    • removedInput schema / properties / q / description
      Removed value: -"Search query. Omit when using url=."
    • removedInput schema / properties / url
      Removed value: -{
      -  "description": "Optional exact page URL to extract as markdown instead of searching. Must be http(s).",
      -  "type": "string"
      -}
  15. First observed

TDQS

C2.9/5.0
Behavior3/5

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

With no annotations at all, the description carries the full burden and does add real value: exact price ($0.01 USDC on Base, eip155:8453), the x402 payment channel, and the HTTP endpoint. It is silent, however, on what happens with fewer than three queries, partial failures, rate limits, or what a brief contains.

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

Conciseness4/5

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

Three compact, front-loaded fragments with zero filler; the batch limit leads. The raw HTTP endpoint line is marginal for an MCP caller but small enough not to hurt.

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

Completeness3/5

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

Payment mechanics are covered well, which is the hardest part of this tool, but with no annotations, no output schema, and an undocumented parameter, the definition leaves the agent guessing about return shape and failure behavior for a paid batch call.

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

Parameters3/5

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

Schema coverage is 0% on a single `queries` array, and the description adds the key constraint (maximum 3 items) plus the payment location, though that payment key is not present in the schema at all. It never explains query string format, ordering of results, or how queries map to returned briefs.

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

Purpose3/5

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

"Up to 3 briefs in one call" establishes a batch-of-briefs resource and implicitly contrasts with the single-brief sibling (websearch__brief), but there is no verb describing the action and "brief" is never defined, so an agent must already know what a brief is.

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

Usage Guidelines2/5

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

No when-to-use or when-not-to-use guidance beyond the implicit "use this instead of three separate calls." It never names the single-call alternative or states any precondition other than payment, leaving selection between websearch__brief and websearch__briefbatch to inference.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources