Skip to main content
Glama
pdfluent-mcp

pdfluent-mcp

Official

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PDFLUENT_MCP_ROOTSNoAllowed root directories the server may read and write inside, separated by ':' (';' on Windows). Repeatable equivalent of the --root option. A server with no root from any source (--root, this variable, or MCP roots offered by the client) answers every call with a message saying so.
PDFLUENT_MCP_MAX_BYTESNoThe largest document the server opens. Equivalent of the --max-bytes option.100 MiB
PDFLUENT_MCP_MAX_PAGESNoHow many pages one call returns, so a long document is read in windows through the pages argument. Equivalent of the --max-pages option.200
PDFLUENT_MCP_MAX_OUTPUT_CHARSNoThe longest result one call returns, after which it is cut and says so. Equivalent of the --max-output-chars option.200000

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Read and fill local PDF files inside the allowed roots. Pass absolute paths. Use extract_markdown to read or quote a document, extract_text for the plain text layer, extract_tables for table data as rows, extract_blocks when you need the page and box of what you cite, get_metadata before reading a document you do not know, search to find the pages that mention something, and list_form_fields then fill_form to complete a form into a new file. Page numbers are 0-based in every argument and result. A page listed as needing vision has no text layer: nothing the text tools return for it is its content.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
extract_markdownA

A local PDF as markdown, in reading order.

Headings become # to ###, list items - and 1., a table a pipe table (or HTML where markdown cannot hold its shape), and a change of page an HTML comment. Running heads and page numbers are left out.

Args: path: The PDF's absolute path on this machine. pages: The 0-based pages to return; omit for the whole document, up to the server's page limit. The whole document is still read, because what a block is gets decided against the rest of it. quality: "fast" (default) or "balanced", the layout-model tier, which needs the models installed on this machine.

extract_textA

The plain text layer of a local PDF, page by page.

Each page starts with <!-- page N --> (N 0-based). No reading-order repair and no structure: use extract_markdown for that. A page with no text layer (a scan) yields nothing here; get_metadata names those pages.

Args: path: The PDF's absolute path on this machine. pages: The 0-based pages to return; omit for the whole document, up to the server's page limit.

extract_tablesA

The tables of a local PDF as rows of cell text.

tables holds one entry per table in reading order: page (0-based), rows (a list of rows, each a list of cell strings, every row the table's width) and header_rows (how many leading rows are header rows). A spanning cell sits at its first row and column; the cells it covers are empty strings.

Args: path: The PDF's absolute path on this machine. pages: The 0-based pages to look at; omit for the whole document, up to the server's page limit.

extract_blocksA

A local PDF as blocks, in reading order, with where each one came from.

Each block has kind (paragraph, heading, list_item, table_cell, header, footer), text, page (0-based), bbox ([x0, y0, x1, y1] in PDF points, origin bottom-left) and confidence: the probability of the learned model that decided the block's kind, or null where no model did -- null means unknown, not low. Headings carry level, list items level and ordinal, table cells row, column, row_span, column_span and header.

pages_needing_vision lists the pages in the window whose text layer is missing: nothing this returns for them is the page's content.

Args: path: The PDF's absolute path on this machine. pages: The 0-based pages to return; omit for the whole document, up to the server's page limit. include_furniture: Keep running heads and page numbers (kinds header and footer); they are left out by default because they repeat on every page and crowd out the content.

get_metadataA

What a local PDF is, before reading it.

pages, title, author, subject, created, modified, format (the PDF version), encrypted with the encryption filter name, has_forms with the form_fields count, the number of signatures and bookmarks, and pages_needing_vision: the 0-based pages that draw ink but carry no text layer. A document that needs a password to open answers encrypted: true and needs_password: true and nothing else.

Args: path: The PDF's absolute path on this machine.

searchA

The pages of a local PDF that mention query, with a snippet each.

pages lists every matching 0-based page. snippets gives up to three windows of text around the match on each of the first twenty matching pages, so an agent can decide which pages to read in full with extract_markdown. Matching is case-insensitive on the text layer; a scanned page cannot match.

Args: path: The PDF's absolute path on this machine. query: The text to look for, as written in the document.

list_form_fieldsA

The interactive form fields of a local PDF.

fields holds one entry per field: name (the fully qualified name fill_form takes), type (text, button, choice, signature or unknown), value (the current value, or null) and page (0-based, or null when the field has no widget on a page). An empty list means the document has no AcroForm fields.

Args: path: The PDF's absolute path on this machine.

fill_formA

Fill the form fields of a local PDF and write the result to a new file.

values maps a field name from list_form_fields to its new value: a string for a text field, a check box or a combo box, a list of strings for a multi-select list box. The input file is never changed; out_path must be a different path inside an allowed root, and one that does not exist yet unless overwrite is true. A symbolic link at out_path is refused either way. The result names the fields that were set and the names that were unknown; nothing is written when no field was set.

Args: path: The absolute path of the PDF to fill. values: Field name to new value. out_path: The absolute path to write the filled PDF to. overwrite: Replace a file that already exists at out_path.

vision_adviceA

Which pages of a local PDF are worth sending to a vision model, and why.

advice holds one entry per page. needs_vision is true when any reason holds. Today only no_text_layer is measured -- the page draws ink but yields no text, as a scan does; low_confidence_table and figure are always false until the engine can measure them.

Args: path: The PDF's absolute path on this machine.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.1/5.0

Scored across 9 tools

Disambiguation5/5

Each tool targets a clearly distinct output or operation: markdown, plain text, tables, blocks, metadata, search, vision advice, and form listing/filling. Although several tools extract from the same PDF, their descriptions make the boundaries explicit and an agent can reliably choose between them.

Naming Consistency4/5

All names use snake_case consistently, which is a clear convention. However, verbs are not fully uniform: extract_* dominates, but vision_advice is noun-oriented and search is a bare verb, so the set is mostly rather than perfectly consistent.

Tool Count5/5

Nine tools is well-scoped for a PDF extraction and form-filling server. Each tool has a clear role and none appears redundant or merely decorative.

Completeness4/5

The surface covers the main PDF reading lifecycle: metadata, search, multiple extraction formats, vision triage, and form inspection/filling. Minor gaps remain, such as no direct page rendering or image extraction tool, but core workflows are supported.

Maintenance

ActivityMaintained
ResponsivenessOutdated data