MagSnap — Custom Photo Magnets & Gift Printing Store

Fetch all available MagSnap photo magnet products, categories, pricing, and specs in South Africa (ZAR). When to use: Call this tool when you specifically need to execute 'get_products' on MagSnap Custom Photo Magnets (magsnap.co.za). Do NOT use this tool when another specialized tool fits better (use 'calculate_quote' or 'create_checkout_link' or 'track_order' for their respective operations). Parameters: category_id (optional). Behavior & Side Effects: Strictly read-only, idempotent query with zero state mutation; public unauthenticated access allowed; rate-limited to 60 requests/min per IP. Returns: Structured JSON object containing status, matched records or computed metrics, and canonical action URLs.

{
  "type": "object",
  "properties": {
    "category_id": {
      "type": "number",
      "description": "Optional category ID to filter products by (e.g. 1 for Photo Magnets, 2 for Puzzles)."
    }
  }
}

Calculate an instant order quote for MagSnap photo magnets including item costs, AI 3D cartoon styling surcharge (+R5/ea), gift wrap (+R50), and courier delivery in South Africa. When to use: Call this tool when you specifically need to execute 'calculate_quote' on MagSnap Custom Photo Magnets (magsnap.co.za). Do NOT use this tool when another specialized tool fits better (use 'get_products' or 'create_checkout_link' or 'track_order' for their respective operations). Parameters: single_magnet_count (optional), ai_styled_count (optional), puzzle_set_count (optional), is_gift (optional). Behavior & Side Effects: Strictly read-only, idempotent query with zero state mutation; public unauthenticated access allowed; rate-limited to 60 requests/min per IP. Returns: Structured JSON object containing status, matched records or computed metrics, and canonical action URLs.

{
  "type": "object",
  "properties": {
    "single_magnet_count": {
      "type": "number",
      "description": "Number of standard custom square photo magnets (R30 each). [Optional: omit to use server default filter]."
    },
    "ai_styled_count": {
      "type": "number",
      "description": "Number of magnets with 3D Pixar/cartoon AI style transformation (+R5 surcharge each, R35 total)."
    },
    "puzzle_set_count": {
      "type": "number",
      "description": "Number of 9-piece puzzle magnet sets (R270 each). [Optional: omit to use server default filter]."
    },
    "is_gift": {
      "type": "boolean",
      "description": "Whether premium gift packaging is requested (+R50 fee). [Optional: omit to use server default filter]."
    }
  }
}

Generate a pre-filled direct cart checkout link for magsnap.co.za so the customer can upload their photos and complete payment via PayFast. When to use: Call this tool when you specifically need to execute 'create_checkout_link' on MagSnap Custom Photo Magnets (magsnap.co.za). Do NOT use this tool when another specialized tool fits better (use 'get_products' or 'calculate_quote' or 'track_order' for their respective operations). Parameters: single_magnet_count (optional), ai_styled_count (optional), puzzle_set_count (optional), is_gift (optional). Behavior & Side Effects: Creates a live record/session in the backend database; no authentication required for public initiation; rate-limited to 60 requests/min per IP. Returns: Structured JSON object containing status, matched records or computed metrics, and canonical action URLs.

{
  "type": "object",
  "properties": {
    "single_magnet_count": {
      "type": "number",
      "description": "Number of standard custom square photo magnets (R30 each). [Optional: omit to use server default filter]."
    },
    "ai_styled_count": {
      "type": "number",
      "description": "Number of magnets with 3D Pixar/cartoon AI styling. [Optional: omit to use server default filter]."
    },
    "puzzle_set_count": {
      "type": "number",
      "description": "Number of 9-piece puzzle magnet sets (R270 each). [Optional: omit to use server default filter]."
    },
    "is_gift": {
      "type": "boolean",
      "description": "Whether to enable gift packaging (+R50). [Optional: omit to use server default filter]."
    }
  }
}

Look up order status and shipping progress for an existing MagSnap order by Order ID. When to use: Call this tool when you specifically need to execute 'track_order' on MagSnap Custom Photo Magnets (magsnap.co.za). Do NOT use this tool when another specialized tool fits better (use 'get_products' or 'calculate_quote' or 'create_checkout_link' for their respective operations). Parameters: order_id (required). Behavior & Side Effects: Strictly read-only, idempotent query with zero state mutation; public unauthenticated access allowed; rate-limited to 60 requests/min per IP. Returns: Structured JSON object containing status, matched records or computed metrics, and canonical action URLs.

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "The MagSnap Order ID (UUID format, e.g. 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d)."
    }
  },
  "required": [
    "order_id"
  ]
}

Retrieve official MagSnap product specifications, material durability, production turnaround, and courier delivery policies across South Africa. When to use: Call this tool when you specifically need to execute 'get_store_faq' on MagSnap Custom Photo Magnets (magsnap.co.za). Do NOT use this tool when another specialized tool fits better (use 'get_products' or 'calculate_quote' or 'create_checkout_link' for their respective operations). Parameters: topic (optional). Behavior & Side Effects: Strictly read-only, idempotent query with zero state mutation; public unauthenticated access allowed; rate-limited to 60 requests/min per IP. Returns: Structured JSON object containing status, matched records or computed metrics, and canonical action URLs.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "materials",
        "shipping",
        "turnaround",
        "ai_styling",
        "returns",
        "all"
      ],
      "description": "Specific FAQ topic or 'all' for complete store overview. [Optional: omit to use server default filter]."
    }
  }
}