filearchitect avatar

Blank Files MCP

filearchitect/blankfiles-website

Connects Claude to blankfiles.com's catalog of minimal valid blank files across dozens of formats. You get tools to list all available file types, filter by category (documents, media, archives, etc.), and retrieve direct CDN download URLs for each format. Useful when you need to generate test fixtures, stub out upload flows, or quickly grab a valid-but-empty PDF, XLSX, MP4, or ZIP without hunting one down manually. The server pulls from a live JSON catalog that includes metadata like MIME types and file sizes, so Claude can recommend the right blank file for your testing scenario and hand you a working URL in one shot.

tools
3
transport
STDIO
last updated
Feb 13, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

list_blank_fileslist files, optional filters (`category`, `type`, `limit`)

list files, optional filters (`category`, `type`, `limit`)

No parameter schema in public metadata yet.

files_by_typelist entries by extension

list entries by extension

No parameter schema in public metadata yet.

file_by_category_typedeterministic single lookup by category + extension

deterministic single lookup by category + extension

No parameter schema in public metadata yet.

Sponsors

Readme

Blank Files Website

Laravel application that powers blankfiles.com. Browse and download minimal valid blank files by type and category. File data and assets are served from the filearchitect/blank-files repository via a configurable CDN.

Requirements

  • PHP 8.2+
  • Composer
  • Node.js 18+ (for Vite frontend build)

Installation

git clone https://github.com/filearchitect/blankfiles-website.git
cd blankfiles-website
composer install
cp .env.example .env
php artisan key:generate

Set CDN_URL in .env (see Configuration). Then build the frontend and run the app:

npm install && npm run build
php artisan serve

Or use Laravel Herd with a .test domain.

Configuration


View the full README on GitHub

Details

Repository
github.com/filearchitect/blankfiles-website
Package
@filearchitect/blankfiles-mcp
Transport
STDIO
Registry
MCP registry, active