ViralNote

@viralnote/mcp-server

Un servidor de Model Context Protocol para la API de redes sociales ViralNote.

Conéctalo a Claude Desktop, Claude Code, Cursor o cualquier otro host compatible con MCP y tu agente podrá programar publicaciones, gestionar medios y leer análisis en X, Instagram, Facebook, TikTok, LinkedIn, YouTube, Pinterest, Bluesky, Threads y Reddit — como llamadas nativas de herramientas MCP. Sin código de integración adicional.

Instalación

Claude Desktop / Claude Code / Cursor

Añade a tu configuración de MCP (~/Library/Application Support/Claude/claude_desktop_config.json en macOS, similar en otras plataformas):

{
  "mcpServers": {
    "viralnote": {
      "command": "npx",
      "args": ["-y", "@viralnote/mcp-server"],
      "env": {
        "VIRALNOTE_API_KEY": "vnd_..."
      }
    }
  }
}

Reinicia tu host MCP. Las herramientas de ViralNote estarán disponibles de inmediato.

Este repositorio incluye un .mcp.json raíz (estándar de Open Plugins) para que herramientas como Cursor Directory puedan detectar automáticamente el servidor MCP desde la URL de GitHub.

Cursor Marketplace

Una vez que el plugin esté publicado en Cursor Marketplace, puedes instalarlo directamente desde Cursor:

1. Abre Cursor y ve a Configuración → Plugins
2. Busca "ViralNote" en el Marketplace
3. Haz clic en Instalar
4. En Plugins → Configurar, establece tu VIRALNOTE_API_KEY
5. Obtén tu clave API desde dashboard.viralnote.app o viralnote.app/developers/auth

Las herramientas de ViralNote estarán disponibles de inmediato en tu entorno de Cursor.

Instalación local

npm install -g @viralnote/mcp-server

Luego referencia viralnote-mcp directamente en tu configuración de MCP:

{
  "mcpServers": {
    "viralnote": {
      "command": "viralnote-mcp",
      "env": { "VIRALNOTE_API_KEY": "vnd_..." }
    }
  }
}

Configuración

Variable de entorno	Requerida	Valor predeterminado	Notas
VIRALNOTE_API_KEY	sí	—	Genérala en viralnote.app/developers/auth. Otorga posts:read, posts:write, además de webhooks:* si tu agente debe gestionar webhooks.
VIRALNOTE_API_BASE	no	https://viralnote.app/api/v1	Anulación para instancias de staging o autoalojadas.

Herramientas expuestas

Herramienta	Propósito
list_posts	Listar publicaciones (filtrar por estado/plataforma, paginado)
get_post	Leer una publicación, incluidos los resultados de publicación por plataforma
create_post	Crear un borrador (is_draft: true) o una publicación programada
update_post	Actualizar un borrador o una publicación programada
delete_post	Eliminar (cancela si está programada)
publish_post	Publicar un borrador ahora
list_media	Listar elementos de la biblioteca de medios
import_media	Importar por URL (200MB) o datos base64 (3MB)
delete_media	Eliminar un elemento de medios
list_social_accounts	Listar cuentas sociales conectadas
list_analytics	Publicaciones publicadas con métricas por plataforma
list_post_results	Resultados de entrega por plataforma (éxito/error)
list_webhooks	Listar suscripciones a webhooks
create_webhook	Suscribirse a eventos
delete_webhook	Cancelar suscripción

Para la mayoría de los usuarios, el servidor MCP HTTP en https://viralnote.app/api/mcp/mcp es más simple que instalar este paquete stdio — consulta https://viralnote.app/developers/mcp para el fragmento de configuración HTTP. Usa este paquete stdio cuando tu cliente MCP no admita transporte HTTP.

Los endpoints REST subyacentes y las formas de solicitud/respuesta están documentados en viralnote.app/developers/docs.

Ejemplos de indicaciones para agentes

"Muéstrame mis últimas 5 publicaciones programadas." Herramienta: list_posts con { status: "scheduled", limit: 5 }.

"Programa este texto para Instagram mañana a las 9am, adjuntando la foto que subí ayer." Herramientas: list_media → buscar elemento → create_post con { platforms: ["instagram"], caption, libraryItemId, scheduledFor, status: "scheduled" }.

"Trae este enlace de Dropbox a mi biblioteca y publícalo en X de inmediato." Herramientas: import_media → create_post (borrador) → publish_post.

Desarrollo

git clone https://github.com/viralnote/mcp-server
cd mcp-server
npm install
npm run build
VIRALNOTE_API_KEY=vnd_... npm start

Para iteración local sin recompilar:

VIRALNOTE_API_KEY=vnd_... npm run dev

Licencia

MIT — consulta LICENSE. Las solicitudes de extracción son bienvenidas.