Stockfilm MCP Server

Search and license 217,000+ authentic vintage home movie clips from the 1930s-1980s.

Stockfilm is the largest curated archive of restored vintage home-movie footage available for licensing. This MCP server lets AI agents discover, preview, and license archival clips directly through the Model Context Protocol.

Every clip is real 8mm, Super 8, or 16mm film shot by ordinary families across the United States and around the world. Professionally scanned, digitally restored (dust/scratch removal, stabilization, color correction), and cataloged with metadata including shot year, location, and descriptive tags. No AI-generated content. Every frame is real archival film.

---

Quick Start

Claude Code (one command)

claude mcp add --transport http stockfilm https://api.stockfilm.com/mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "stockfilm": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.stockfilm.com/mcp"]
    }
  }
}

Cursor / Windsurf / Other MCP Clients

Server URL: https://api.stockfilm.com/mcp
Transport:  Streamable HTTP
Auth:       None required

---

What's in the Archive

Category	Examples	Decades
Family Life	Backyard barbecues, birthday parties, holidays, baby's first steps	1930s-1980s
Travel & Vacation	Road trips, national parks, beach holidays, camping	1940s-1970s
Holidays	Christmas morning, Easter, Thanksgiving, 4th of July	1930s-1980s
Suburban America	Neighborhoods, new homes, lawn care, swimming pools	1950s-1970s
Cars & Driving	Classic cars, highway driving, gas stations, car culture	1940s-1970s
Schools & Graduations	Classrooms, school plays, proms, college campuses	1950s-1970s
Sports & Activities	Little League, fishing, skiing, bowling, roller skating	1950s-1970s
International	European vacations, world fairs, military bases abroad	1940s-1960s
Cities & Streets	Downtown streets, storefronts, neon signs, public transit	1930s-1970s
Nature & Outdoors	Mountains, lakes, forests, wildlife, farming	1940s-1970s

217,000+ clips across all categories. Most footage is from the United States, with significant international coverage from Europe, Asia, and Latin America.

Why This Footage Matters

• Irreplaceable - These are one-of-a-kind family films that cannot be recreated
• Authentic - Real film grain, period color, original aspect ratios preserved
• Restored - Professional 4K scanning with digital restoration
• Cataloged - Metadata includes shot year, location, and descriptive tags
• Licensed - Royalty-free, worldwide, perpetual license per clip

---

Available Tools

The MCP server exposes 6 tools:

search_vintage_footage (Free)

Search the archive by text query with optional year range and location filters.

"Find 1960s California family barbecue footage"
"Christmas morning clips from the 1950s"
"Beach vacation footage, 1940s to 1960s"

Parameters:

• query (required) - Natural language search. Be descriptive for best results.
• limit (optional) - Number of results, 1-50. Default: 10.
• year_from (optional) - Earliest year filter (e.g., 1950).
• year_to (optional) - Latest year filter (e.g., 1969).
• location (optional) - Location filter (city, state, or country).

get_clip_details (Free)

Get full metadata for a specific clip: title, description, duration, tags, thumbnail URL, pricing, and license URL.

Parameters:

• clip_id (required) - The clip ID from search results.

find_similar_footage (Free)

Find visually similar clips by providing a clip ID. Uses visual similarity matching to find footage with similar content, color palette, or scene composition.

Parameters:

• clip_id (required) - Clip ID to find similar footage for.
• limit (optional) - Number of results, 1-25. Default: 10.

build_rough_cut (Free)

Auto-assemble a timed sequence of vintage clips into a video timeline based on a natural language description. Returns an ordered list of clips with durations. Great for creating edit lists, storyboards, or mood reels.

Parameters:

• query (required) - Description of the video sequence (e.g., "american road trip summer vacation 1960s").
• target_seconds (optional) - Target timeline length in seconds, 20-600. Default: 60.
• pace (optional) - Editing pace: "slow" (4-8s/clip), "balanced" (3-6s/clip), "fast" (2-4s/clip). Default: "balanced".
• year_from / year_to (optional) - Year range filters.

check_clip_rights (Free)

Verify that a clip is eligible for a specific intended use before licensing.

Parameters:

• clip_id (required) - The clip ID to check.
• intended_use (optional) - One of: "commercial", "editorial", "broadcast", "digital", "ai_training". Default: "commercial".

