Unmarkdown

La capa de publicación de documentos para herramientas de IA: crea, estiliza y publica documentos formateados desde cualquier cliente MCP.

GitHub

Documentación

Servidor MCP de Unmarkdown

Un servidor de Model Context Protocol (MCP) que conecta asistentes de IA a la API de Unmarkdown. Convierte markdown a documentos con un formato impecable, gestiona tu biblioteca de documentos y publica páginas en la web, todo desde Claude, Cursor, VS Code o cualquier cliente compatible con MCP.

También disponible como: Extensión de Chrome | Aplicación web | API REST

Características

Convierte markdown a HTML con estilo para 8 destinos: Google Docs, Word, Slack, OneNote, Email, texto plano, HTML genérico y HTML sin procesar
62 plantillas visuales con temas claro y oscuro (Swiss, Executive, Terminal, GitHub y más)
Crea, lee y actualiza documentos en tu biblioteca de Unmarkdown, organizados en carpetas
Publica documentos en URLs públicas compartibles en unmarkdown.com/d/your-slug
Realiza un seguimiento del uso de la API y de la cuota del período de facturación actual

Instalación

Claude Desktop / Claude para macOS

Añade esto a tu archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "unmarkdown": {
      "command": "npx",
      "args": ["-y", "@un-markdown/mcp-server"],
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

Cursor

Añade a la configuración de MCP de Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "unmarkdown": {
      "command": "npx",
      "args": ["-y", "@un-markdown/mcp-server"],
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

VS Code

Añade a la configuración de MCP de VS Code (.vscode/mcp.json):

{
  "servers": {
    "unmarkdown": {
      "command": "npx",
      "args": ["-y", "@un-markdown/mcp-server"],
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

Instalación global

Si prefieres instalar globalmente en lugar de usar npx:

npm install -g @un-markdown/mcp-server

Luego usa unmarkdown-mcp como comando en lugar de npx:

{
  "mcpServers": {
    "unmarkdown": {
      "command": "unmarkdown-mcp",
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

Configuración

Obligatorio

Variable	Descripción
`UNMARKDOWN_API_KEY`	Tu clave de API de Unmarkdown (empieza por `um_`). Consíguela en Configuración > API de tu cuenta de Unmarkdown.

Opcional

Variable	Descripción	Valor predeterminado
`UNMARKDOWN_API_URL`	URL base personalizada de la API	`https://api.unmarkdown.com`

Ejemplos de uso

Ejemplo 1: Convierte un borrador de notas de reunión para Google Docs

"Toma este markdown y conviértelo para Google Docs usando la plantilla Executive:

# Reunión de planificación del primer trimestre

## Asistentes
- Sarah Chen (Producto)
- Mike Torres (Ingeniería)
- Lisa Park (Diseño)

## Acciones pendientes
- [ ] Finalizar la hoja de ruta antes del viernes
- [ ] Programar la revisión de diseño del nuevo panel
- [ ] Actualizar la presentación para las partes interesadas
```"

Claude usará la herramienta convert_markdown con destination: "google-docs" y template_id: "executive", y devolverá HTML con estilo listo para pegar en Google Docs con encabezados, fuentes y colores adecuados.

Ejemplo 2: Crea un documento en una carpeta

"Crea un nuevo documento llamado 'Registro de cambios de la API - febrero de 2026' en mi carpeta de Notas de la versión con este contenido y luego publícalo."

Claude hará lo siguiente:

Llamará a create_document con el título, el contenido en markdown y folder: "Release Notes"
Llamará a publish_document con el ID del documento devuelto

El documento se crea directamente en la carpeta especificada y recibirás una URL en vivo como https://unmarkdown.com/d/api-changelog-february-2026.

Ejemplo 3: Actualiza y mueve un documento

"Mueve el informe del cuarto trimestre a la carpeta Archivo y actualiza su título."

Claude hará lo siguiente:

Llamará a list_documents para encontrar el documento
Llamará a update_document con el nuevo título y folder: "Archive"

Ejemplo 4: Da formato a markdown para Slack

"Convierte esta actualización de proyecto a formato Slack para que se vea bien cuando la pegue en el canal de nuestro equipo."

Claude usa convert_markdown con destination: "slack", y produce una salida optimizada para la representación de Slack (negritas, listas, bloques de código, compatibilidad con emojis).

Ejemplo 5: Comprueba el uso de la API

"¿Cuántas llamadas a la API he usado este mes?"

Claude llama a get_usage y devuelve tu recuento de uso actual, el límite mensual y el período de facturación.

Referencia de herramientas

Herramienta	Descripción	Solo lectura	Idempotente
`convert_markdown`	Convierte markdown a HTML con estilo para cualquiera de los 8 destinos	Sí	Sí
`create_document`	Crea un nuevo documento en tu biblioteca (opcionalmente en una carpeta)	No	No
`list_documents`	Lista los documentos guardados con paginación (opcionalmente filtra por carpeta)	Sí	Sí
`get_document`	Obtiene un documento por ID con su contenido completo	Sí	Sí
`update_document`	Modifica el título, el contenido, la plantilla, los metadatos o la carpeta de un documento	No	Sí
`publish_document`	Publica un documento en una URL pública compartible	No	Sí
`get_usage`	Comprueba la cuota de la API para el mes de facturación actual	Sí	Sí

Destinos

La herramienta convert_markdown admite estos formatos de salida:

Destino	Descripción
`google-docs`	Optimizado para pegar en Google Docs
`word`	Con formato para Microsoft Word
`slack`	Formato compatible con Slack
`onenote`	Compatible con Microsoft OneNote
`email`	HTML compatible con clientes de correo electrónico
`plain-text`	Texto plano con formato ASCII
`generic`	HTML con estilo de uso general
`html`	Salida HTML sin procesar

Plantillas

Pasa cualquier ID de plantilla a convert_markdown, create_document o update_document. Las plantillas populares incluyen:

Plantilla	Categoría
`swiss`	Gratuita (predeterminada)
`mono`	Gratuita
`github`	Gratuita
`terminal`	Gratuita
`executive`	Business (Pro)
`consulting`	Business (Pro)
`startup`	Business (Pro)

Explora las 62 plantillas en unmarkdown.com/templates.

Límites de la API

Plan	Llamadas mensuales a la API	Límite de velocidad
Gratuito	1000	10 solicitudes/seg
Pro ($8/mes anual)	10 000	30 solicitudes/seg

Exceso: $1.00 por cada 1000 llamadas adicionales (solo Pro). El plan gratuito tiene un límite estricto.

Privacidad

Este servidor MCP envía tu contenido en markdown y los datos de tus documentos a la API de Unmarkdown (api.unmarkdown.com) para su procesamiento. El propio servidor MCP no almacena datos localmente. Todo el manejo de datos se rige por la Política de privacidad de Unmarkdown.

Específicamente:

El contenido en markdown enviado mediante convert_markdown se procesa y se devuelve de inmediato. No se almacena en los servidores de Unmarkdown.
Los documentos creados mediante create_document o update_document se almacenan en tu cuenta de Unmarkdown y se pueden eliminar en cualquier momento.
Las claves de API autentican las solicitudes y nunca se registran ni se comparten.

Para consultar la política de privacidad completa, visita unmarkdown.com/privacy.

Soporte

Problemas: github.com/UnMarkdown/mcp-server/issues
Documentación: docs.unmarkdown.com
Referencia de la API: docs.unmarkdown.com/api/overview
Contacto: unmarkdown.com/contact

Desarrollo

# Clone the repo
git clone https://github.com/UnMarkdown/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run locally (requires API key)
UNMARKDOWN_API_KEY=um_your_key node build/index.js

Consulta también

Extensión de Chrome — Detecta y convierte markdown en cualquier página de chat de IA (ChatGPT, Claude, Gemini)
Aplicación web — Editor completo con 62 plantillas, publicación, acciones de IA y análisis
API REST — Acceso programático a todas las funciones de conversión y documentos
Smithery — Instálalo a través del registro MCP de Smithery
npm — @un-markdown/mcp-server en npm

Licencia

MIT. Consulta LICENSE para obtener más detalles.