---
slug: agentes/mcp/arquivos/get
title: "get"
description: "Lê os metadados e o estado de ciclo de vida de um arquivo ou pasta; passe `fileId` ou `folderId`."
---

| Ferramenta | Tipo | Descrição |
| :-- | :-- | :-- |
| `get` | leitura | Lê os metadados e o estado de ciclo de vida de um arquivo ou pasta; passe `fileId` ou `folderId`. Um arquivo traz `readiness`, com o estado de cada capacidade que o tipo dele tem: `sql` (células), `search` (texto) e `diff` (`sheet_diff`). O `status` do arquivo é `ready` só quando todas estão prontas; senão, é o estado da menos pronta, e `stored` quando não há nada para ler: um tipo sem capacidade, como um vídeo, ou um documento sem texto. Fora de `ready` e `processing`, `statusMessage` diz o que fazer, como dividir a planilha em arquivos menores; para esperar, use `file_wait`. `fields` devolve só essas chaves, mais o `id`. |