Skip to main content
Glama

Read a product's details

get_product
Read-onlyIdempotent

Use this when a seller asks about a product's specs, fabric, fit, print methods or what is similar to it. Returns curated product facts and similar products with what they share and how they differ. Specs describe the product; they do not promise every supplier offers every option.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "canonicalProductId": "<canonicalProductId>"
    },
    "name": "get_product"
  }
}

Input Schema

NameRequiredDescriptionDefault
similarLimitNoHow many similar products to return. 0 skips them.
canonicalProductIdYesA product id from search_products or resolve_supplier_link, such as `cotton-ringer-tee`.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedInput schema / properties / canonicalProductId / description
      Added value: +"A product id from search_products or resolve_supplier_link, such as `cotton-ringer-tee`."
    • addedInput schema / properties / similarLimit / description
      Added value: +"How many similar products to return. 0 skips them."
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "ok": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "product": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "audience": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "brand": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "canonicalProductId": {
      -            "type": "string"
      -          },
      -          "category": {
      -            "anyOf": [
      -              {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "id": {
      -                    "type": "string"
      -                  },
      -                  "name": {
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "id",
      -                  "name"
      -                ],
      -                "type": "object"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "description": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "faqs": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "answer": {
      -                  "type": "string"
      -                },
      -                "question": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "question",
      -                "answer"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "highlights": {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "model": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "printMethods": {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "specs": {
      -            "additionalProperties": {
      -              "type": "string"
      -            },
      -            "propertyNames": {
      -              "type": "string"
      -            },
      -            "type": "object"
      -          },
      -          "url": {
      -            "anyOf": [
      -              {
      -                "format": "uri",
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          }
      -        },
      -        "required": [
      -          "canonicalProductId",
      -          "name",
      -          "brand",
      -          "model",
      -          "category",
      -          "url",
      -          "audience",
      -          "description",
      -          "highlights",
      -          "printMethods",
      -          "specs",
      -          "faqs"
      -        ],
      -        "type": "object"
      -      },
      -      "similar": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "canonicalProductId": {
      -              "type": "string"
      -            },
      -            "differences": {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            "name": {
      -              "type": "string"
      -            },
      -            "sharedTraits": {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            "similarity": {
      -              "type": "string"
      -            },
      -            "url": {
      -              "format": "uri",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "canonicalProductId",
      -            "name",
      -            "url",
      -            "similarity",
      -            "sharedTraits",
      -            "differences"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "similarCount": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "product",
      -      "similar",
      -      "similarCount"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "code": {
      -            "enum": [
      -              "invalid_input",
      -              "not_found",
      -              "product_not_found",
      -              "invalid_option",
      -              "comparison_unavailable",
      -              "unavailable",
      -              "rate_limited"
      -            ],
      -            "type": "string"
      -          },
      -          "message": {
      -            "type": "string"
      -          },
      -          "retryable": {
      -            "type": "boolean"
      -          }
      -        },
      -        "required": [
      -          "code",
      -          "message",
      -          "retryable"
      -        ],
      -        "type": "object"
      -      },
      -      "ok": {
      -        "const": false,
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "ok": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "product": {
      +        "additionalProperties": false,
      +        "description": "The product asked about.",
      +        "properties": {
      +          "audience": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "Who the product is made for, such as unisex or mens."
      +          },
      +          "brand": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The brand, such as Gildan; null when the product has none."
      +          },
      +          "canonicalProductId": {
      +            "description": "The product's id.",
      +            "type": "string"
      +          },
      +          "category": {
      +            "anyOf": [
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "id": {
      +                    "description": "The category id.",
      +                    "type": "string"
      +                  },
      +                  "name": {
      +                    "description": "The category's display name.",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "id",
      +                  "name"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The category the product belongs to; null when it has none."
      +          },
      +          "description": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "A description of the product in words."
      +          },
      +          "faqs": {
      +            "description": "Questions sellers ask about this product.",
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "answer": {
      +                  "description": "The answer.",
      +                  "type": "string"
      +                },
      +                "question": {
      +                  "description": "The question.",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "question",
      +                "answer"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "highlights": {
      +            "description": "Short facts about the product, such as fabric and fit.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "model": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The brand's model code, such as `3001`; null when none."
      +          },
      +          "name": {
      +            "description": "The product's name.",
      +            "type": "string"
      +          },
      +          "printMethods": {
      +            "description": "Print methods the product supports, such as DTG or embroidery.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "specs": {
      +            "additionalProperties": {
      +              "type": "string"
      +            },
      +            "description": "Product specs as label and value, such as `fabric`: `100% cotton`.",
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          "url": {
      +            "anyOf": [
      +              {
      +                "format": "uri",
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "description": "The product's page on POD Benchmark; null when it has none."
      +          }
      +        },
      +        "required": [
      +          "canonicalProductId",
      +          "name",
      +          "brand",
      +          "model",
      +          "category",
      +          "url",
      +          "audience",
      +          "description",
      +          "highlights",
      +          "printMethods",
      +          "specs",
      +          "faqs"
      +        ],
      +        "type": "object"
      +      },
      +      "similar": {
      +        "description": "Other products that could stand in for this one.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "canonicalProductId": {
      +              "description": "The similar product's id.",
      +              "type": "string"
      +            },
      +            "differences": {
      +              "description": "Where it differs in a way that matters.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "name": {
      +              "description": "The similar product's name.",
      +              "type": "string"
      +            },
      +            "sharedTraits": {
      +              "description": "What it has in common with the product.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "similarity": {
      +              "description": "How close it is: close alternative or acceptable substitute.",
      +              "type": "string"
      +            },
      +            "url": {
      +              "description": "The similar product's page on POD Benchmark.",
      +              "format": "uri",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "canonicalProductId",
      +            "name",
      +            "url",
      +            "similarity",
      +            "sharedTraits",
      +            "differences"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "similarCount": {
      +        "description": "How many similar products exist in total.",
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "product",
      +      "similar",
      +      "similarCount"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "error": {
      +        "additionalProperties": false,
      +        "description": "The error this call returned instead of a result.",
      +        "properties": {
      +          "code": {
      +            "description": "The machine-readable reason the call failed.",
      +            "enum": [
      +              "invalid_input",
      +              "not_found",
      +              "product_not_found",
      +              "invalid_option",
      +              "comparison_unavailable",
      +              "unavailable",
      +              "rate_limited"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "What went wrong, in words, and what to do next.",
      +            "type": "string"
      +          },
      +          "retryable": {
      +            "description": "Whether calling again could succeed.",
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message",
      +          "retryable"
      +        ],
      +        "type": "object"
      +      },
      +      "ok": {
      +        "const": false,
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. First observed

TDQS

A3.6/5.0
Behavior3/5

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

Annotations already declare readOnly, idempotent, non-destructive and closed-world, so the safety profile is covered. The description adds real value with the caveat that specs describe the product but do not promise every supplier offers every option, and by noting similar products come with shared/differing attributes. It does not discuss pagination or limits, but the output schema carries return shape.

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

Conciseness4/5

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

Three tight sentences, front-loaded with the usage trigger followed by the return content and a scoping caveat. No filler, though the caveat sentence is slightly dense and could be split for scanability.

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 two-parameter read tool with full schema coverage, annotations and an output schema, the description supplies the missing pieces: when to reach for it and the important caveat about spec coverage. Nothing essential to correct invocation is absent.

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 coverage is 100%, so both canonicalProductId and similarLimit are fully documented in the schema, including the '0 skips them' behavior. The description only alludes to similar products generically and adds no format or constraint detail beyond the schema, so 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 ('Returns curated product facts and similar products') and enumerates the question types it answers (specs, fabric, fit, print methods, similarity). It is clearly distinguishable from get_product_options and compare_product by its 'curated facts plus similar products' framing, though it never names a sibling explicitly.

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

Usage Guidelines4/5

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

'Use this when a seller asks about a product's specs, fabric, fit, print methods or what is similar to it' gives a concrete triggering context. It stops short of exclusions or pointing to alternatives such as compare_product for side-by-side comparison, so the agent must infer the boundary.

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.