Skip to content
MCP server

narrador

Turns PDFs, Word files, EPUBs and X posts into narrated audio with word-level timings

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.0.3
Listing updated
2 days ago

About narrador

narrador is a freemium MCP server for design and media. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://api.narrador.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "narrador": {
      "url": "https://api.narrador.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $2 a month

Starts with 1,000 credits; pay as you go or from $2/mo

Prices change. Check narrador.io before you buy.

narrador 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 to narrador

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media