Back to Browse

Narrador MCP Server

Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

Turn PDFs, Word, EPUB and X posts into narrated audio and videos with word timestamps.

About

Turn PDFs, Word, EPUB and X posts into narrated audio and videos with word timestamps.

Remote endpoints: streamable-http: https://api.narrador.io/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

Endpoint verified · Requires authentication · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

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

Documentation

View on GitHub

From the project's GitHub README.

narrador MCP server

smithery badge

narrador turns documents and X (Twitter) posts into natural narrated audio with word-level timestamps. Upload PDFs, Word, EPUBs or text, pick from multilingual voices (English, Spanish, Portuguese and regional accents), start audio generation jobs, check their status and download the audio with synced timings. Also generates audio and videos for X posts. Secure OAuth sign-in with your narrador.io account, no API key needed.

Remote Model Context Protocol server for narrador. It lets AI agents (Claude, Cursor, VS Code, Windsurf, ChatGPT and any MCP client) turn documents and X posts into natural-sounding audio.

  • narrador files: PDF, Word, EPUB and other documents → audio with word-level timings.
  • narrador X: X/Twitter posts → audio.
Endpointhttps://api.narrador.io/mcp (Streamable HTTP)
AuthOAuth 2.1 (recommended) or API key
REST API docshttps://api.narrador.io/docs
OpenAPIhttps://api.narrador.io/openapi.json
Websitehttps://narrador.io

Repository: https://github.com/narrador-io/narrador-mcp

This repository only holds the public listing (server.json) and documentation. The server is hosted by narrador, so there is nothing to install.

Tools

ToolProductWhat it does
get_accountbothShows the authenticated account and what it can use
list_voicesbothLists available voices and languages
create_files_jobnarrador filesStarts converting a document into audio
get_files_jobnarrador filesChecks the status of a conversion job
get_files_resultnarrador filesGets the audio and word timings of a finished job
generate_x_audionarrador XTurns an X post into audio
get_x_generationnarrador XChecks the status and result of an X generation

Authentication

OAuth (recommended). Add the URL https://api.narrador.io/mcp to your client. The client discovers the authorization server (https://narrador.io/api/auth), you sign in to narrador and approve access. Scopes: narrador:files, narrador:x.

API key. Create a key in the narrador web app and send it as Authorization: Bearer <key> or x-api-key: <key>. Keys are scoped per product:

ProductPrefix
narrador filesnrd_files_
narrador Xnrd_x_

Connect

Claude (claude.ai and Claude Desktop): custom connector

Settings → Connectors → Add custom connector → URL https://api.narrador.io/mcp → Connect, then sign in with OAuth.

Claude Code

claude mcp add --transport http narrador https://api.narrador.io/mcp
# or with an API key:
claude mcp add --transport http narrador https://api.narrador.io/mcp --header "Authorization: Bearer nrd_files_..."

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

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

With an API key, add "headers": { "Authorization": "Bearer nrd_files_..." }.

VS Code (.vscode/mcp.json)

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

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

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

Any other client

Point it to https://api.narrador.io/mcp (Streamable HTTP). If the client has no OAuth support, send an API key in the Authorization header.

Example prompts

  • "Convert this PDF into audio with narrador files and give me the link."
  • "Turn this X post into audio with narrador X: https://x.com/…/status/…"

License

MIT. See LICENSE.

Reviews

No reviews yet

Be the first to review this server!