# Hourlore

> Hourlore is a freemium MCP server for design and media. MCP server that drafts free documentary storyboards and renders narrated MP4 films. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $29 a month
- **Platforms:** API
- **Website:** https://hourlore.com/docs/mcp
- **Repository:** https://github.com/hourlore/hourlore-mcp
- **MCP Registry name:** com.hourlore/hourlore
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

A topic line becomes a documentary. The free preview tool researches the subject on Wikipedia and returns an 8 to 12 shot opening storyboard with script and Wikimedia Commons images in roughly 25 seconds; a paid tool then queues a full 5, 10 or 15 minute 1080p narrated MP4 with animated maps, number cards and word-by-word captions.

Credits drive the cost: 5 credits per finished minute, so 25, 50 or 75 per film. They are held when a film is queued, settled when the MP4 finishes and returned if it is cancelled or fails. A queued film can be cancelled before rendering begins, and status polling can wait up to 50 seconds. Finished files stay for 7 days behind signed download links that expire after an hour, with Wikimedia attribution text supplied.

Authentication uses a bearer API key created under Account. Free previews are limited to 15 a day through the API and the key is limited to 120 requests a minute. Narration comes in two voices, olivia and owen.

## Features

- **Free storyboard preview:** Researches a topic and drafts an 8 to 12 shot opening storyboard.
- **Full documentary render:** Queues a 5, 10 or 15 minute 1080p narrated MP4.
- **Credit holds:** Holds credits at queue time and returns them on cancel or failure.
- **Attribution text:** Returns Wikimedia Commons credits ready to paste.
- **Job status polling:** Checks render status with optional waiting.

## Good for

- Draft a storyboard for a history topic
- Queue a 10-minute narrated explainer
- Check job status and fetch the download link
- Check credit balance before rendering

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hourlore https://hourlore.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://hourlore.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hourlore": {
      "url": "https://hourlore.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hourlore": {
      "type": "http",
      "url": "https://hourlore.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hourlore": {
      "serverUrl": "https://hourlore.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hourlore": {
      "type": "http",
      "url": "https://hourlore.com/mcp"
    }
  }
}
```

## Tools

- `create_storyboard_preview`: Research a topic on Wikipedia and generate an 8–12 shot documentary opening storyboard with narration script, archive Wikimedia Commons CC-licensed images, maps and number cards (~25 seconds). Free (counts toward daily account preview limit).
- `create_documentary_film`: Submit a full 1080p 16:9 narrated faceless documentary render (5 min = 25 credits, 10 min = 50 credits, 15 min = 75 credits). Returns film_id in queued state; poll get_documentary_film until completed.
- `get_documentary_film`: Get the status of a documentary job by film_id (optionally waiting up to 50 seconds). When completed, returns a 1-hour MP4 download_url and description_text with Creative Commons image credits.
- `cancel_documentary_film`: Cancel a queued documentary before rendering begins and release its held credits back to the account.
- `get_credits`: Return available and held credits on this Hourlore account (5 credits = 1 minute of rendered film). Free.

## FAQ

### How many credits does a film cost?

25 for 5 minutes, 50 for 10 and 75 for 15; 5 credits per finished minute.

### How long do downloads last?

Files stay available for 7 days; each signed link expires after one hour.

### Are previews free?

Yes, up to 15 a day via the API.

### What are the plans?

Starter is $29 a month and Pro $59; credit packs start at $9. Paid plans are described as opening soon.

### Is Hourlore free?

Hourlore has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

### How do I add Hourlore to Claude Code?

Run this command in your terminal: claude mcp add --transport http hourlore https://hourlore.com/mcp

### What are the best alternatives to Hourlore?

The closest alternatives to Hourlore are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [PugSoda](https://ai-powered.com/mcp/pugsoda): PugSoda is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/hourlore
