Skip to main content
Glama
publiar-mcp

publiar-mcp

publiar-mcp

Serveur MCP qui écrit des lead magnets LinkedIn et refuse d'inventer.

publiar-mcp MCP server

EN. MCP server for Publiar. Writes LinkedIn lead magnets that refuse to fabricate facts, renders the matching visual, publishes to LinkedIn and tracks what happened. 22 tools, hosted over streamable HTTP with OAuth, or local over stdio. Generated posts are in French. MIT.

Demande un post LinkedIn à un LLM, il te sort « après 7 semaines de tests intensifs, +340 % d'engagement ». Tu n'as rien testé pendant 7 semaines et le chiffre sort de nulle part. Tu le publies, quelqu'un demande la source, et tu n'en as pas.

Ce serveur applique six règles bloquantes avant d'écrire une ligne. Pas de chiffre sans source déclarée, pas de marque non citée, pas de client anonyme fictif, pas de durée de test imaginaire, pas d'années d'expérience sorties du chapeau, et pas de ressource promise dont l'URL ne répond pas. Si tu ne l'as pas dit, ça n'existe pas.

Deux façons de le brancher

Hébergé, rien à installer. Le serveur tourne déjà sur api.publiar.app. Ton client se connecte à l'URL et ouvre une fenêtre de connexion.

claude mcp add --transport http publiar https://api.publiar.app/api/mcp

Aucune clé à copier, aucun secret posé dans un fichier de configuration. L'endpoint répond 401 en désignant sa métadonnée OAuth, le client s'enregistre tout seul, tu autorises dans le navigateur. Révocable depuis ton profil, ce qu'une clé collée dans un fichier n'est pas.

En local, par paquet. Si tu préfères que le processus tourne chez toi, ou si ton client ne parle pas encore le transport HTTP, la voie stdio reste entière.

Related MCP server: LinkedIn MCP Server

Installation

pip install publiar-mcp

Configuration

Génère une clé sur publiar.app/profile, section « Clés MCP ». Elle n'est affichée qu'une fois.

Claude Desktop, %APPDATA%\Claude\claude_desktop_config.json sur Windows, ~/Library/Application Support/Claude/claude_desktop_config.json sur macOS :

{
  "mcpServers": {
    "publiar": {
      "command": "publiar-mcp",
      "env": {
        "PUBLIAR_API_KEY": "mcp_pub_xxxxx",
        "PUBLIAR_API_URL": "https://api.publiar.app/api"
      }
    }
  }
}

Cursor, ~/.cursor/mcp.json, même format. Claude Code :

claude mcp add publiar -e PUBLIAR_API_KEY=mcp_pub_xxxxx -- publiar-mcp

Redémarre complètement l'agent pour qu'il charge le serveur.

Les 22 outils

Commencer

Outil

Ce qu'il fait

get_brief

LE point de départ : la méthode complète (règles R1-R8, jury de relecture, hook), l'archétype déduit, les 5 voisins du corpus, ta mémoire et tes ressources, en un appel

Écrire et rendre

Outil

Ce qu'il fait

generate_lead_magnet

Post LinkedIn + visual_spec, à partir d'entrées structurées. Refuse si la matière manque.

generate_pair

Générateur de paires, motifs couplés et porte de preuve

render_visual

Rend un visual_spec en PNG 1080×1080, 8 archétypes

render_gif

Rend un GIF animé, publiable tel quel sur LinkedIn

prepare_visual_base

Fond cinématique généré, pour l'archétype dark_thumbnail

Publier

Outil

Ce qu'il fait

add_resource

Héberge la ressource promise (markdown → page publique /r/slug), vues comptées

list_resources

Tes ressources hébergées et combien de commentateurs ont ouvert le lien

publish_lead_magnet

Publie texte + visuel sur LinkedIn. Deux phases : aperçu, puis confirmation.

update_post

Réécrit le texte d'un post déjà en ligne. L'URN, la date et l'engagement survivent.

