Tool Details: archive_list

Basic Information

Tool Name:archive_list
Asset Name:List Archive
Description:List the entries of a zip or jar archive without extracting it. The archive source is exactly one of: a filesystem 'root'+'path' file, a resolvable 'contentRef', or inline base64 'bytes'. Returns each entry's name, uncompressed size, compressed size, directory flag, and modified time. Large archives are capped: 'count' is the true total, 'entries' is capped and 'truncated' indicates when more exist.
Adapter:archive
Asset Hash:0xc040c72af47b98c5ee99992869074804e8873d39bed36da3f5f3432dcf47f4ff
Input
PropertyTypeDescription
bytesstringBase64-encoded archive bytes (inline source)
rootstringConfigured file root of the archive (with 'path')
assetstringLegacy alias for contentRef
pathstringArchive file path relative to 'root'
contentRefstringResolvable reference to the archive bytes, including an asset, file:// root path, or DLFS path
Output
PropertyTypeDescription
entriesarrayEntry metadata (capped)
truncatedbooleanTrue if more entries exist than are listed
countintegerTrue total number of entries

MCP Tool Usage Examples

This tool can be called via the MCP (Model Context Protocol) endpoint. Here are examples of how to use it:

JSON-RPC Call Example:

POST to https://venue-3.covia.ai/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "archive_list",
    "arguments": {
      "input": "your input here"
    }
  }
}
cURL Example:
curl -X POST https://venue-3.covia.ai/mcp \\
  -H "Content-Type: application/json" \\
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "archive_list",
      "arguments": {
        "input": "your input here"
      }
    }
  }'
Python Example:
import requests
import json

url = "https://venue-3.covia.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "archive_list",
        "arguments": {
            "input": "your input here"
        }
    }
}

response = requests.post(url, json=payload)
result = response.json()
print(result)
JavaScript/Node.js Example:
const fetch = require('node-fetch');

const url = 'https://venue-3.covia.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'archive_list',
        arguments: {
            input: 'your input here'
        }
    }
};

fetch(url, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data));

Asset Metadata

{
  "name": "List Archive",
  "description": "List the entries of a zip or jar archive without extracting it. The archive source is exactly one of: a filesystem 'root'+'path' file, a resolvable 'contentRef', or inline base64 'bytes'. Returns each entry's name, uncompressed size, compressed size, directory flag, and modified time. Large archives are capped: 'count' is the true total, 'entries' is capped and 'truncated' indicates when more exist.",
  "creator": "Covia",
  "operation": {
    "adapter": "archive:list",
    "toolName": "archive_list",
    "input": {
      "type": "object",
      "properties": {
        "root": { "type": "string", "description": "Configured file root of the archive (with 'path')" },
        "path": { "type": "string", "description": "Archive file path relative to 'root'" },
        "contentRef": { "type": "string", "description": "Resolvable reference to the archive bytes, including an asset, file:// root path, or DLFS path" },
        "asset": { "type": "string", "deprecated": true, "description": "Legacy alias for contentRef" },
        "bytes": { "type": "string", "description": "Base64-encoded archive bytes (inline source)" }
      }
    },
    "output": {
      "type": "object",
      "properties": {
        "entries": { "type": "array", "description": "Entry metadata (capped)", "items": { "type": "object" } },
        "count": { "type": "integer", "description": "True total number of entries" },
        "truncated": { "type": "boolean", "description": "True if more entries exist than are listed" }
      }
    }
  }
}

Navigation

Back to adapter details

Back to all adapters

Back to index