license_clip ($10 USD)

License a clip for download. Returns the x402 protocol endpoint for payment. Payment is handled via x402 using USDC on Solana or Base.

Parameters:

• clip_id (required) - The clip ID to license.

---

Pricing

Format	Price	Details
144p preview	$10 USD	Instant via x402 USDC (Solana or Base)
HD (1080p)	Contact us	Available on request
4K (2160p)	Contact us	Available on request

License terms: Royalty-free, worldwide, perpetual, one-time purchase. Use in commercial projects, documentaries, editorial content, digital media, and AI training datasets.

---

x402 Protocol Integration

The licensing endpoint uses the x402 protocol (V2) for instant, trustless payments. Any x402-compatible agent or wallet can license clips without API keys or sign-up.

How It Works

1. Agent calls GET /x402/clip/{clip_id}/license
2. Server returns HTTP 402 with PAYMENT-REQUIRED header
3. Agent's x402 client signs a USDC payment authorization
4. Agent retries with PAYMENT-SIGNATURE header
5. Server verifies and settles via facilitator, returns license + download URL

Supported Networks

Network	Chain ID (CAIP-2)	Token	Receiving Address
Solana mainnet	solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp	USDC	FERR1XDCsvLRzU8U29baMY4XvZ8kwk52tUjqy3SaDRtQ
Base mainnet	eip155:8453	USDC	0x4AeeD280b6006Aa354e09427AF4F49bD09f9447B

Direct x402 Endpoints (No MCP Required)

# Search (free, no auth)
curl "https://api.stockfilm.com/x402/search?q=beach+1960s&limit=5"

# Clip details (free)
curl "https://api.stockfilm.com/x402/clip/120818702"

# Rights check (free)
curl "https://api.stockfilm.com/x402/clip/120818702/rights?intended_use=commercial"

# License (returns 402 with payment instructions)
curl "https://api.stockfilm.com/x402/clip/120818702/license"

---

Architecture

This MCP server is a remote Streamable HTTP server embedded in the Stockfilm Agent API (Rust/Axum). It does not require local installation -- agents connect directly over HTTPS.

Agent (Claude, GPT, etc.)
  |
  | MCP Streamable HTTP
  v
api.stockfilm.com/mcp
  |
  | Internal API calls
  v
Stockfilm Agent API (Rust/Axum)
  |
  +-- Search (PostgreSQL full-text + visual embeddings)
  +-- Rights verification
  +-- x402 payment processing (facilitator-mediated)
  +-- License management
  +-- Download token generation

Discovery Endpoints

Endpoint	Purpose
https://api.stockfilm.com/.well-known/mcp.json	MCP server discovery
https://api.stockfilm.com/.well-known/stockfilm-agent.json	Full agent manifest
https://api.stockfilm.com/llms.txt	LLM-readable service index
https://api.stockfilm.com/v1/capabilities	Machine-readable capability surface
https://stockfilm.com/for-ai-agents	Complete API documentation

---

Full Agent API

Beyond MCP, Stockfilm offers a complete agent-native API with HMAC-SHA256 request signing, multi-step licensing workflows, webhooks, and TypeScript/Python SDKs:

• API Base: https://api.stockfilm.com
• Auth: API key + HMAC-SHA256 signing for mutations
• Payment Rails: Solana USDC, Solana SOL, Lightning BTC
• Docs: stockfilm.com/for-ai-agents

---

About Stockfilm

Stockfilm specializes in authentic archival home-movie footage -- the kind of footage that cannot be recreated by AI or restaged in a studio. Every reel was shot on real film by real families, capturing genuine moments from mid-20th-century life.

The archive includes footage from across the United States and around the world: suburban neighborhoods, family vacations, holiday celebrations, school events, road trips, city streets, and everyday life from an era that exists only on film.

Website: stockfilm.com Browse Clips: stockfilm.com/browse Popular Clips: stockfilm.com/popular Curated Collections: stockfilm.com/curated Agent Docs: stockfilm.com/for-ai-agents Contact: stockfilm.com/contact

---

License

The MCP server wrapper is open source under the MIT License.

The archival footage itself is proprietary content licensed per-clip through Stockfilm. Each clip purchase grants a royalty-free, worldwide, perpetual license for the specified use.