{"uid":"cap_6JBPhXZ6CrCqYFwahPGwy","slug":"grist-tools-archive-inspect-e48c128d","name":"grist.tools Archive Inspect","description":"One endpoint does one thing, always the same way, for a fraction of a cent. Payment is verified before the handler runs and settled only after it succeeds, so a rejected or failed call is never a charged call.","url":"https://grist.tools/v1/archive-inspect?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"Absolute http(s) URL of the archive (at most 100 MB, also the cap on an inflated tar.gz), up to 2048 characters; redirects are followed and the format (zip, tar or gzip-compressed tar) is decided from the magic bytes, not the extension."},"max_entries":{"type":"integer","description":"How many entries to list, 1 to 10000 (default 1000), taken in archive order and then sorted by name; any beyond the limit still count in total_entries and set truncated."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RzCs7Khh8wc6ooBQ1OveG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Inspects a remote archive file (ZIP, TAR, or gzipped TAR) and returns a listing of its entries and metadata","exampleAgentPrompt":"Can you inspect the archive at https://example.com/release-v2.tar.gz and list up to 500 of its file entries?","exampleUseCases":[{"title":"Preview open-source release contents","prompt":"I found this release tarball at https://github.com/someorg/project/archive/refs/tags/v1.0.0.tar.gz — can you list the first 200 files inside it so I can see what's included before I download the whole thing?"},{"title":"Verify backup archive integrity","prompt":"Check what files are inside this backup archive at https://backups.myserver.com/daily-backup-2024-01-15.zip and tell me the total number of entries — I want to make sure everything got included."},{"title":"Audit dataset archive structure","prompt":"Can you inspect https://datasets.example.com/training-data.tar.gz and list up to 5000 file entries? I need to understand the folder structure and file naming convention before I write my data loader."}],"resultDescription":"Returns a structured list of archive entries (file names/paths) sorted by name, the total entry count, whether the result was truncated, and the detected archive format — all derived from the archive's magic bytes rather than its file extension.","failureModes":["Archive exceeds 100 MB size limit — returns an error","URL is unreachable or returns non-200 response — fetch failure","Archive format is not ZIP, TAR, or gzipped TAR — unsupported format error","URL exceeds 2048 character limit — validation error","max_entries outside 1–10000 range — validation error","Payment verification fails — call is rejected and not charged","Archive is corrupted or malformed — parse error"],"whenToPreferThis":"Use this endpoint when you need to inspect the contents of a remote archive file without fully downloading and processing it yourself. It handles format detection automatically from magic bytes, supports ZIP, TAR, and gzipped TAR, follows redirects, and charges only on success — making it ideal for lightweight, one-off archive inspection tasks in an agent workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T01:36:46.317Z","isFirstParty":false,"canonicalSlug":"grist-tools-archive-inspect-e48c128d"}