register_published

Enregistre un post publié pour le suivi

Mesurer et relancer

Outil

Ce qu'il fait

list_published

Tes lead magnets publiés et leurs statistiques

get_published_detail

Détail d'un post, engagements et statut des DM

set_published_status

active, paused, completed, error

toggle_published_dm

Active ou coupe le DM automatique sur un post

paste_comments

Analyse des commentaires collés, prépare les DM à envoyer

mark_engagement_sent

Marque un DM comme envoyé

poll_published_now

Récolte via l'API. Renvoie vide, voir Limitations.

Mémoire et corpus

Outil

Ce qu'il fait

add_memory

Écrit dans ta mémoire. source et source_date obligatoires.

list_corpus

Les 45 lead magnets de référence analysés

find_similar_corpus

Recherche sémantique dans le corpus, pondérée par l'engagement

whoami

Vérifie l'authentification

Les 8 archétypes visuels

Le serveur déduit l'archétype depuis ta matière, tu n'as pas à le choisir.

Archétype

Déclencheur

tool_pairing

2 ou 3 outils combinés

benchmark_table

comparaison chiffrée de modèles ou de produits

dark_thumbnail

annonce de produit ou de lancement

youtube_thumbnail

audience grand public, titre fort

selfie_workspace

une photo de toi est fournie

system_workflow_screenshot

un screenshot de workflow est fourni

file_tree_diagram

une arborescence de stack ou de skills

agent_role_diagram

une équipe de 3 à 5 agents

Une preuve réelle uploadée bat toujours une preuve générée. Si tu fournis une photo, l'archétype est selfie_workspace, même si tu as aussi nommé deux outils.

Exemple

Génère un lead magnet sur Claude + Notion pour automatiser ma prise de notes. J'ai mesuré 3 h gagnées par jour depuis 2 mois. CTA : NOTION.

L'agent appelle generate_lead_magnet et te rend le post, les hashtags et le visual_spec. render_visual en fait un PNG, publish_lead_magnet l'envoie.

Variables d'environnement

Variable

Défaut

Rôle

PUBLIAR_API_KEY

—

Obligatoire. Clé mcp_pub_... créée sur publiar.app/profile

PUBLIAR_API_URL

https://api.publiar.app/api

Endpoint REST

PUBLIAR_TIMEOUT

60

Délai HTTP en secondes

PUBLIAR_LOG_LEVEL

INFO

Niveau de log sur stderr

Architecture

   Agent IA           publiar-mcp            API Publiar
   Claude Desktop  →  ce paquet,        →    Django,
   Cursor             processus stdio        api.publiar.app
                          │                       │
                          │  Bearer mcp_pub_…     │
                          └───────────────────────┘
                              HTTPS, JSON et NDJSON

Aucune logique métier ici. Ce paquet est un adaptateur de protocole ; tout vit dans le backend qui sert déjà publiar.app.

Sécurité

Les clés sont stockées hachées en SHA-256 côté serveur, la valeur brute n'est montrée qu'à la création. Chaque clé est révocable depuis publiar.app/profile. last_used_at est suivi pour repérer les clés dormantes. Le préfixe mcp_pub_ reste visible pour identifier une clé sans la révéler.

Limitations connues

poll_published_now renverra toujours vide. Lire les commentaires d'un post personnel exige la permission LinkedIn r_member_social, que LinkedIn classe en accès privé et n'accorde plus. Utilise paste_comments : tu colles les commentaires, le serveur fait le reste.

generate_lead_magnet consomme de l'inférence côté serveur.

Les envois d'images pour selfie_workspace et system_workflow_screenshot ne passent pas encore par le MCP. L'agent doit fournir le base64 dans le spec.

Licence

MIT.

Available Tools

19 tools
add_memoryAInspect

