Get my product
get_my_productOne of the user's own listings or drafts. Needs an access token.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| productId | Yes | The productId returned by submit_product or list_my_products |
get_my_productOne of the user's own listings or drafts. Needs an access token.
| Name | Required | Description | Default |
|---|---|---|---|
| productId | Yes | The productId returned by submit_product or list_my_products |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=false, so the safety profile is known. The description adds useful context by noting the access-token requirement and that the resource is the user's own listing or draft. It does not describe return shape, missing-record behavior, or pagination, so it adds moderate value beyond annotations but not rich behavioral detail.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences with no wasted text. The scope statement is front-loaded, though the extreme brevity contributes to gaps in purpose and usage guidance.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple one-parameter read tool with annotations and full schema coverage, the description covers resource scope and auth requirements. It is still too thin on what the tool returns and how it differs from get_product or list_my_products, so it is only minimally complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, and the productId parameter is already explained as coming from submit_product or list_my_products. The description adds no parameter-specific meaning beyond the schema, so the baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description identifies the resource as one of the user's own listings or drafts, which adds scope beyond the name. However, it never states the action explicitly, relying on the tool name and title to imply retrieval. It does not distinguish this from the sibling get_product in the description text.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The only guidance is the prerequisite 'Needs an access token.' There is no statement of when to use this tool instead of list_my_products or get_product, and no exclusions or alternative routing are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.