# Hourlore

The Hourlore MCP server for Claude Code turns a topic into a storyboard or a narrated documentary. Start with a free preview, or queue a full film for rendering.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: hourlore
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hourlore/hourlore-mcp
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/hourlore

## What it does

Hourlore researches a topic through Wikipedia and builds an opening storyboard with 8–12 shots, a script, archival images, maps, and number cards. Preview generation is free and subject to a daily limit.

For a full film, the server queues a narrated 1080p MP4 lasting 5, 10, or 15 minutes. Rendering costs 25, 50, or 75 credits; five credits equal one finished minute. Other tools report render status, return a download link, show the credit balance, or cancel a queued job before rendering starts.

Connecting requires an Hourlore API key set as `HOURLORE_API_KEY` and access to the Hourlore service. The MP4 download link lasts one hour, and the server returns Wikimedia Commons attribution text.

## Requirements
- Remote server: `https://hourlore.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http hourlore https://hourlore.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add hourlore --url https://hourlore.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hourlore": {
            "url": "https://hourlore.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hourlore": {
            "type": "http",
            "url": "https://hourlore.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http hourlore https://hourlore.com/mcp
```

## When to use it
- create a topic-based storyboard preview
- queue a narrated documentary MP4
- check a render and retrieve its download link
- check available and held credits
- cancel a film before rendering begins

## Example prompts
- Create a free documentary preview about cities lost underwater.
- Make a 10-minute narrated documentary about the Apollo 11 mission.
- Check my film's status and return its download link.

## Similar
- [vox-explainer](https://affpapa.org/en/nevibecode/skills/vox-explainer.md) — skill · 3800 installs
- [cinematic-skill](https://affpapa.org/en/nevibecode/plugins/cinematic-skill.md) — plugin · ★ 884 repo stars
- [vsl-storyboard-writer](https://affpapa.org/en/nevibecode/skills/vsl-storyboard-writer.md) — skill · 508 installs
- [scriptwriting](https://affpapa.org/en/nevibecode/skills/scriptwriting.md) — skill · 335 installs
- [storyboard-previsualization](https://affpapa.org/en/nevibecode/skills/storyboard-previsualization.md) — skill · 301 installs
- [educational-animation-production](https://affpapa.org/en/nevibecode/skills/educational-animation-production.md) — skill · 162 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