Ecrit une entree dans la memoire de l'utilisateur. C'est la voie d'entree du second cerveau : ce que tu sais et que Publiar n'a pas vu passer. source et source_date sont OBLIGATOIRES, sans provenance une note ancienne ressort plus tard dans une phrase au present. kind parmi brand_voice, past_post, audience, decision, manual. learned_rule et anti_pattern sont refuses : ils se derivent des performances mesurees, on ne les declare pas. scope cloisonne par projet et filtre le retrieval. La deduplication rend le rejeu d'une ingestion inoffensif.

Inputs: kind (required), source (required), content (required), source_date (required), +3 more.

find_similar_corpusAInspect

RAG retrieval : retourne les top-K lead magnets du corpus les plus similaires à une requête (texte libre + brands optionnels). Score = embedding cosine + engagement bump (log10 likes).

Inputs: query (required), k, brands, archetype.

generate_lead_magnetAInspect

Génère un lead magnet LinkedIn complet (post texte + visual_spec) à partir d'un input structuré (outils utilisés, chiffre + source, type de preuve, etc.). Stream NDJSON (validation → post → visual_spec → done). Renvoie la liste des événements parsés.

Inputs: outils (required), proof_type (required), cta_keyword (required), resource_type (required), +10 more.

generate_pairAInspect

Pipeline v3 legacy : génère 2 variants (hook + image SPEC) couplés via le pair_generator (coupled motifs + proof gate). Utilise plutôt generate_lead_magnet — celui-ci reste pour le retrieval explicite via biais/motifs.

Inputs: topic (required), tone, claim, proof_override, +1 more.

get_published_detailAInspect

Détail d'un PublishedLeadMagnet + ses engagements (comments + statut DM).

Inputs: id (required).

list_corpusBInspect

Liste les lead magnets du corpus de référence (45 entrées : 30+ posts du docx Darius + 45 images classifiées). Filtrable par archetype, tri par engagement.

Inputs: limit, order_by, archetype.

list_publishedAInspect

Liste les lead magnets publiés de l'utilisateur (avec stats engagement rolling).

Inputs: no named parameters.

mark_engagement_sentBInspect

Marque un CommentEngagement comme DM envoyé (manuellement via LinkedIn).

Inputs: id (required), sent.

paste_commentsAInspect

Sprint E.3' Option B : import des comments LinkedIn collés par l'utilisateur (formats : tab, pipe, free-form). Parse + matche le CTA + génère les DM personnalisés prêts à copier-coller manuellement (LinkedIn r_member_social étant CLOSED, l'envoi auto est impossible).

Inputs: id (required), raw_text (required).

poll_published_nowAInspect

Force un poll Community API immédiat sur un PublishedLeadMagnet (legacy, retournera des engagements vides puisque r_member_social est CLOSED — préférer paste_comments).

Inputs: id (required).

prepare_visual_baseAInspect

Pour l'archétype dark_thumbnail : génère via Gemini 2.5 Flash Image un fond cinematic background à partir d'un base_prompt. Retourne un data: URL prêt à injecter dans le spec.

Inputs: base_prompt (required).

publish_lead_magnetAInspect

Publie un lead magnet sur LinkedIn depuis l'agent, sans ouvrir la webapp. DEUX PHASES OBLIGATOIRES. Premier appel sans confirmed : le serveur rend le visuel et retourne un APERÇU (post_text + png_base64) SANS rien publier. Tu DOIS alors montrer le texte ET l'image à l'utilisateur et attendre son accord explicite. Second appel avec confirmed: true : la publication part. Ne confirme jamais à la place de l'utilisateur, c'est son nom sur le post. Si resource_url est fourni, il est TESTÉ avant publication (règle R6 : une ressource morte annoncée à des commentateurs coûte plus cher que l'absence de post). Retourne le post_urn : enchaîne avec register_published pour activer le suivi des commentaires et les DM.

Inputs: content (required), confirmed, image_url, visual_spec, +3 more.

register_publishedCInspect

