Skip to main content
Glama

Get project export

get_project_export
Read-onlyIdempotent

Return an export snapshot with status, progress, errors, and downloadUrl, exportFileId, thumbnailUrl, and file metadata when ready. Poll until status is succeeded, failed, or cancelled.

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": {
      "projectId": "<projectId>",
      "exportId": "<exportId>"
    },
    "name": "get_project_export"
  }
}

Input Schema

NameRequiredDescriptionDefault
exportIdYesExport id (vg_expo_...) from export_project.
projectIdYesProject that owns the export. Use the same projectId passed to export_project, obtained from a workflow result or list_projects.

Output Schema

NameRequiredDescriptionDefault
fileNoHydrated export file metadata.
errorNoError details when status is failed; otherwise null.
statusNoJob status: pending, running, succeeded, failed, or cancelled.
exportIdYesExport id (vg_expo_...).
projectIdNoExported project id (present after polling).
downloadUrlNoSigned MP4 download URL when succeeded; otherwise null.
attemptIndexNoCurrent or latest attempt index.
exportFileIdNoExported MP4 file id when succeeded.
thumbnailUrlNoSigned thumbnail URL when ready.
progressPercentageNoCompletion progress 0-100 (present after polling).
downloadUrlExpiresAtNoUnix expiry for downloadUrl.
thumbnailUrlExpiresAtNoUnix expiry for thumbnailUrl.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changed
    • removedOutput schema / properties / downloadUrl / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / downloadUrl / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / downloadUrlExpiresAt / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / downloadUrlExpiresAt / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • changedOutput schema / properties / error / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "code": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Machine-readable error code."
      -      },
      -      "internalErrorCode": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Opaque code for support."
      -      },
      -      "message": {
      -        "description": "Human-readable error description.",
      -        "type": "string"
      -      },
      -      "requirement": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "details": {
      -                "additionalProperties": {
      -                  "type": "string"
      -                },
      -                "propertyNames": {
      -                  "type": "string"
      -                },
      -                "type": "object"
      -              },
      -              "type": {
      -                "description": "Requirement type (e.g. purchase_add_on).",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "type"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "What is needed to resolve the error, when applicable."
      -      }
      -    },
      -    "required": [
      -      "message"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "code": {
      +        "description": "Machine-readable error code.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "internalErrorCode": {
      +        "description": "Opaque code for support.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "message": {
      +        "description": "Human-readable error description.",
      +        "type": "string"
      +      },
      +      "requirement": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "details": {
      +                "additionalProperties": {
      +                  "type": "string"
      +                },
      +                "propertyNames": {
      +                  "type": "string"
      +                },
      +                "type": "object"
      +              },
      +              "type": {
      +                "description": "Requirement type (e.g. purchase_add_on).",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "type"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "What is needed to resolve the error, when applicable."
      +      }
      +    },
      +    "required": [
      +      "message"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / exportFileId / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / exportFileId / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / file / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "description": "File metadata with signed URLs when hydrated.",
      -    "properties": {
      -      "description": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "File description when analyzed."
      -      },
      -      "displayName": {
      -        "description": "Display name for the file.",
      -        "type": "string"
      -      },
      -      "downloadSource": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "description": "A file rendition source (thumbnail, preview, download, …).",
      -            "properties": {
      -              "expiresAt": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Unix expiry for url."
      -              },
      -              "fileBytes": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Rendition size in bytes."
      -              },
      -              "height": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Rendition height in pixels."
      -              },
      -              "status": {
      -                "description": "Rendition status.",
      -                "enum": [
      -                  "pending",
      -                  "ready",
      -                  "failed",
      -                  "skipped"
      -                ],
      -                "type": "string"
      -              },
      -              "url": {
      -                "anyOf": [
      -                  {
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Signed URL when status is ready."
      -              },
      -              "width": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Rendition width in pixels."
      -              }
      -            },
      -            "required": [
      -              "status"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "downloadUrl": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Signed download URL when ready."
      -      },
      -      "downloadUrlExpiresAt": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Unix expiry for downloadUrl."
      -      },
      -      "durationSeconds": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Duration in seconds for video/audio; null for images."
      -      },
      -      "fileId": {
      -        "description": "File id (vg_file_...).",
      -        "type": "string"
      -      },
      -      "hlsSource": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "description": "A file rendition source (thumbnail, preview, download, …).",
      -            "properties": {
      -              "expiresAt": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Unix expiry for url."
      -              },
      -              "fileBytes": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Rendition size in bytes."
      -              },
      -              "height": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Rendition height in pixels."
      -              },
      -              "status": {
      -                "description": "Rendition status.",
      -                "enum": [
      -                  "pending",
      -                  "ready",
      -                  "failed",
      -                  "skipped"
      -                ],
      -                "type": "string"
      -              },
      -              "url": {
      -                "anyOf": [
      -                  {
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Signed URL when status is ready."
      -              },
      -              "width": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Rendition width in pixels."
      -              }
      -            },
      -            "required": [
      -              "status"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "isPublicPreviewEnabled": {
      -        "type": "boolean"
      -      },
      -      "previewSource": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "description": "A file rendition source (thumbnail, preview, download, …).",
      -            "properties": {
      -              "expiresAt": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Unix expiry for url."
      -              },
      -              "fileBytes": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Rendition size in bytes."
      -              },
      -              "height": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Rendition height in pixels."
      -              },
      -              "status": {
      -                "description": "Rendition status.",
      -                "enum": [
      -                  "pending",
      -                  "ready",
      -                  "failed",
      -                  "skipped"
      -                ],
      -                "type": "string"
      -              },
      -              "url": {
      -                "anyOf": [
      -                  {
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Signed URL when status is ready."
      -              },
      -              "width": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Rendition width in pixels."
      -              }
      -            },
      -            "required": [
      -              "status"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "publicHlsUrl": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "publicPlaybackId": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "scope": {
      -        "description": "File scope.",
      -        "enum": [
      -          "GLOBAL",
      -          "PROJECT",
      -          "EXPORT",
      -          "TEMPORARY",
      -          "ENTITY"
      -        ],
      -        "type": "string"
      -      },
      -      "sourceToolExecutionId": {
      -        "type": "string"
      -      },
      -      "sourceToolType": {
      -        "type": "string"
      -      },
      -      "thumbnailSource": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "description": "A file rendition source (thumbnail, preview, download, …).",
      -            "properties": {
      -              "expiresAt": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Unix expiry for url."
      -              },
      -              "fileBytes": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Rendition size in bytes."
      -              },
      -              "height": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Rendition height in pixels."
      -              },
      -              "status": {
      -                "description": "Rendition status.",
      -                "enum": [
      -                  "pending",
      -                  "ready",
      -                  "failed",
      -                  "skipped"
      -                ],
      -                "type": "string"
      -              },
      -              "url": {
      -                "anyOf": [
      -                  {
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Signed URL when status is ready."
      -              },
      -              "width": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Rendition width in pixels."
      -              }
      -            },
      -            "required": [
      -              "status"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "thumbnailUrl": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Signed thumbnail URL when available."
      -      },
      -      "thumbnailUrlExpiresAt": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Unix expiry for thumbnailUrl."
      -      },
      -      "transcriptText": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Plain transcript text when available."
      -      },
      -      "type": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "File type once processing has determined it."
      -      }
      -    },
      -    "required": [
      -      "fileId"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "description": "File metadata with signed URLs when hydrated.",
      +    "properties": {
      +      "description": {
      +        "description": "File description when analyzed.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "displayName": {
      +        "description": "Display name for the file.",
      +        "type": "string"
      +      },
      +      "downloadSource": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "description": "A file rendition source (thumbnail, preview, download, …).",
      +            "properties": {
      +              "expiresAt": {
      +                "description": "Unix expiry for url.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fileBytes": {
      +                "description": "Rendition size in bytes.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "height": {
      +                "description": "Rendition height in pixels.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "status": {
      +                "description": "Rendition status.",
      +                "enum": [
      +                  "pending",
      +                  "ready",
      +                  "failed",
      +                  "skipped"
      +                ],
      +                "type": "string"
      +              },
      +              "url": {
      +                "description": "Signed URL when status is ready.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "width": {
      +                "description": "Rendition width in pixels.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "status"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "downloadUrl": {
      +        "description": "Signed download URL when ready.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "downloadUrlExpiresAt": {
      +        "description": "Unix expiry for downloadUrl.",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "durationSeconds": {
      +        "description": "Duration in seconds for video/audio; null for images.",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "fileId": {
      +        "description": "File id (vg_file_...).",
      +        "type": "string"
      +      },
      +      "hlsSource": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "description": "A file rendition source (thumbnail, preview, download, …).",
      +            "properties": {
      +              "expiresAt": {
      +                "description": "Unix expiry for url.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fileBytes": {
      +                "description": "Rendition size in bytes.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "height": {
      +                "description": "Rendition height in pixels.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "status": {
      +                "description": "Rendition status.",
      +                "enum": [
      +                  "pending",
      +                  "ready",
      +                  "failed",
      +                  "skipped"
      +                ],
      +                "type": "string"
      +              },
      +              "url": {
      +                "description": "Signed URL when status is ready.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "width": {
      +                "description": "Rendition width in pixels.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "status"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "isPublicPreviewEnabled": {
      +        "type": "boolean"
      +      },
      +      "previewSource": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "description": "A file rendition source (thumbnail, preview, download, …).",
      +            "properties": {
      +              "expiresAt": {
      +                "description": "Unix expiry for url.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fileBytes": {
      +                "description": "Rendition size in bytes.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "height": {
      +                "description": "Rendition height in pixels.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "status": {
      +                "description": "Rendition status.",
      +                "enum": [
      +                  "pending",
      +                  "ready",
      +                  "failed",
      +                  "skipped"
      +                ],
      +                "type": "string"
      +              },
      +              "url": {
      +                "description": "Signed URL when status is ready.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "width": {
      +                "description": "Rendition width in pixels.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "status"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "publicHlsUrl": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "publicPlaybackId": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "scope": {
      +        "description": "File scope.",
      +        "enum": [
      +          "GLOBAL",
      +          "PROJECT",
      +          "EXPORT",
      +          "TEMPORARY",
      +          "ENTITY"
      +        ],
      +        "type": "string"
      +      },
      +      "sourceToolExecutionId": {
      +        "type": "string"
      +      },
      +      "sourceToolType": {
      +        "type": "string"
      +      },
      +      "thumbnailSource": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "description": "A file rendition source (thumbnail, preview, download, …).",
      +            "properties": {
      +              "expiresAt": {
      +                "description": "Unix expiry for url.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fileBytes": {
      +                "description": "Rendition size in bytes.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "height": {
      +                "description": "Rendition height in pixels.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "status": {
      +                "description": "Rendition status.",
      +                "enum": [
      +                  "pending",
      +                  "ready",
      +                  "failed",
      +                  "skipped"
      +                ],
      +                "type": "string"
      +              },
      +              "url": {
      +                "description": "Signed URL when status is ready.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "width": {
      +                "description": "Rendition width in pixels.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "status"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "thumbnailUrl": {
      +        "description": "Signed thumbnail URL when available.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "thumbnailUrlExpiresAt": {
      +        "description": "Unix expiry for thumbnailUrl.",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "transcriptText": {
      +        "description": "Plain transcript text when available.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "type": {
      +        "description": "File type once processing has determined it.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "fileId"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / thumbnailUrl / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / thumbnailUrl / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / thumbnailUrlExpiresAt / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / thumbnailUrlExpiresAt / type
      Added value: +[
      +  "number",
      +  "null"
      +]
  2. Changed1 schema field changed
    • changedInput schema / properties / projectId / description
      Previous value: -"Project id that owns the export."New value: +"Project that owns the export. Use the same projectId passed to export_project, obtained from a workflow result or list_projects."
  3. First observed

TDQS

A4/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, non-destructive behavior, so the bar is lower; the description still adds value by revealing the terminal-state set and the polling contract, plus which fields become available 'when ready'. It does not state recommended poll intervals or rate limits, keeping it from a 5.

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?

Two tight sentences with no filler; the return payload is front-loaded and the polling instruction second. Every clause carries information an agent needs.

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 status-read tool with a full output schema and rich annotations, the description covers the essentials: what comes back, when it is populated, and how to poll. It stops just short of explicitly linking back to export_project as the prerequisite step.

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 both parameters are documented in-schema, including that exportId comes from export_project. The description adds no syntax or constraint detail beyond that, so the baseline of 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 action on a specific resource ('return an export snapshot') and enumerates what the snapshot contains (status, progress, errors, downloadUrl, exportFileId, thumbnailUrl, file metadata). This distinguishes it from siblings like export_project, which creates the export, but the description never names that 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?

Gives concrete operational guidance: poll until status is succeeded, failed, or cancelled, which tells the agent exactly how to drive this tool. It lacks an explicit statement that export_project must be called first to obtain the exportId, though the schema parameter description covers that.

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.