Skip to main content
Glama

MagSnap — Custom Photo Magnets & Gift Printing Store

create_checkout_link

Generate a pre-filled direct cart checkout link for magsnap.co.za so the customer can upload their photos and complete payment via PayFast.

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

Input Schema

NameRequiredDescriptionDefault
is_giftNoWhether to enable gift packaging (+R50).
ai_styled_countNoNumber of magnets with 3D Pixar/cartoon AI styling.
puzzle_set_countNoNumber of 9-piece puzzle magnet sets (R270 each).
single_magnet_countNoNumber of standard custom square photo magnets (R30 each).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • changedInput schema / properties / ai_styled_count / description
      Previous value: -"Number of magnets with 3D Pixar/cartoon AI styling. [Optional: omit to use server default filter]."New value: +"Number of magnets with 3D Pixar/cartoon AI styling."
    • changedInput schema / properties / is_gift / description
      Previous value: -"Whether to enable gift packaging (+R50). [Optional: omit to use server default filter]."New value: +"Whether to enable gift packaging (+R50)."
    • changedInput schema / properties / puzzle_set_count / description
      Previous value: -"Number of 9-piece puzzle magnet sets (R270 each). [Optional: omit to use server default filter]."New value: +"Number of 9-piece puzzle magnet sets (R270 each)."
    • changedInput schema / properties / single_magnet_count / description
      Previous value: -"Number of standard custom square photo magnets (R30 each). [Optional: omit to use server default filter]."New value: +"Number of standard custom square photo magnets (R30 each)."
  2. Changed4 schema fields changed
    • changedInput schema / properties / ai_styled_count / description
      Previous value: -"Number of magnets with 3D Pixar/cartoon AI styling."New value: +"Number of magnets with 3D Pixar/cartoon AI styling. [Optional: omit to use server default filter]."
    • changedInput schema / properties / is_gift / description
      Previous value: -"Whether to enable gift packaging (+R50)."New value: +"Whether to enable gift packaging (+R50). [Optional: omit to use server default filter]."
    • changedInput schema / properties / puzzle_set_count / description
      Previous value: -"Number of 9-piece puzzle magnet sets (R270 each)."New value: +"Number of 9-piece puzzle magnet sets (R270 each). [Optional: omit to use server default filter]."
    • changedInput schema / properties / single_magnet_count / description
      Previous value: -"Number of standard custom square photo magnets (R30 each)."New value: +"Number of standard custom square photo magnets (R30 each). [Optional: omit to use server default filter]."
  3. First observed

TDQS

B3.1/5.0
Behavior2/5

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

No annotations exist, so the description carries the full burden. It clarifies that payment is completed externally on PayFast and that photo upload happens after link generation, but says nothing about link expiry, whether calling it mutates server state or reserves inventory, whether it is idempotent, or what happens with all counts at zero.

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?

A single sentence with zero waste, front-loading the action (generate link) and then its purpose. Nothing is repeated or padded.

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

Completeness3/5

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

There is no output schema, yet the description never says the result is a URL or what the agent should do with it. With zero required parameters, it also doesn't state what an all-default call produces. Adequate but leaves real gaps for a link-generation 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?

Schema description coverage is 100% and the schema already documents each count and its pricing implication. The description only adds the vague notion of a 'pre-filled' cart, adding no syntax, ranges, or interaction rules (e.g. gift packaging with puzzle sets).

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: generate a pre-filled direct cart checkout link for magsnap.co.za, with the payment path (PayFast) named. It is clearly distinguishable from calculate_quote and get_products, though it doesn't explicitly contrast itself with those siblings.

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?

It explains what the link is for (customer uploads photos and pays via PayFast) but gives no explicit when-to-use guidance and never names the siblings. An agent must infer whether to call calculate_quote first, or whether this tool supersedes it.

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