Skip to main content
Glama

Pakki Packaging Brand Directory

List packaging brand directories

list_directories
Read-onlyIdempotent

List the public, source-backed directories of U.S. consumer brands using flexible packaging (pet food, coffee, compostable/recyclable). Returns each directory id, entry count, last update, web page URL, and CSV download URL.

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": "list_directories"
  }
}

Input Schema

NameRequiredDescriptionDefault
localeNoResponse language: "en" for English or "zh" for Simplified Chinese.en

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.6/5.0
Behavior4/5

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

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world), so the description only needs added context — and it supplies two useful pieces: data provenance ('public, source-backed') and the returned field set (id, entry count, last update, page URL, CSV URL). It omits any statement about result size, pagination, or whether the list is exhaustive.

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 tight sentences, zero filler. The scoping qualifiers are front-loaded in sentence one and the return payload is stated second.

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?

There is no output schema, so the description carries the burden of describing returns and it does so adequately with a concrete field list. It falls short only on bound/unbounded behavior and the relationship to search_brands, which an agent choosing between the two would want to know.

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?

With a single locale parameter at 100% schema description coverage and an enum, the schema fully documents the parameter including default. The description adds nothing about locale or language behavior, so the baseline 3 applies.

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?

States a specific verb and resource ('List the ... directories') and narrows the scope concretely: public, source-backed, U.S. consumer brands, flexible packaging, with three verticals named. An agent can tell this is a directory-enumeration call, though it never names or contrasts with its siblings (search_brands, get_evidence_policy), which keeps it short of a 5.

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 when-to-use guidance. The description does not say whether this is a discovery entry point that should precede search_brands, nor when it should be preferred over searching brands directly. The domain scoping implies a browse/listing use case, but nothing is stated.

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