Skip to main content
Glama

hbr_article

Read-only

Fetch public Harvard Business Review article metadata and full body text from a canonical url; from_magazine identifies articles originally published in print. Use hbr_headlines to find stories or hbr_topic to browse a topic.

Input Schema

NameRequiredDescriptionDefault
urlYesCanonical hbr.org article URL

Output Schema

NameRequiredDescriptionDefault
dataYesThe tool result payload (shape varies per tool; see each tool's docs resource).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / url / description
      Added value: +"Canonical hbr.org article URL"
  2. First observed

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true and openWorldHint=true, so the safety profile is covered. The description adds that the article is 'public' (implying no auth) and that it returns both metadata and full body text, plus the meaning of `from_magazine`. It stops short of noting paywall/rate-limit behavior, so it is a solid but not exhaustive addition.

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

Conciseness5/5

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

Two tightly written sentences: the fetch behavior and `from_magazine` note come first, and the sibling routing follows. No filler, no repetition.

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

Completeness4/5

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

With an output schema present, return values need not be described, and the description covers the call semantics and discovery alternatives. The one loose end is the `from_magazine` reference, which appears neither in the input schema nor is it clarified whether it is input or output, leaving slight ambiguity.

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 100% (single `url` param documented as 'Canonical hbr.org article URL'), so the schema already carries the parameter meaning; the description only echoes 'canonical `url`'. It adds no syntax or format detail beyond the schema, matching the baseline 3.

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?

States a specific verb (fetch) and resource (HBR article metadata and full body text), and names the exact input (a canonical `url`). It also routes the agent to hbr_headlines and hbr_topic, so the tool is clearly distinguishable from its siblings.

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?

Explicitly says to use hbr_headlines to find stories or hbr_topic to browse a topic, which tells the agent both when to use this tool (you already have a canonical URL) and which siblings to use for discovery. Nothing is left 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.