Skip to main content
Glama

Get product request

get_product_request
Read-only

Get a product request. scope=mine (default) returns your request including workflow history and safety status. scope=public returns another user's public request with only public platform/environment options; owner identity, private details and safety/review notes are omitted. Capture progress is exposed without job IDs. requestId is returned by create_product_request or list_product_requests.

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": {
      "requestId": "<requestId>"
    },
    "name": "get_product_request"
  }
}

Input Schema

NameRequiredDescriptionDefault
scopeNomine (default) returns your requests; public returns other users public requests with private and safety details omitted.mine
requestIdYesUUID returned by create_product_request or list_product_requests. The request must be visible in the selected scope.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed7 schema fields changed
    • addedInput schema / properties / scope / enum
      Added value: +[
      +  "mine",
      +  "public"
      +]
    • removedOutput schema / $defs / request
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "$ref": "#/$defs/privateRequest"
      -    },
      -    {
      -      "$ref": "#/$defs/publicRequest"
      -    }
      -  ],
      -  "description": "Request fields vary with mine/public scope"
      -}
    • removedOutput schema / additionalProperties
      Removed value: -false
    • addedOutput schema / anyOf
      Added value: +[
      +  {
      +    "$ref": "#/$defs/privateRequest"
      +  },
      +  {
      +    "$ref": "#/$defs/publicRequest"
      +  }
      +]
    • changedOutput schema / description
      Previous value: -"Structured result. Existing text or image content remains available in content."New value: +"Request fields vary with mine/public scope"
    • removedOutput schema / properties
      Removed value: -{
      -  "result": {
      -    "$ref": "#/$defs/request"
      -  }
      -}
    • removedOutput schema / required
      Removed value: -[
      -  "result"
      -]
  2. Changed3 schema fields changed
    • addedInput schema / properties / requestId / description
      Added value: +"UUID returned by create_product_request or list_product_requests. The request must be visible in the selected scope."
    • addedInput schema / properties / scope / description
      Added value: +"mine (default) returns your requests; public returns other users public requests with private and safety details omitted."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "privateRequest": {
      +      "additionalProperties": false,
      +      "description": "Authenticated owner request including review and capture progress",
      +      "properties": {
      +        "createdAt": {
      +          "description": "ISO-8601 timestamp",
      +          "type": "string"
      +        },
      +        "history": {
      +          "description": "Result entries",
      +          "items": {
      +            "$ref": "#/$defs/requestHistory"
      +          },
      +          "type": "array"
      +        },
      +        "jobStatus": {
      +          "description": "jobStatus",
      +          "type": "string"
      +        },
      +        "payloadJson": {
      +          "description": "payloadJson",
      +          "type": "string"
      +        },
      +        "product": {
      +          "description": "product",
      +          "type": "string"
      +        },
      +        "progressStatus": {
      +          "description": "progressStatus",
      +          "type": "string"
      +        },
      +        "requestId": {
      +          "description": "requestId",
      +          "type": "string"
      +        },
      +        "requestType": {
      +          "description": "requestType",
      +          "type": "string"
      +        },
      +        "reviewedAt": {
      +          "anyOf": [
      +            {
      +              "description": "ISO-8601 timestamp",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "safetyStatus": {
      +          "description": "safetyStatus",
      +          "type": "string"
      +        },
      +        "status": {
      +          "description": "status",
      +          "type": "string"
      +        },
      +        "subject": {
      +          "description": "subject",
      +          "type": "string"
      +        },
      +        "url": {
      +          "description": "url",
      +          "type": "string"
      +        },
      +        "workflowStatus": {
      +          "description": "workflowStatus",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "requestId",
      +        "requestType",
      +        "product",
      +        "subject",
      +        "url",
      +        "status",
      +        "payloadJson",
      +        "createdAt",
      +        "history",
      +        "safetyStatus",
      +        "workflowStatus",
      +        "jobStatus",
      +        "progressStatus",
      +        "reviewedAt"
      +      ],
      +      "type": "object"
      +    },
      +    "publicRequest": {
      +      "additionalProperties": false,
      +      "description": "Other user public request with private review/safety fields omitted",
      +      "properties": {
      +        "createdAt": {
      +          "description": "ISO-8601 timestamp",
      +          "type": "string"
      +        },
      +        "history": {
      +          "description": "Result entries",
      +          "items": {
      +            "$ref": "#/$defs/requestHistory"
      +          },
      +          "type": "array"
      +        },
      +        "payloadJson": {
      +          "description": "payloadJson",
      +          "type": "string"
      +        },
      +        "product": {
      +          "description": "product",
      +          "type": "string"
      +        },
      +        "requestId": {
      +          "description": "requestId",
      +          "type": "string"
      +        },
      +        "requestType": {
      +          "description": "requestType",
      +          "type": "string"
      +        },
      +        "status": {
      +          "description": "status",
      +          "type": "string"
      +        },
      +        "subject": {
      +          "description": "subject",
      +          "type": "string"
      +        },
      +        "url": {
      +          "description": "url",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "requestId",
      +        "requestType",
      +        "product",
      +        "subject",
      +        "url",
      +        "status",
      +        "payloadJson",
      +        "createdAt",
      +        "history"
      +      ],
      +      "type": "object"
      +    },
      +    "request": {
      +      "anyOf": [
      +        {
      +          "$ref": "#/$defs/privateRequest"
      +        },
      +        {
      +          "$ref": "#/$defs/publicRequest"
      +        }
      +      ],
      +      "description": "Request fields vary with mine/public scope"
      +    },
      +    "requestHistory": {
      +      "additionalProperties": true,
      +      "description": "Public workflow transition",
      +      "properties": {
      +        "actor": {
      +          "description": "actor",
      +          "type": "string"
      +        },
      +        "at": {
      +          "description": "ISO-8601 timestamp",
      +          "type": "string"
      +        },
      +        "reason": {
      +          "description": "reason",
      +          "type": "string"
      +        },
      +        "status": {
      +          "description": "status",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "status",
      +        "reason",
      +        "actor",
      +        "at"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "description": "Structured result. Existing text or image content remains available in content.",
      +  "properties": {
      +    "result": {
      +      "$ref": "#/$defs/request"
      +    }
      +  },
      +  "required": [
      +    "result"
      +  ],
      +  "type": "object"
      +}
  3. First observed

TDQS

A4.4/5.0
Behavior5/5

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

Annotations only supply readOnlyHint=true, but the description goes well beyond that: it discloses data-visibility rules per scope (owner identity, private details, safety/review notes omitted in public), that workflow history and safety status are included for your own requests, and that capture progress is exposed without job IDs. These are behavioral traits the structured fields cannot convey.

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 front-loaded sentences that move from purpose to scope semantics to ID provenance with no filler. The clause 'Capture progress is exposed without job IDs' is terse but still earns its place as a behavioral disclosure.

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

Completeness5/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 an output schema and a readOnlyHint, the description covers the only real ambiguity — scope-dependent visibility and omissions — plus where to obtain requestId. Nothing an agent needs to invoke it correctly is missing.

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 both the scope enum and the requestId UUID provenance. The description largely restates those semantics, adding only slight emphasis on what the public scope strips out, so the baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Get a product request') and immediately defines the two retrieval modes and what each returns. The agent can distinguish this from list_product_requests because the description notes requestId comes from that tool.

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?

Explicitly explains the scope choice: 'scope=mine (default) returns your request' versus 'scope=public returns another user's public request', including what is omitted in each case. It does not mention alternatives such as wait_product_request for in-progress polling, so it falls short of full when/when-not guidance.

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