substack-mcp

Un servidor MCP para Substack que permite a los asistentes de IA leer los datos de tu publicación y gestionar borradores.

Seguro por diseño: Este servidor puede crear y editar borradores, pero no puede publicar ni eliminar publicaciones. Siempre revisarás y publicarás manualmente a través del editor de Substack.

Herramientas

Leer

Escribir

Excluido intencionalmente

• Publicar entradas — La publicación de entradas largas debe ser una acción humana deliberada

• Eliminar — Demasiado destructivo para una herramienta de IA

• Programar — Usa el editor de Substack para programar

Related MCP server: Substack MCP Server

Configuración

1. Obtén tus credenciales

Abre tu Substack en un navegador y luego:

1. Token de sesión: Navega a tu publicación, abre las Herramientas de desarrollador → Aplicación → Cookies → copia el valor de connect.sid (cadena codificada en URL que comienza con s%3A)

2. ID de usuario: En la consola de las Herramientas de desarrollador, ejecuta: fetch('/api/v1/archive?sort=new&limit=1').then(r=>r.json()).then(d=>console.log(d[0]?.publishedBylines?.[0]?.id))

3. URL de la publicación: Tu URL de Substack, incluyendo el dominio personalizado si tienes uno (ej. https://newsletter.yourdomain.com o https://yourblog.substack.com)

2. Configura tu cliente MCP

Claude Desktop

Añade a tu claude_desktop_config.json:

{
 "mcpServers": {
 "substack": {
 "command": "npx",
 "args": ["-y", "@conorbronsdon/substack-mcp"],
 "env": {
 "SUBSTACK_PUBLICATION_URL": "https://yourblog.substack.com",
 "SUBSTACK_SESSION_TOKEN": "your-session-token",
 "SUBSTACK_USER_ID": "your-user-id"
 }
 }
 }
}

Claude Code

Añade a tu .mcp.json:

{
 "mcpServers": {
 "substack": {
 "command": "npx",
 "args": ["-y", "@conorbronsdon/substack-mcp"],
 "env": {
 "SUBSTACK_PUBLICATION_URL": "https://yourblog.substack.com",
 "SUBSTACK_SESSION_TOKEN": "your-session-token",
 "SUBSTACK_USER_ID": "your-user-id"
 }
 }
 }
}

3. Verificar

Pregunta a tu asistente de IA: "¿Cuántos suscriptores de Substack tengo?"

Caducidad del token

Los tokens de sesión de Substack caducan periódicamente (normalmente ~90 días). Si recibes errores de autenticación, obtén una nueva cookie connect.sid de tu navegador y actualiza la variable de entorno. Asegúrate de que los bloqueadores de anuncios estén desactivados al copiar la cookie.

Compatibilidad con Markdown

Las herramientas create_draft y update_draft aceptan markdown y lo convierten al formato nativo de Substack. Se admite:

• Párrafos, encabezados (h1–h6)

• Negrita, cursiva, código en línea

• Enlaces

• Imágenes

• Listas con viñetas y numeradas

• Bloques de código (con lenguaje)

• Citas en bloque

• Reglas horizontales

Notas importantes

• Este servidor utiliza la API no oficial de Substack. Puede dejar de funcionar si Substack cambia sus endpoints.

• Los tokens de sesión se envían como cookies. Mantén tu SUBSTACK_SESSION_TOKEN seguro.

• El servidor valida la autenticación al iniciarse y fallará rápidamente si tu token ha caducado.

Desarrollo

git clone https://github.com/conorbronsdon/substack-mcp.git
cd substack-mcp
npm install
npm run build

Ejecutar localmente:

SUBSTACK_PUBLICATION_URL=https://yourblog.substack.com \
SUBSTACK_SESSION_TOKEN=your-token \
SUBSTACK_USER_ID=your-id \
npm start

Descargo de responsabilidad

Todas las opiniones, puntos de vista y declaraciones expresadas en esta cuenta son exclusivamente mías y se realizan a título personal. No reflejan, y no deben interpretarse como que reflejan, los puntos de vista, posiciones o políticas de Modular. Esta cuenta no está afiliada, autorizada ni respaldada por Modular de ninguna manera.

Licencia

MIT

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• create_draftA
• create_noteA
• create_note_with_linkA
• get_draftA
• get_postA
• get_post_commentsA
• get_subscriber_countA
• list_draftsB