narrador
Turns PDFs, Word files, EPUBs and X posts into narrated audio with word-level timings
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://api.narrador.io/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"narrador": {
"url": "https://api.narrador.io/mcp"
}
}
}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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media