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

Agent calls GET /x402/clip/{clip_id}/license
Server returns HTTP 402 with PAYMENT-REQUIRED header
Agent's x402 client signs a USDC payment authorization
Agent retries with PAYMENT-SIGNATURE header
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.

Stockfilm. Authentic Vintage Footage

Stockfilm MCP Server

Quick Start

Claude Code (one command)

Claude Desktop

Cursor / Windsurf / Other MCP Clients

What's in the Archive

Why This Footage Matters

Available Tools

`search_vintage_footage` (Free)

`get_clip_details` (Free)

`find_similar_footage` (Free)

`build_rough_cut` (Free)

`check_clip_rights` (Free)

`license_clip` ($10 USD)

Pricing

x402 Protocol Integration

How It Works

Supported Networks

Direct x402 Endpoints (No MCP Required)

Architecture

Discovery Endpoints

Full Agent API

About Stockfilm

License

संबंधित सर्वर

Project Handoffs

WP-MCP

Outline MCP Server

Sequential Story

Helios-9

Rememberizer

Browser

incident.io

Todoist

Trello

Stockfilm. Authentic Vintage Footage

Stockfilm MCP Server

Quick Start

Claude Code (one command)

Claude Desktop

Cursor / Windsurf / Other MCP Clients

What's in the Archive

Why This Footage Matters

Available Tools

search_vintage_footage (Free)

get_clip_details (Free)

find_similar_footage (Free)

build_rough_cut (Free)

check_clip_rights (Free)

license_clip ($10 USD)

Pricing

x402 Protocol Integration

How It Works

Supported Networks

Direct x402 Endpoints (No MCP Required)

Architecture

Discovery Endpoints

Full Agent API

About Stockfilm

License

संबंधित सर्वर

Project Handoffs

WP-MCP

Outline MCP Server

Sequential Story

Helios-9

Rememberizer

Browser

incident.io

Todoist

Trello

`search_vintage_footage` (Free)

`get_clip_details` (Free)

`find_similar_footage` (Free)

`build_rough_cut` (Free)

`check_clip_rights` (Free)

`license_clip` ($10 USD)