Substack Posting MCP

Substack API MCP

Substack no proporciona una API pública nativa para publicar posts.

Pero los autores que quieren redactar, publicar y programar desde agentes de IA (Cursor, Claude y otros hosts MCP) todavía necesitan una salida. Este es el servidor MCP para publicar en Substack a través de cualquier agente.

No se iniciará sin un APISUBSTACK_API_KEY válido (ask_*). Obtén la clave API aquí: apisubstack.com.

Por qué existe esto

Realidad	Lo que construimos
Sin API oficial de escritura/publicación de Substack para autores	Un MCP de publicación para que los agentes puedan crear borradores, publicar ahora y programar
Los autores viven en el editor del navegador	Los autores publican a través de sus agentes en su lugar
La autenticación por cookie de sesión es el camino práctico hoy	substack.sid + tu URL de publicación, controlado por una clave API de Substack

Ejemplos

• ignalex.substack.com

Herramientas

Herramienta	Descripción
test_connection	Verificar substack.sid y devolver el perfil
create_post	Crear borrador / publicar ahora / programar (+ etiquetas opcionales)
get_draft	Obtener borrador por id
pangram_detection	Verificación Pangram de texto IA / AI-slop en un borrador
update_draft	Actualizar campos del borrador
publish_post	Publicar borrador existente
schedule_post	Programar borrador existente
delete_draft	Eliminar borrador
list_tags	Listar etiquetas de publicación
create_tag	Crear etiqueta
set_tags	Asegurar + adjuntar etiquetas
get_post_tags	Listar etiquetas en un post/borrador

Instalación

cd /path/to/Substack-API-MCP
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Variables de entorno de autenticación

1. Inicia sesión en apisubstack.com, comienza la prueba gratuita, genera una clave API ask_*.
2. Copia tu cookie substack.sid de Substack:
   • Abre Chrome e inicia sesión en Substack.
   • Abre DevTools → Application → Cookies.
   • Selecciona https://substack.com (o el host de tu publicación, p. ej. https://yourname.substack.com).
   • Encuentra la cookie llamada substack.sid y copia su Valor.
3. Exporta:

export APISUBSTACK_API_KEY="ask_YOUR_KEY"
export SUBSTACK_PUBLICATION_URL="https://yourname.substack.com"
export SUBSTACK_SID="YOUR_SUBSTACK_SID_VALUE"
# optional
# export SUBSTACK_USER_ID="123456"

Las cookies expiran. Si obtienes 401/403, actualiza substack.sid e inténtalo de nuevo.

Ejecución

substack-api-mcp
# or
python -m substack_api_mcp

Configuración de Cursor / Claude Desktop

Consulta mcp.example.json:

{
  "mcpServers": {
    "substack-api": {
      "command": "/ABSOLUTE/PATH/TO/Substack-API-MCP/.venv/bin/substack-api-mcp",
      "args": [],
      "env": {
        "APISUBSTACK_API_KEY": "ask_YOUR_KEY",
        "SUBSTACK_PUBLICATION_URL": "https://yourname.substack.com",
        "SUBSTACK_SID": "YOUR_SUBSTACK_SID_VALUE"
      }
    }
  }
}

Usa rutas absolutas. Reinicia el host después de los cambios de configuración.

Licencia

Atribución-o-Regalías (código fuente disponible). Consulta LICENSE y COMMERCIAL_LICENSE.md.

• Uso no comercial: permitido (mantén el aviso de copyright + licencia).
• Uso comercial: ya sea atribución visible en todos los lugares donde se use el software, o una licencia comercial / de regalías de pago a través de apisubstack.com.

Úsalo bajo tu propio riesgo. No está afiliado con Substack. Construido para que los autores puedan publicar a través de sus agentes cuando Substack no ofrece una API de publicación nativa.