Substack Posting MCP

Substack API MCP

O Substack não fornece uma API pública nativa para publicação de posts.

Mas autores que desejam rascunhar, publicar e agendar por meio de agentes de IA (Cursor, Claude e outros hosts MCP) ainda precisam de uma solução. Este é o servidor MCP para publicar no Substack por meio de qualquer agente.

Não iniciará sem uma APISUBSTACK_API_KEY válida (ask_*). Obtenha a chave de API aqui: apisubstack.com.

Por que isso existe

Realidade	O que construímos
Sem API oficial de escrita/publicação do Substack para autores	Um MCP de postagem para que agentes possam criar rascunhos, publicar agora e agendar
Autores vivem no editor do navegador	Autores publicam por meio de seus agentes
Autenticação por cookie de sessão é o caminho prático hoje	substack.sid + a URL da sua publicação, protegida por uma chave API do Substack

Exemplos

• ignalex.substack.com

Ferramentas

Ferramenta	Descrição
test_connection	Verifica substack.sid e retorna o perfil
create_post	Criar rascunho / publicar agora / agendar (+ tags opcionais)
get_draft	Buscar rascunho por id
pangram_detection	Verificação Pangram de texto IA / "AI-slop" em um rascunho
update_draft	Atualizar campos do rascunho
publish_post	Publicar rascunho existente
schedule_post	Agendar rascunho existente
delete_draft	Excluir rascunho
list_tags	Listar tags da publicação
create_tag	Criar tag
set_tags	Garantir + anexar tags
get_post_tags	Listar tags em um post/rascunho

Instalação

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

Env de autenticação

1. Entre em apisubstack.com, inicie o teste gratuito e gere uma chave de API ask_*.
2. Copie seu cookie substack.sid do Substack:
   • Abra o Chrome e entre no Substack.
   • Abra DevTools → Application → Cookies.
   • Selecione https://substack.com (ou o host da sua publicação, ex.: https://yourname.substack.com).
   • Encontre o cookie chamado substack.sid e copie o Valor.
3. Exporte:

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"

Cookies expiram. Se você receber 401/403, atualize substack.sid e tente novamente.

Execução

substack-api-mcp
# or
python -m substack_api_mcp

Configuração do Cursor / Claude Desktop

Veja 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"
      }
    }
  }
}

Use caminhos absolutos. Reinicie o host após alterações na configuração.

Licença

Atribuição-ou-Royalties (código-fonte disponível). Veja LICENSE e COMMERCIAL_LICENSE.md.

• Uso não comercial: permitido (mantenha o aviso de direitos autorais + licença).
• Uso comercial: atribuição visível em todos os lugares onde o software for usado, ou uma licença comercial / royalties paga via apisubstack.com.

Use por sua conta e risco. Não afiliado ao Substack. Construído para que autores possam publicar por meio de seus agentes quando o Substack em si não oferece uma API de publicação nativa.