MCP server for interacting with IPFS (InterPlanetary File System) - enables uploading, retrieving, pinning, and listing files on IPFS
Server has 5 tools with basic schemas and descriptions, but significant quality gaps. All tools have Zod schemas with type definitions and descriptions present, meeting minimum requirements. However, descriptions are generic and lack actionable context (avg ~50 chars, well below 194-char baseline). No parameter constraints (enums, ranges, patterns). Error handling is minimal, failures return generic text without recovery guidance. No output schema documentation. Tools lack idempotency hints and permission declarations. Naming is verb-based (upload, get, pin, list, unpin) but descriptions don't explain WHEN to use each tool or dependencies between them. No batch operations or pagination despite list-folder potentially returning large results.
Retrieve a file from IPFS using its CID.
List contents of an IPFS directory
Pin a file in IPFS using it's CID
Unpin a file from IPFS
Upload a file to IPFS and get its CID.
Descriptions lack actionable context. 'Pin a file in IPFS using it's CID' (35 chars) does not explain WHEN to use pin vs upload, what pinning does, or consequences. Baseline is 194 chars with WHAT/WHEN/WHY.
No input validation or constraints. CID parameters accept any string; no regex pattern, length limit, or format validation. LLMs will pass invalid CIDs, causing silent API failures.
Error handling is generic and non-actionable. 'Failed to pin file on IPFS' gives no recovery path. Should return: 'CID not found. Verify CID is valid (e.g., QmXxxx...) or call upload-file first.'
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | 2026-07-28+ | v2 |
No output schema documentation. Responses are free-text strings; LLMs cannot parse structured results or chain to downstream tools. Should return JSON with fields: {cid, size, status, timestamp}.
list-folder has no pagination or result limits. Large directories could return thousands of items, exhausting context window. Should accept limit (default 20) and offset/cursor parameters.