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.