ViralNote

@viralnote/mcp-server

Um servidor Model Context Protocol para a API de mídias sociais ViralNote.

Conecte-o ao Claude Desktop, Claude Code, Cursor ou qualquer outro host compatível com MCP e seu agente poderá agendar publicações, gerenciar mídias e ler análises em X, Instagram, Facebook, TikTok, LinkedIn, YouTube, Pinterest, Bluesky, Threads e Reddit — como chamadas de ferramentas MCP nativas. Sem código de integração.

Instalação

Claude Desktop / Claude Code / Cursor

Adicione à sua configuração MCP (~/Library/Application Support/Claude/claude_desktop_config.json no macOS, semelhante em outras plataformas):

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

Reinicie seu host MCP. As ferramentas ViralNote estarão disponíveis imediatamente.

Este repositório inclui um .mcp.json na raiz (padrão Open Plugins) para que ferramentas como Cursor Directory possam detectar automaticamente o servidor MCP a partir da URL do GitHub.

Cursor Marketplace

Assim que o plugin for publicado no Cursor Marketplace, você poderá instalá-lo diretamente do Cursor:

1. Abra o Cursor e vá para Configurações → Plugins
2. Pesquise por "ViralNote" no Marketplace
3. Clique em Instalar
4. Em Plugins → Configurar, defina seu VIRALNOTE_API_KEY
5. Obtenha sua chave de API em dashboard.viralnote.app ou viralnote.app/developers/auth

As ferramentas ViralNote estarão imediatamente disponíveis no seu ambiente Cursor.

Instalação local

npm install -g @viralnote/mcp-server

Em seguida, referencie viralnote-mcp diretamente na sua configuração MCP:

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

Configuração

Variável de ambiente	Obrigatória	Padrão	Observações
VIRALNOTE_API_KEY	sim	—	Gere em viralnote.app/developers/auth. Conceda posts:read, posts:write, além de webhooks:* se seu agente deve gerenciar webhooks.
VIRALNOTE_API_BASE	não	https://viralnote.app/api/v1	Substituição para instâncias de staging/self-hosted.

Ferramentas expostas

Ferramenta	Finalidade
list_posts	Listar publicações (filtrar por status/plataforma, paginado)
get_post	Ler uma publicação, incluindo resultados de publicação por plataforma
create_post	Criar um rascunho (is_draft: true) ou publicação agendada
update_post	Atualizar um rascunho ou publicação agendada
delete_post	Excluir (cancela se agendado)
publish_post	Publicar um rascunho agora
list_media	Listar itens da biblioteca de mídia
import_media	Importar por URL (200MB) ou dados base64 (3MB)
delete_media	Excluir um item de mídia
list_social_accounts	Listar contas sociais conectadas
list_analytics	Publicações publicadas com métricas por plataforma
list_post_results	Resultados de entrega por plataforma (sucesso/erro)
list_webhooks	Listar assinaturas de webhook
create_webhook	Assinar eventos
delete_webhook	Cancelar assinatura

Para a maioria dos usuários, o servidor MCP HTTP em https://viralnote.app/api/mcp/mcp é mais simples do que instalar este pacote stdio — veja https://viralnote.app/developers/mcp para o trecho de configuração HTTP. Use este pacote stdio quando seu cliente MCP não suportar transporte HTTP.

Os endpoints REST subjacentes e os formatos de requisição/resposta estão documentados em viralnote.app/developers/docs.

Exemplos de prompts para agentes

"Mostre-me minhas últimas 5 publicações agendadas." Ferramenta: list_posts com { status: "scheduled", limit: 5 }.

"Agende esta legenda para o Instagram amanhã às 9h, anexando a foto que enviei ontem." Ferramentas: list_media → encontrar item → create_post com { platforms: ["instagram"], caption, libraryItemId, scheduledFor, status: "scheduled" }.

"Puxe este link do Dropbox para minha biblioteca e publique-o no X imediatamente." Ferramentas: import_media → create_post (rascunho) → publish_post.

Desenvolvimento

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

Para iteração local sem recompilar:

VIRALNOTE_API_KEY=vnd_... npm run dev

Licença

MIT — veja LICENSE. Pull requests são bem-vindos.