Skip to main content
Glama

get_forest_offer

Read-only

A forest version of one of your listings, drafted by hashn (0.37.0): hashn's forest is the store's listings on hashn's conventions, where buyers find and compare them; the rest of the store is the wilderness. When hashn drafts one for you, a notice names the offer; this shows it in full (the post_listing arguments, the header as it would be written, and that it would be in the forest). Without offer_id: all your offers. Your original listing is never changed.

Input Schema

NameRequiredDescriptionDefault
offer_idNoThe offer's id, from hashn's notice. Leave it out to list all your offers.
api_tokenNoYour hashn API token, if you can't send it as the 'Authorization: Bearer <token>' header. Omit it when the header is set.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A3.5/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true and openWorldHint=false, so the safety profile is covered. The description adds value by explicitly stating 'Your original listing is never changed' (reinforcing the read-only guarantee on the source resource) and by enumerating the returned content (arguments, drafted header, forest status), which matters because there is no output schema.

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

Conciseness2/5

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

The opening expository clause defining 'forest' versus 'wilderness' consumes significant space without helping an agent select or invoke the tool. The description also carries embedded line breaks/indentation artifacts, and the useful scoping constraint ('Without offer_id: all your offers') is pushed to the end rather than front-loaded.

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?

For a zero-required-param read tool with no output schema, the description does the needed work: it explains what is returned (post_listing arguments, drafted header, forest membership) and that the source listing is untouched. Auth is handled by the schema, so the remaining coverage gap is minor.

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 description coverage is 100%, so the schema already documents both offer_id and api_token, including the header-vs-parameter auth fallback. The description's 'Without offer_id: all your offers' simply restates the schema's 'Leave it out to list all your offers.' Baseline 3 is appropriate.

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

Purpose4/5

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

The description establishes that this retrieves a hashn-drafted 'forest' offer for one of the user's listings, and specifies what is shown: the post_listing arguments, the header, and its forest status. The metaphor ('forest'/'wilderness') adds cognitive load but the underlying verb+resource is recoverable. It does not directly contrast with siblings such as accept_forest_offer or post_listing.

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

Usage Guidelines3/5

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

'When hashn drafts one for you, a notice names the offer; this shows it in full' implies the trigger context, and 'Without offer_id: all your offers' defines the two modes. However, no alternative tools are named and there are no explicit when-not conditions, so the agent must infer that this is a read companion to accept_forest_offer/post_listing.

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