# narrador

> narrador is a freemium MCP server for design and media. Turns PDFs, Word files, EPUBs and X posts into narrated audio with word-level timings. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $2 a month
- **Platforms:** API, Web
- **Website:** https://narrador.io
- **Repository:** https://github.com/narrador-io/narrador-mcp
- **MCP Registry name:** io.narrador/narrador
- **Categories:** design and media, files and documents
- **Listing updated:** 2026-11-14

## About

narrador is a hosted text-to-speech service with two products, narrador files and narrador X, and this server gives agents access to both. Files accepts plain text or an uploaded document and returns audio together with word-level timings, which the web app uses for highlighting while you listen. X turns posts into audio.

Voice choice is optional. If you leave it out, narrador detects the document language (English, Spanish or Brazilian Portuguese) and picks a standard-tier voice, or a cheaper one if none exists. If the detected language has no supported voice, the job ends with a failure and you must pass a voice and accent.

The server is remote and nothing installs locally. Sign in with OAuth or use an API key, and usage is metered in credits you buy in the web app.

## Features

- **Document narration:** Starts jobs from text up to 500,000 characters or an uploaded file.
- **Word-level timings:** Returns audio with synced word timings for highlighting.
- **X post audio:** Generates narrated audio from an X post.
- **Voice and accent choice:** Lists voices by product and lets you pick a voice and accent.
- **Credit balance check:** Shows account credits without spending any.

## Good for

- Listen to a PDF or EPUB while commuting
- Build read-along text with highlighted words
- Let an agent narrate a thread from X
- Produce MP3 narration from documents in a pipeline

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http narrador https://api.narrador.io/mcp
```

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

```sh
https://api.narrador.io/mcp
```

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

```json
{
  "mcpServers": {
    "narrador": {
      "url": "https://api.narrador.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "narrador": {
      "type": "http",
      "url": "https://api.narrador.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "narrador": {
      "serverUrl": "https://api.narrador.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "narrador": {
      "type": "http",
      "url": "https://api.narrador.io/mcp"
    }
  }
}
```

## Tools

- `get_account`: Returns identity, product scope and credit balances without consuming credits.
- `list_voices`: Lists voices for narrador files or narrador X.
- `create_files_job`: Starts a document or text to audio job.
- `get_files_job`: Polls the status and progress of a files job.
- `get_files_result`: Downloads audio and word timings for a completed job.
- `generate_x_audio`: Generates audio for an X post.
- `get_x_generation`: Fetches a generation created earlier.

## FAQ

### Which tools does it expose?

Seven: get_account, list_voices, create_files_job, get_files_job, get_files_result, generate_x_audio and get_x_generation.

### How do I sign in?

Use OAuth 2.1, which is recommended, or a product API key.

### How is it priced?

Usage is metered in credits. The site says new users start with 1,000 credits, and credits never expire.

### Does anything run locally?

No. The server is hosted by narrador.

### Is narrador free?

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

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

Run this command in your terminal: claude mcp add --transport http narrador https://api.narrador.io/mcp

### What are the best alternatives to narrador?

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

## 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.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [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.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

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