Skip to main content
Glama

research

Multi-source research brief on a topic.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "topic": "<topic>"
    },
    "name": "research"
  }
}

Input Schema

NameRequiredDescriptionDefault
topicYesSubject to research or compare

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added
  2. Removed
  3. Changed2 schema fields changed
    • addedInput schema / properties / topic
      Added value: +{
      +  "description": "Subject to research or compare",
      +  "type": "string"
      +}
    • addedInput schema / required
      Added value: +[
      +  "topic"
      +]
  4. Added

TDQS

C2.5/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden and largely drops it. It does not disclose whether the call is expensive or slow, how many sources are consulted, whether results are cached, what the brief looks like, or how failure/partial results are reported; 'multi-source' is the only behavioral hint.

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?

It is a single short, front-loaded fragment with zero padding, which is good for scanning. But the brevity comes at the cost of under-specification rather than genuine conciseness, so it cannot score higher.

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

Completeness2/5

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

With no annotations, no output schema, and a tool whose value depends entirely on scope and depth of synthesis, the description is too thin. An agent knows the input but not what it will get back or what it costs, which is material for a research tool.

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?

There is a single parameter with 100% schema description coverage ('Subject to research or compare'), so the baseline is 3. The description adds nothing about topic syntax, breadth, or how a comparative topic should be phrased, though the schema's use of 'compare' hints at that mode.

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?

The phrase 'Multi-source research brief on a topic' names the resource (a research brief) and a distinguishing trait (multi-source), so the purpose is not a pure tautology. However, it does not differentiate from nearby siblings such as search_web, x402_search, summarize, or scrape, so an agent cannot tell from the description alone when this is the right tool.

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?

There is no explicit when-to-use guidance and no named alternative. In a sibling set that contains search, search_web, x402_search, summarize, and scrape, the agent is left to infer that this tool is the deep multi-source option rather than the cheap search option, which the description never states.

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