Skip to main content
Glama
RemplirPDF MCP server

RemplirPDF MCP server

RemplirPDF MCP server

npm

Let your AI agent prepare French rental documents: furnished and unfurnished leases, inventories (état des lieux), rent receipts (quittances), rent notices, guarantor deeds, notices to quit and certificates. The agent picks the right template, asks you for the missing details, and generates the filled PDF in your RemplirPDF account, with the legal clauses already written.

Serveur MCP de RemplirPDF : votre assistant IA prépare bail, état des lieux, quittance de loyer et attestations en PDF rempli, avec les clauses légales déjà rédigées. Documentation en français : https://remplirpdf.fr/mcp

What an agent can do

Tool

What it does

Behaviour

list_templates

Lists the rental templates of the RemplirPDF catalogue (slug, category, signers). Call it first.

read-only

get_template

Fields of a template: required or not, expected format, options, computed fields, signers. Call it before generating.

read-only

generate_document

Fills a template with the values the user gave, saves the PDF in their account, returns a 24-hour download link. With document_id it replaces an earlier document made from the same template.

writes (may overwrite)

list_documents

The latest rental documents of the account.

read-only

get_download_link

A fresh 24-hour download link for a document of the account.

read-only

Every tool has a title, a description of when to use it, described parameters, explicit readOnlyHint / destructiveHint / openWorldHint annotations and an outputSchema (results come as structuredContent).

Generating documents and download links need an active RemplirPDF subscription. Without one the tools refuse with a clear message: no tool ever starts a payment or charges a card. Documents must reflect a real tenancy; the server is not meant to produce documents meant to mislead a third party.

Example: « Prépare la quittance de loyer de septembre pour Paul Martin, 750 € plus 80,50 € de charges, 12 rue des Lilas à Lyon. » → list_templates → get_template("quittance-de-loyer") → the agent asks for the landlord's name → generate_document(...) → a PDF link.

Related MCP server: layerone-mcp

Connect

OAuth (Claude, ChatGPT, Claude Code, Cursor, VS Code)

Add the server URL; your client opens RemplirPDF, you sign in (or create an account) and click Autoriser. You can disconnect at any time. Access tokens last one hour and are refreshed while the connection is active.

  • Claude (claude.ai, Claude Desktop): Settings → Connectors → Add custom connector → https://remplirpdf.fr/api/mcp → Connect.

  • ChatGPT: Settings → Apps → developer mode → Create app → https://remplirpdf.fr/api/mcp, authentication OAuth.

  • Claude Code: claude mcp add --transport http remplirpdf https://remplirpdf.fr/api/mcp, then /mcp to sign in.

  • Cursor (~/.cursor/mcp.json) and VS Code (.vscode/mcp.json, with "type": "http"): use the URL; the editor offers to sign in.

This repository's .mcp.json / mcp.json contain the same remote configuration (no secrets).

API key (any client that can send a header)

