Skip to main content
Glama

Fitness Starter – hand-picked gift ideas

create_pack

Create a gear pack (optionally pre-filled). Returns ownerUrl + shopUrl + editToken. marketplace=amazon.com gives amazon.com /dp/ links; optional (en-US → amazon.com, otherwise amazon.se).

Input Schema

NameRequiredDescriptionDefault
goalNo
levelNo
localeNoOptional end-user locale, e.g. en-US, sv-SE. Defaults from Accept-Language or the store (amazon.com → en-US, amazon.se → sv-SE).
countryNoOptional ISO country code, e.g. US or SE (US → amazon.com). Used when marketplace is omitted.
itemAsinsNo
budgetBandNo
athleteNameNo
itemQueriesNo
marketplaceNoOptional. Amazon storefront domain or id, e.g. amazon.com, amazon.se, us, se. Use marketplace=amazon.com for US shoppers (hand-picked amazon.com /dp/ catalog, tag sw-fitness-20). If omitted: country, then Accept-Language (en-US → amazon.com), else amazon.se.
itemKeywordsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.8/5.0
Behavior3/5

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

With no annotations, the description does carry the burden, and it usefully discloses return fields including the sensitive editToken plus the marketplace fallback chain (country → Accept-Language → amazon.se). It omits side effects, whether the pack is persisted/editable after creation, and any auth or idempotency notes.

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?

Front-loaded and short, with the purpose and outputs stated first. The trailing clause 'optional (en-US → amazon.com, otherwise amazon.se)' is a compressed fragment that is hard to parse out of context and duplicates schema text rather than adding clarity.

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?

For a 10-parameter creation tool with no annotations and no output schema, the description covers only marketplace resolution; how goal/level/budgetBand and the three item-* arrays combine to pre-fill a pack is left entirely implicit.

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

Parameters2/5

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

Schema coverage is only 30%: goal, level, budgetBand, athleteName, itemAsins, itemQueries and itemKeywords are undocumented in both schema and description. The description expands only on marketplace (largely repeating the schema's own text) and hints at locale, leaving the interaction among the seven bulk parameters unexplained.

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?

"Create a gear pack (optionally pre-filled)" names a specific verb and resource, and the return-value list clarifies scope. It does not, however, distinguish this from the sibling create_and_fill, leaving the boundary between 'optionally pre-filled' and 'fill' ambiguous.

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 sentence tells the agent when to choose this over create_and_fill or add_item; the marketplace/locale text is parameter behavior, not usage guidance. The only implied guidance is the 'optionally pre-filled' hint, which the agent must infer.

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