@propalix/mcp

Serveur MCP Propalix - créez des devis et contrats PDF conformes au droit français directement depuis Claude, Cursor ou tout client MCP.

Décrivez votre prestation en langage naturel, votre agent appelle Propalix et vous récupérez :

• un devis PDF conforme (SIREN/SIRET, TVA par taux, franchise art. 293 B du CGI) avec un lien public « Bon pour accord » à envoyer à votre client ;
• un contrat de prestation de services PDF (objet, prix, durée, résiliation, propriété intellectuelle, litiges, clauses personnalisées).

Sans clé API : mode keyless, 25 documents/jour avec filigrane. Avec une clé (gratuite sur propalix.fr/app) : quotas étendus et, en plan Pro, PDF sans filigrane.

Installation

Rien à installer : le serveur se lance en une ligne via npx.

npx -y @propalix/mcp

Node.js ≥ 20 requis.

Configuration

Claude Desktop

Dans claude_desktop_config.json (Réglages → Développeur → Modifier la configuration) :

{
  "mcpServers": {
    "propalix": {
      "command": "npx",
      "args": ["-y", "@propalix/mcp"],
      "env": { "PROPALIX_API_KEY": "ppx_votre_cle" }
    }
  }
}

Claude Code

claude mcp add propalix -e PROPALIX_API_KEY=ppx_votre_cle -- npx -y @propalix/mcp

Ou dans .mcp.json à la racine du projet :

{
  "mcpServers": {
    "propalix": {
      "command": "npx",
      "args": ["-y", "@propalix/mcp"],
      "env": { "PROPALIX_API_KEY": "ppx_votre_cle" }
    }
  }
}

Cursor

Dans ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projet) :

{
  "mcpServers": {
    "propalix": {
      "command": "npx",
      "args": ["-y", "@propalix/mcp"],
      "env": { "PROPALIX_API_KEY": "ppx_votre_cle" }
    }
  }
}

Dans tous les cas, PROPALIX_API_KEY est facultative : sans clé, le serveur fonctionne en mode keyless (25 documents/jour, filigrane « Généré avec Propalix »).

Outils exposés

create_devis

Crée un devis PDF conforme au droit français et renvoie une URL publique où votre client peut consulter le devis et cliquer « Bon pour accord ». Les mentions obligatoires (SIREN/SIRET, TVA par taux, franchise art. 293 B…) sont garanties.

Paramètres :

| Paramètre | Type | Description | |---|---|---| | emetteur | objet, facultatif | Identité de l'émetteur : nom, adresse, code_postal, ville, siren (9 chiffres) ou siret (14 chiffres), et en option forme_juridique, tva_intracom, email, telephone. Facultatif si votre compte Propalix a des paramètres émetteur enregistrés. | | client | objet, requis | nom (requis), et en option adresse, code_postal, ville, email, represente_par. | | prestations | tableau, requis (min. 1) | Chaque ligne : designation, prix_unitaire_ht (euros), et en option quantite (défaut 1), unite (jour, heure, mots…), taux_tva (% - défaut 20). | | tva_applicable | booléen, défaut true | false pour la franchise en base (micro-entrepreneurs, art. 293 B du CGI). | | numero | chaîne, facultatif | Numéro de devis personnalisé. | | duree_validite_jours | entier, défaut 30 | Durée de validité du devis. | | conditions_paiement | chaîne, facultatif | Conditions de paiement affichées sur le devis. | | notes | chaîne, facultatif | Notes libres. |

Retour : le numéro du devis, le lien à envoyer au client (consultation + « Bon pour accord »), l'URL du PDF direct et la date de fin de validité. En plan gratuit, une note signale le filigrane.

create_contrat

Crée un contrat de prestation de services PDF conforme au droit français (objet, prix, durée, résiliation, propriété intellectuelle, litiges + clauses personnalisées). Le PDF est enregistré localement (dossier temporaire) et le chemin du fichier est renvoyé.

Paramètres :

| Paramètre | Type | Description | |---|---|---| | prestataire | objet, facultatif | Même structure que emetteur ci-dessus. Facultatif si votre compte Propalix a des paramètres émetteur enregistrés. | | client | objet, requis | Même structure que pour create_devis (represente_par recommandé : « Marc Vermot, gérant »). | | objet | chaîne, requis | Objet du contrat, ex. « la refonte du site vitrine du Client ». | | prestations | tableau, requis (min. 1) | Même structure que pour create_devis. | | tva_applicable | booléen, défaut true | false pour la franchise en base. | | modalites_paiement | chaîne, facultatif | Modalités de paiement. | | duree | chaîne, facultatif | Durée du contrat. | | preavis_resiliation_jours | entier, facultatif | Préavis de résiliation en jours. | | clauses_custom | tableau, facultatif | Clauses additionnelles { titre, texte }, insérées avant l'article Litiges. |

Retour : le numéro du contrat, sa taille, et le chemin local du PDF enregistré. En plan gratuit, une note signale le filigrane.

rechercher_entreprise

Recherche une entreprise française dans l'annuaire officiel de l'État par nom, SIREN ou SIRET. Renvoie l'identité complète : raison sociale, forme juridique, adresse du siège, SIREN/SIRET et n° de TVA intracommunautaire calculé. Les entreprises en non-diffusion INSEE sont respectées (champs masqués absents).

| Paramètre | Type | Description | |---|---|---| | q | chaîne, requis | Nom d'entreprise, SIREN (9 chiffres) ou SIRET (14 chiffres). |

configurer_emetteur

Configure le compte Propalix de A à Z en un appel : recherche l'entreprise dans l'annuaire officiel et enregistre son identité complète dans les paramètres du compte. Ensuite, tous les devis et contrats sont automatiquement préremplis - plus besoin d'envoyer le bloc emetteur. Nécessite PROPALIX_API_KEY.

| Paramètre | Type | Description | |---|---|---| | entreprise | chaîne, requis | Nom, SIREN ou SIRET du titulaire du compte. | | ecraser | booléen, défaut false | true pour réécrire des paramètres déjà renseignés. |

En cas d'erreur de validation, les outils renvoient les messages d'erreur en français, champ par champ.

Variables d'environnement

| Variable | Défaut | Description | |---|---|---| | PROPALIX_API_KEY | - | Clé API Propalix (ppx_…). Sans clé : mode keyless, 25 documents/jour, filigrane. | | PROPALIX_API_URL | https://www.propalix.fr | URL de l'API Propalix. À changer uniquement si vous auto-hébergez Propalix (ex. http://localhost:3000). |

Liens

• Site et création de clé API : propalix.fr · propalix.fr/app
• Doc condensée pour agents IA : propalix.fr/llms.txt

Licence

MIT