Social Neuron MCP Server

@socialneuron/mcp-server

91 herramientas públicas MCP para la gestión de redes sociales impulsada por IA. Crea contenido, programa publicaciones, rastrea analíticas y optimiza el rendimiento, todo desde Claude Code o cualquier cliente MCP.

Inicio rápido

1. Autenticación

npx -y @socialneuron/mcp-server login --device

Esto abre tu navegador para autorizar el acceso. Requiere un plan Pro de Social Neuron o superior. Consulta precios.

2. Añadir a Claude Code

claude mcp add socialneuron -- npx -y @socialneuron/mcp-server

{
  "mcpServers": {
    "socialneuron": {
      "command": "npx",
      "args": ["-y", "@socialneuron/mcp-server"]
    }
  }
}

{
  "servers": {
    "socialneuron": {
      "command": "npx",
      "args": ["-y", "@socialneuron/mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "socialneuron": {
      "command": "npx",
      "args": ["-y", "@socialneuron/mcp-server"]
    }
  }
}

3. Empieza a usar

Pregunta a Claude: "¿Qué contenido debería publicar esta semana?" o "Programa mi último video en YouTube y TikTok"

Lo que puedes hacer

Pregunta a Claude cosas como:

• "Genera 5 ideas de contenido sobre moda sostenible para la Generación Z"
• "Crea un anuncio de video de 30 segundos para el lanzamiento de mi producto"
• "Programa esta publicación en X y Bluesky para mañana a las 9 a.m."
• "Muéstrame mi contenido con mejor rendimiento este mes"
• "¿Cuáles son los temas de tendencia en mi nicho ahora mismo?"
• "Revisa mis analíticas y sugiere mejoras"
• "Configura el piloto automático para publicar 3 veces por semana"

Categorías de herramientas

El endpoint alojado y el servidor npm stdio exponen cada uno 91 herramientas públicas. Sus superficies difieren intencionalmente: el HTTP alojado incluye las aplicaciones MCP de Content Calendar y Analytics Pulse, mientras que stdio incluye 2 herramientas locales de captura de pantalla en su lugar. El recuento en vivo alojado se publica en la tarjeta del servidor. Un pequeño conjunto de herramientas de servicio internas utilizadas por la automatización propia de Social Neuron se registran pero no forman parte de la superficie pública.

Estas herramientas están disponibles para agentes de IA (Claude, Cursor, etc.) a través del protocolo MCP.

Ciclo de vida del contenido

Gestión y optimización

Utilidades

Aplicaciones MCP interactivas (HTTP alojado)

Las aplicaciones se renderizan solo en hosts MCP que admiten la extensión de aplicaciones MCP. Todos los datos subyacentes y las operaciones de escritura siguen siendo herramientas con ámbito ordinarias, por lo que los hosts sin interfaz interactiva pueden usar los mismos flujos de trabajo a través de llamadas de texto/herramienta.

Autenticación

Tres métodos de autenticación, en orden de recomendación:

Código de dispositivo (recomendado)

npx -y @socialneuron/mcp-server login --device

Abre el navegador, apruebas y la CLI recibe la clave de API automáticamente.

Flujo de navegador

npx -y @socialneuron/mcp-server login

Flujo OAuth basado en navegador.

Pegar clave de API

npx -y @socialneuron/mcp-server login --paste

Genera una clave en socialneuron.com/settings/developer y pégala.

Las claves se almacenan en el llavero de tu sistema operativo (macOS Keychain, Linux secret-tool) o en un archivo de respaldo creado con permisos de solo propietario donde el sistema operativo lo admite.

Usuarios de Windows: El archivo de respaldo (~/.config/social-neuron/credentials.json) no tiene una aplicación estricta de permisos en NTFS. Para uso en producción en Windows, configura la variable de entorno SOCIALNEURON_API_KEY en su lugar.

Precios

El acceso MCP/API requiere un plan Pro o superior:

Regístrate en socialneuron.com/pricing.

Ámbitos

Cada clave de API hereda los ámbitos de tu plan. Las herramientas requieren ámbitos específicos para ejecutarse.

Referencia de CLI

Estos comandos se ejecutan directamente en tu terminal, sin necesidad de un agente de IA. Útiles para scripts, CI/CD y verificaciones rápidas.

Después de la instalación global (npm i -g @socialneuron/mcp-server), usa socialneuron-mcp directamente. De lo contrario, prefija con npx @socialneuron/mcp-server.

# Auth
socialneuron-mcp login [--device|--paste]
socialneuron-mcp logout

# Deterministic CLI (no LLM)
socialneuron-mcp sn publish --media-url <url> --caption <text> --platforms <list> --confirm
socialneuron-mcp sn status --job-id <id>
socialneuron-mcp sn posts --days 7 --platform youtube
socialneuron-mcp sn refresh-analytics
socialneuron-mcp sn preflight --check-urls
socialneuron-mcp sn oauth-health --json
socialneuron-mcp sn oauth-refresh --platform instagram
socialneuron-mcp sn quality-check --content "your text here"
socialneuron-mcp sn autopilot
socialneuron-mcp sn usage
socialneuron-mcp sn loop
socialneuron-mcp sn credits

# Agent-native CLI v2
socialneuron-mcp sn tools [--module ideation] [--scope mcp:write]  # List/filter available tools
socialneuron-mcp sn info                                            # Version, auth, credits, tool count
socialneuron-mcp sn plan list|view|approve                          # Content plan management
socialneuron-mcp sn preset list|show|save|delete                    # Platform presets (6 built-in)

# Interactive REPL
socialneuron-mcp repl

# Add --json to any command for machine-readable output

Flujo de automatización (bucle E2E)

El bucle completo de contenido autónomo usando herramientas MCP:

1. get_loop_summary — evaluar el estado del proyecto (cantidad de contenido, publicaciones programadas, información)
2. plan_content_week — generar un plan de contenido basado en información y tendencias
3. generate_video / generate_image — crear activos de medios a partir del plan
4. check_status — consultar trabajos asíncronos hasta que los activos estén listos
5. schedule_post — distribuir contenido a las plataformas conectadas
6. (esperar la recopilación de analíticas) — los datos de la plataforma se obtienen automáticamente
7. refresh_platform_analytics — activar una actualización manual de analíticas
8. get_performance_insights — leer qué funcionó y qué no
9. Volver al paso 1 con nueva información

Cada iteración produce contenido más inteligente a medida que los datos de rendimiento retroalimentan el paso de planificación.

Seguridad

• Todas las claves de API se cifran antes de almacenarse; nunca almacenamos claves en texto plano
• Las credenciales se almacenan en el llavero de tu sistema operativo (macOS Keychain, Linux secret-tool) o en una variable de entorno
• Protección SSRF en todos los parámetros de URL con prevención de rebinding de DNS
• Límite de velocidad por usuario con límites por herramienta para operaciones costosas
• La detección de bucles de agente previene la automatización descontrolada
• Configura DO_NOT_TRACK=1 para desactivar la telemetría de uso anónimo

Consulta SECURITY.md para nuestra política de divulgación de vulnerabilidades y detalles de seguridad de credenciales.

Telemetría

Este paquete recopila métricas de uso operativo (nombre de herramienta, duración, éxito/fracaso) para mejorar la confiabilidad. No envía entradas de herramientas, salidas, contenido generado, claves de API, correos electrónicos ni cuerpos de error ascendentes. Cuando una implementación configura POSTHOG_PSEUDONYMIZATION_KEY, el identificador de usuario se seudonimiza con HMAC; de lo contrario, una clave efímera por proceso evita la correlación estable entre sesiones.

Para desactivar: Configura DO_NOT_TRACK=1 o SOCIALNEURON_NO_TELEMETRY=1 en tu entorno.

Nunca se recopilan contenido personal, claves de API ni cargas útiles de solicitudes.

Ejemplos

Consulta el repositorio de ejemplos para plantillas de flujos de trabajo basados en prompts:

• Planificación semanal de lotes de contenido
• Reutilización de contenido multiplataforma
• Bucles de revisión y optimización de rendimiento
• Generación de contenido alineado con la marca
• Automatización de interacción con comentarios

Enlaces

• Social Neuron
• Para desarrolladores
• Documentación
• Ejemplos
• Protocolo de agente
• Configuración de desarrollador
• Precios

Licencia

MIT: consulta LICENSE