Create a key in your account (https://remplirpdf.fr/app/compte, « Clés API »). It is shown once; only its hash is stored, and you can revoke it at any time. Send it as Authorization: Bearer rpdf_… (the Bearer prefix is optional).

# Codex CLI, ~/.codex/config.toml (then export REMPLIRPDF_API_KEY)
[mcp_servers.remplirpdf]
url = "https://remplirpdf.fr/api/mcp"
bearer_token_env_var = "REMPLIRPDF_API_KEY"

Local stdio server (this repository)

For clients that only speak stdio. It exposes exactly the remote tools (their definitions are generated from the live server into src/tools.json) and runs them through RemplirPDF's HTTPS API with your API key.

# npm (Node.js 20+), nothing to install
REMPLIRPDF_API_KEY=rpdf_your_key npx -y remplirpdf-mcp
{
  "mcpServers": {
    "remplirpdf": {
      "command": "npx",
      "args": ["-y", "remplirpdf-mcp"],
      "env": { "REMPLIRPDF_API_KEY": "rpdf_your_key" }
    }
  }
}

Or run it from this repository:

# Docker
docker build -t remplirpdf-mcp .
docker run -i --rm -e REMPLIRPDF_API_KEY=rpdf_your_key remplirpdf-mcp

# From source (Node.js 20+)
npm ci && npm run build
REMPLIRPDF_API_KEY=rpdf_your_key node dist/index.js
{
  "mcpServers": {
    "remplirpdf": {
      "command": "node",
      "args": ["/path/to/remplirpdf-mcp/dist/index.js"],
      "env": { "REMPLIRPDF_API_KEY": "rpdf_your_key" }
    }
  }
}

Variable

Default

REMPLIRPDF_API_KEY

none

API key of your account. Without it the server starts and lists its tools; calls explain how to set the key.

REMPLIRPDF_MCP_URL

https://remplirpdf.fr/api/mcp

Endpoint the tools are sent to.

Maintenance: npm run sync-tools regenerates src/tools.json from the live server (REMPLIRPDF_API_KEY set: tools/list; otherwise the public card /.well-known/mcp/server-card.json); npm test runs a stdio smoke test; npm run interop -- https://remplirpdf.fr checks the remote OAuth flow and tools with the official MCP SDK client (it creates a throwaway RemplirPDF account).

Security and privacy

  • OAuth 2.1 with PKCE (S256), exact redirect URIs, audience-bound one-hour tokens (RFC 8707), rotating refresh tokens, revocation (RFC 7009), Dynamic Client Registration (RFC 7591) and Client ID Metadata Documents.

  • Generated documents stay in your RemplirPDF account; download links expire after 24 hours.

  • Personal data is processed as described in the privacy policy: https://remplirpdf.fr/confidentialite

License

MIT, see LICENSE. RemplirPDF is a private service, not affiliated with the French administration.

Available Tools

5 tools
generate_documentGénérer le PDF rempliA
Destructive
Inspect

Remplit un modèle avec les valeurs fournies et enregistre le PDF dans le compte RemplirPDF de l'utilisateur ; renvoie un lien de téléchargement valable 24 h et le lien du document dans l'application. Vérifie d'abord les champs obligatoires et les formats : en cas d'erreur, rien n'est créé et la réponse liste ce qui manque. Sans document_id, crée toujours un nouveau document ; avec document_id, remplace le contenu d'un document déjà généré avec le même modèle (l'ancienne version est écrasée). Les valeurs doivent être exactes et fournies par l'utilisateur. Nécessite un abonnement RemplirPDF actif : sinon l'outil refuse, sans rien facturer ni démarrer de paiement. Appelez get_template avant pour connaître les champs ; pour retrouver un document existant, utilisez list_documents.

Inputs: values (required), template (required), document_id. Returns: pages, title, app_url, template, +5 more

get_templateDécrire un modèleA
Read-onlyIdempotent
Inspect

Décrit un modèle : champs à remplir (nom technique, libellé, obligatoire ou non, format attendu, options, valeur par défaut), champs calculés automatiquement et signataires. À appeler avant generate_document pour savoir quelles informations demander à l'utilisateur (ne les inventez pas) ; pour trouver le slug, utilisez list_templates. Lecture seule : ne crée rien.

Inputs: template (required). Returns: name, slug, notes, pages, +6 more

list_documentsLister mes documents de locationA
Read-onlyIdempotent
Inspect

Liste les derniers documents de location générés dans le compte de l'utilisateur (identifiant, titre, modèle, nombre de pages, date de mise à jour), du plus récent au plus ancien. À utiliser pour retrouver un document_id avant get_download_link, ou avant de mettre à jour un document avec generate_document. Lecture seule : ne crée ni ne modifie rien.

Inputs: limit. Returns: documents

list_templatesLister les modèles de locationA
Read-onlyIdempotent
Inspect

Liste les modèles de documents de location français proposés par RemplirPDF, un par page du catalogue (bail meublé, bail vide, bail mobilité, étudiant, colocation, commercial, précaire, état des lieux d'entrée et de sortie, quittance de loyer, avis d'échéance, attestations, acte de caution, préavis, congé pour vente…) avec leur slug, leur catégorie et leurs signataires. À appeler en premier quand le slug du modèle n'est pas encore connu ; pour les champs d'un modèle précis, utilisez get_template. Lecture seule : ne crée rien.

Inputs: no named parameters. Returns: templates

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct resource+action: listing vs. describing templates, generating documents, listing documents, and fetching download links. The descriptions explicitly cross-reference each other (e.g., 'use list_templates for the slug, get_template for fields') and clarify boundaries. No two tools overlap in purpose.

    Naming Consistency5/5

    All five tools follow a clean verb_noun snake_case pattern: get_template, list_templates, generate_document, list_documents, get_download_link. The convention is uniform throughout with no deviations.

    Tool Count5/5

    Five tools is well-scoped for a document-generation service. Each tool earns its place in the discovery-to-download workflow without redundancy or thin coverage.

    Completeness4/5

    The surface covers the full lifecycle: list/describe templates, generate (with in-place update via document_id), list documents, and retrieve download links. The only minor gap is the absence of a delete_document operation, but core workflows have no dead ends.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables users to generate rental agreements and receipts as PDFs through an AI-powered WhatsApp bot. Provides stamp duty information lookup and handles rental document creation with customizable templates.
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to generate documents (PDF/DOCX/Factur-X) and manage electronic signatures (eIDAS/PAdES) via natural language using LayerOne's DocX and Sign APIs.
      20
      33 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to operate property management systems via natural language, covering repair orders, owner info, payments, notices, and inspections. Features a full agentic workflow with human-in-the-loop and observability.
      1
      MIT