narrador

MCP y REST API

API de texto a voz y servidor MCP para agentes de IA

Dale a tus agentes una API de texto a voz y un servidor MCP. Conectate en https://api.narrador.io/mcp con OAuth o una API key, o usá la referencia REST en https://api.narrador.io/docs.

  • Documentos con narrador files

    create_files_job o POST /v1/files/generate. Sin voiceId, la voz sigue el idioma del documento.

  • Posts de X con narrador X

    generate_x_audio devuelve audio, no video. El video se exporta en la app.

  • Los mismos créditos, MCP o REST

    Conectate con OAuth en Cursor, Claude Desktop o VS Code, o usá una key nrd_files_ o nrd_x_.

Abrí los docs de la API

Cursor, Claude Desktop y VS Code

Configuración MCP remota — las mismas muestras que la docs de la API. Los clientes con OAuth MCP remoto solo necesitan la URL, incluidos Cursor, Claude Desktop y VS Code. Las API keys siguen siendo la alternativa: nrd_files_ para herramientas de narrador files, nrd_x_ para narrador X.

Agregala a .cursor/mcp.json del proyecto, o a ~/.cursor/mcp.json para todos.

OAuth

Recomendado si el cliente soporta MCP OAuth remoto. Solo la URL — después iniciá sesión. Scopes: narrador:files, narrador:x.

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

API key

Alternativa para clientes y scripts. La misma URL más Authorization Bearer o x-api-key.

{
  "mcpServers": {
    "narrador": {
      "url": "https://api.narrador.io/mcp",
      "headers": {
        "Authorization": "Bearer nrd_files_YOUR_SECRET_KEY"
      }
    }
  }
}

Límites

Rate limit
60 solicitudes por 60 segundos por API key. El exceso responde HTTP 429.
Tamaño de archivo
Máximo 50 MB por subida de archivo y por descarga por URL en rutas de narrador files.
Texto plano
Hasta 500.000 caracteres en el campo text de POST /v1/files/generate y POST /v1/files/jobs.

Preguntas frecuentes

¿Qué es un servidor MCP?
Un host de tools para un cliente de IA. El MCP de narrador está en https://api.narrador.io/mcp como io.narrador/narrador.
¿Cómo lo agrego a Claude Desktop, Cursor o VS Code?
Si soporta MCP OAuth remoto, agregá https://api.narrador.io/mcp e iniciá sesión. Si no, usá Bearer con nrd_files_ o nrd_x_. Muestras en https://api.narrador.io/docs.
¿La API sale más cara?
No. La API usa los mismos créditos que la app, al mismo precio.