Enregistre un lead magnet publié sur LinkedIn (snapshot du LeadMagnetInput + URN du post LinkedIn pour le tracking engagement).

Inputs: post_urn (required), cta_keyword (required), archetype, post_text, +5 more.

render_gifAInspect

Rend un lead magnet ANIME en GIF (1080x1080, boucle infinie). Recettes : 'tool_pairing' (brands[], connector, caption_bottom) et 'metric_counter' (value, unit, prefix, label, caption_bottom). PUBLIABLE SUR LINKEDIN, verifie le 2026-08-11 par un aller-retour reel : un GIF de 39 frames uploade via /rest/images ressort en 39 frames animees. L'artefact servi s'appelle image-shrink_1280 et reste anime, ce nom ne prouve donc aucun aplatissement. La cause des GIF figes d'avant etait /v2/assets, qui n'accepte que jpeg et png : le format n'etait pas supporte en entree. Seul point non verifie : que le fil JOUE l'animation a l'affichage, ce qu'un post reel regarde a l'oeil confirmerait. Coute cher a rendre (528 Mo de pic memoire), reste sur render_visual quand l'animation n'apporte rien.

Inputs: spec (required).

render_visualAInspect

Rend un LeadMagnetVisualSpec en PNG (1080x1080 ou ratio adapté). Retourne le PNG encodé base64 + mime-type. 8 archétypes supportés.

Inputs: spec (required).

set_published_statusCInspect

Change le status d'un PublishedLeadMagnet (active/paused/completed/error).

Inputs: id (required), status (required).

toggle_published_dmBInspect

Active/désactive auto_dm_enabled sur un PublishedLeadMagnet.

Inputs: id (required), enabled (required).

update_postAInspect

Reecrit le texte d'un post LinkedIn DEJA publie. Sert quand le hook est rate ou qu'une affirmation s'avere fausse : editer bat republier, l'URN, la date et l'engagement sont conserves. DEUX PHASES OBLIGATOIRES, comme publish_lead_magnet. Premier appel sans confirmed : retourne l'avant et l'apres SANS rien toucher. Montre les deux a l'utilisateur, puis rappelle avec confirmed: true s'il valide. Le VISUEL n'est pas modifiable, LinkedIn ne l'autorise pas : l'image publiee reste en place, seul le texte change. Passe le texte ENTIER, pas un fragment : le champ est remplace, jamais fusionne.

Inputs: content (required), post_urn (required), confirmed.

whoamiAInspect

Retourne les infos du user authentifié via la clé MCP (utile pour debug auth).

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 19 tools

    Disambiguation3/5

    There is some overlap between generate_lead_magnet and the legacy generate_pair, and between render_visual and render_gif, which could cause misselection. However, the descriptions explicitly guide the agent toward the preferred tool, so the ambiguity is manageable.

    Naming Consistency4/5

    Almost all tools follow a clear snake_case verb_noun pattern (e.g., render_visual, list_published, set_published_status). The only outlier is 'whoami', a standard command-style name, which is a minor deviation rather than a break in the pattern.

    Tool Count3/5

    With 19 tools, the server is on the heavy side. Several tools are legacy (generate_pair, poll_published_now) or auxiliary (whoami), inflating the count. The core functionality could likely be served with fewer, more focused tools.

    Completeness4/5

    The core workflow is well covered: generate, render, publish, update, track, and handle comments. Minor gaps include the lack of a delete/unpublish operation and no way to read back entries from the memory store (add_memory only writes), but these are not critical for the main purpose.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Fully featured MCP server that provides automation tools for LinkedIn, supporting browser-based scraping and API-based operations for content management, media uploads, and reactions.
      6
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      High-performance autonomous MCP server that turns LinkedIn into an API for AI workflows, enabling profile management, job search, content posting, and document generation.
      14
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for AI-native LinkedIn prospecting. It enables lead research, audience building, conversation management, and controlled outreach actions such as messaging and publishing through an OAuth-protected remote endpoint.
      2
      MIT