Developers
Hourlore MCP Server: documentary maker for AI agents
Connect your AI agent to https://hourlore.com/mcp (Streamable HTTP) with your API key to draft storyboard previews and render narrated 1080p documentaries.
Get an API key
Sign in with your email link and create a key under Account → API keys. The plaintext key is shown once. Keep it private—anyone holding it can spend credits on your account—and revoke it anytime if needed.
Connect
Claude Code
Export HOURLORE_API_KEY, then run in your terminal:
export HOURLORE_API_KEY="hl_..."
claude mcp add --transport http hourlore https://hourlore.com/mcp \
--header "Authorization: Bearer $HOURLORE_API_KEY"Cursor / Claude Desktop / Windsurf
Add to mcp.json:
{
"mcpServers": {
"hourlore": {
"type": "http",
"url": "https://hourlore.com/mcp",
"headers": {
"Authorization": "Bearer ${HOURLORE_API_KEY}"
}
}
}
}Codex CLI
Add to ~/.codex/config.toml and export HOURLORE_API_KEY:
[mcp_servers.hourlore]
url = "https://hourlore.com/mcp"
bearer_token_env_var = "HOURLORE_API_KEY"Tools
create_storyboard_preview: Generate a free 8–12 shot opening storyboard with Wikipedia research, script and Wikimedia Commons images.create_documentary_film: Queue a full 5, 10 or 15 minute 1080p narrated documentary MP4 (25, 50 or 75 credits).get_documentary_film: Check documentary status (with optional wait_seconds polling) and retrieve the 1-hour MP4 download URL + attribution text.cancel_documentary_film: Cancel a queued documentary before rendering begins and release held credits.get_credits: Read available and held credits on your Hourlore account (free).
Example prompts
- Draft a free Hourlore storyboard preview on "How the transatlantic telegraph cable finally worked in 1866" and summarize the opening shots.
- Queue a 10-minute Hourlore documentary narrated by Owen on "The 1971 DB Cooper hijacking", focusing on forensic clues.
- Check my Hourlore documentary job status and give me the MP4 download link and Wikimedia Commons credits when ready.
Calling from your own backend or script? See the HTTP API →
Credits and limits
- API keys share the credit balance on your Hourlore account (5 credits per finished minute: 25 for 5 min, 50 for 10 min, 75 for 15 min).
- Credits are held when a film is queued, settled when the MP4 finishes, and returned automatically if canceled or failed.
- Free storyboard previews via POST /api/v1/previews count toward your account limit (15/day).
- Finished MP4 files remain available for 7 days; each signed download_url expires after 1 hour (re-fetch GET /api/v1/films/:id for a fresh URL).
- Rate limit: 120 requests per minute per API key.