Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Formfeed

NPM · @FORMFEED/MCP · 3 COMPONENTS

Render PDFs and images from templates, validate data and convert Office files to PDF.

+1 this week 92 Trust /100

Last scanned (5 hours ago)

Scores higher than 91% of npm servers

Category Documents and Files

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security98
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • 30 of 92 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to formfeed-dev/formfeed). View diagnostics → Pass
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 1 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability59
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 6376 tokens (~354/item across 18 items; 18 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • We read all 18 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
  • An AI judge read all 19 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
What we tested

Checks we ran (16)

  • Malware scan
  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 21 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 20 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
    • Package version: 0.3.28 → 0.3.29 functional
  • 19 Nov 26 0
    • Package version: 0.3.27 → 0.3.28 functional
  • 18 Nov 26 0
    • Stability: 0.97 → pass security
    • Package version: 0.3.26 → 0.3.27 functional
  • 17 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.

  • 15 Nov 26 +16
    • Malware scan: unverified → pass ▲ security
  • 14 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
    • Known CVEs: pass → unverified ▼ security
    • Schema quality: 3884 → 6173 ▼ functional
    • Dependency health: 0.85 → unverified ▼ functional
    • Package version: 0.3.24 → 0.3.26 functional
    • Package version: 0.3.24 → 0.3.25 functional
  • 12 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 77 to 80. That category is still filling its 30-day observation window: 23 days of observed history at the previous scan, 24 at this one. The score rises as the window fills, whether or not the server changes.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 22 Nov 2026 · Analysed npm/@formfeed/mcp@0.3.29

Provenance Verified

A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.

Result Verified
Ecosystem npm
Reason Verified
Discovered via Registry attestation endpoint
Source repo formfeed-dev/formfeed
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/formfeed-dev/formfeed/.github/workflows/release.yml@refs/tags/v0.3.29
Rekor log index 4026562480
Predicate type SLSA build provenance https://slsa.dev/provenance/v1
Subject digest sha512:d9ef2e6a6e3d4c28648405bf0e2b2ba5a1ce8a6836fe31d99a63e59d2577ebf921dab0942cb8f694c28b049547de4965fbed9b7b4bea3bd608b278f87

Background: How many MCP packages publish verified provenance →

Dependencies 92 packages
Packages resolved 92
Stale 30
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 18 exposed · ~6,034 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
check_invoice ~238

Checks the _invoice block of an e-invoice offline, as the API does before it renders one: the fields EN 16931 asks for, the totals to the cent, VAT categories and code lists, and France's rules for an invoice between two French businesses. Free, no units, nothing sent. Returns ok and problems, each with the field, the rule (BR-…) where one applies and a message. Nothing is computed for you: change the values a problem names, check again, then call render with einvoice and the block as data._invoice. The validator that runs during the render holds the file to the full rule set and to PDF/A-3b as well.

NameTypeReqDescription
invoiceobjectyesThe _invoice block as it goes into data._invoice: number, issue_date, currency, seller, buyer, lines, tax.breakdown, totals and payment, as https://docs.formfeed.dev/templates/e-invoices#invoice-bloc…
profilestring–The profile the render will ask for; en16931 when left out. basic cannot carry a rounding amount and is refused between two French businesses
NameTypeReqDescription
okbooleanyes–
problemsarrayyes–

No examples provided.

compress_pdf ~257

Makes a PDF smaller and returns the render with download_url; a PDF that cannot be made smaller comes back as it was. For a preview picture of a page instead, use pdf_to_image. Pass exactly one PDF: source, a render or library file of the workspace; path, a file on this machine; or file_base64. Starter plan and above; 0.5 units on a live key. A PDF/A or a password-protected PDF is refused.

NameTypeReqDescription
file_base64string–The PDF itself, base64 encoded, up to 20 MB; sent with the request and not kept
file_namestring–Name of the PDF given as file_base64 or path, e.g. contract.pdf; the results are named after it
filenamestring–Name of the file behind download_url; the source's name when left out
pathstring–Absolute path of a PDF on this machine, up to 100 MB; sent with the request and not kept
sourcestring–A PDF of the workspace: the rnd_ id of a PDF render, or a PDF of the file library by name (such as terms.pdf) or fil_ id
NameTypeReqDescription
accessibilityobject–The PDF/UA-1 verdict, when the template declares it
download_urlstring|nullyesSigned link to the file; null until the render succeeded
einvoiceobject–The e-invoice report, when the render made one
environmentstringyes–
error–yesWhy a failed render failed
expires_atstring|nullyesWhen download_url stops working; get_render issues a fresh one
formobject–What fill_pdf_form did: the fields filled, those left out (unknown name or invalid value) and those whose calculation or display format no viewer ran
idstringyesrnd_ id of the render
outputstring–The format of the file: pdf, png, jpg, webp, docx or pptx, or zip for the several files of split_pdf and pdf_to_image
page_countnumber|nullyes–
pdfaobject–The PDF/A verdict (PDF/A-2b or PDF/A-3b), when the template declares it
statusstringyes–
template–yesThe template and version rendered; null for html and conversions
unitsnumberyesUnits the render counted

No examples provided.

convert_to_pdf ~314

Converts an existing Word, Excel, PowerPoint, OpenDocument, RTF or HTML document (up to 20 MB) to a PDF as it is, without filling in data, and returns the render with status and download_url. To make a document from a template and data, use render instead. Pass exactly one source: render_id, the render of a Word or PowerPoint template (output docx or pptx); path, a file on this machine; or file_base64 with file_name. Every call is a new render that counts units like a PDF; the Free plan cannot convert (Starter and above). The document is converted and not kept.

NameTypeReqDescription
file_base64string–The document to convert, base64 encoded; needs file_name
file_namestring–Name of the document, e.g. report.xlsx; the type is read from the content
filenamestring–Name of the PDF behind download_url, e.g. report.pdf
landscapeboolean–Landscape for spreadsheets and documents without their own page setup
page_rangesstring–Pages to convert, e.g. 1-3,5; all pages when left out
pathstring–Absolute path of the document on this machine
render_idstring–rnd_ id of a render whose output is docx or pptx, to get that document as a PDF
single_page_sheetsboolean–Each spreadsheet sheet on one page
NameTypeReqDescription
accessibilityobject–The PDF/UA-1 verdict, when the template declares it
download_urlstring|nullyesSigned link to the file; null until the render succeeded
einvoiceobject–The e-invoice report, when the render made one
environmentstringyes–
error–yesWhy a failed render failed
expires_atstring|nullyesWhen download_url stops working; get_render issues a fresh one
formobject–What fill_pdf_form did: the fields filled, those left out (unknown name or invalid value) and those whose calculation or display format no viewer ran
idstringyesrnd_ id of the render
outputstring–The format of the file: pdf, png, jpg, webp, docx or pptx, or zip for the several files of split_pdf and pdf_to_image
page_countnumber|nullyes–
pdfaobject–The PDF/A verdict (PDF/A-2b or PDF/A-3b), when the template declares it
statusstringyes–
template–yesThe template and version rendered; null for html and conversions
unitsnumberyesUnits the render counted

No examples provided.

fill_pdf_form ~451

Fills the fields of a PDF form by their full names, as get_pdf_info lists them, and returns the render with download_url and form: how many fields were filled, which were left out, and which hold a calculation or display format that no viewer ran. The form stays fillable, or flatten draws the values into the pages. A name the form lacks or a value its field does not take fails the call with form_field_unknown or form_value_invalid, naming the field, unless strict is false. Pass exactly one PDF: source, a render or library file of the workspace; path, a file on this machine; or file_base64. Starter plan and above; 0.5 units on a live key. The values are never stored; a signed form and an XFA form are refused.

NameTypeReqDescription
fieldsobject–Values by the fields' full names: text for a text field, true or false for a check box, one of the field's options for a dropdown, a radio group or a check box with several on-values, a list of optio…
file_base64string–The PDF itself, base64 encoded, up to 20 MB; sent with the request and not kept
file_namestring–Name of the PDF given as file_base64 or path, e.g. contract.pdf; the results are named after it
filenamestring–Name of the file behind download_url; the source's name when left out
flattenboolean–Draw the values into the pages and remove the fields, so the values can no longer be changed
pathstring–Absolute path of a PDF on this machine, up to 100 MB; sent with the request and not kept
sourcestring–A PDF of the workspace: the rnd_ id of a PDF render, or a PDF of the file library by name (such as terms.pdf) or fil_ id
strictboolean–true (the default) fails on a name the form lacks or a value its field does not take; false leaves both out and lists them in form.skipped
NameTypeReqDescription
accessibilityobject–The PDF/UA-1 verdict, when the template declares it
download_urlstring|nullyesSigned link to the file; null until the render succeeded
einvoiceobject–The e-invoice report, when the render made one
environmentstringyes–
error–yesWhy a failed render failed
expires_atstring|nullyesWhen download_url stops working; get_render issues a fresh one
formobject–What fill_pdf_form did: the fields filled, those left out (unknown name or invalid value) and those whose calculation or display format no viewer ran
idstringyesrnd_ id of the render
outputstring–The format of the file: pdf, png, jpg, webp, docx or pptx, or zip for the several files of split_pdf and pdf_to_image
page_countnumber|nullyes–
pdfaobject–The PDF/A verdict (PDF/A-2b or PDF/A-3b), when the template declares it
statusstringyes–
template–yesThe template and version rendered; null for html and conversions
unitsnumberyesUnits the render counted

No examples provided.

get_pdf_info ~270

Reads a PDF without changing it: the page count and the size of every page, whether it is password-protected, its document properties, and its form, with every field by its full name, label, type, value and the options it takes. Read it before fill_pdf_form, which takes the fields by these names, and before redact_pdf or split_pdf, which work on these pages. Pass exactly one PDF: source, a render or library file of the workspace; path, a file on this machine; or file_base64. Free on every plan; it creates no render, and an uploaded PDF is read and not kept.

NameTypeReqDescription
file_base64string–The PDF itself, base64 encoded, up to 20 MB; sent with the request and not kept
file_namestring–Name of the PDF given as file_base64 or path, e.g. contract.pdf; the results are named after it
pathstring–Absolute path of a PDF on this machine, up to 100 MB; sent with the request and not kept
sourcestring–A PDF of the workspace: the rnd_ id of a PDF render, or a PDF of the file library by name (such as terms.pdf) or fil_ id
NameTypeReqDescription
encryptedbooleanyesWhether the file is password-protected
form––The form; null when the file needs a password to open
metadataobjectyesTitle, author, subject, producer and creator; null when unset
page_countnumberyes–
pagesarrayyesThe size of every page, in points (72 an inch) and millimetres
sourcestring|null–The render id or library file name the PDF came from

No examples provided.

get_render ~130

Returns the current state of a render: status (queued, rendering, succeeded or failed), download_url with expires_at, page_count, units and error, and the picture of a finished image render up to 2 MB. Use it to follow a render started with wait false, or to get a fresh link once the old one has expired; render, convert_to_pdf and the PDF tools already return this for the render they just made. Read-only and free; an unknown id returns an error.

NameTypeReqDescription
idstringyesrnd_ id of the render, as render or convert_to_pdf returned it
NameTypeReqDescription
accessibilityobject–The PDF/UA-1 verdict, when the template declares it
download_urlstring|nullyesSigned link to the file; null until the render succeeded
einvoiceobject–The e-invoice report, when the render made one
environmentstringyes–
error–yesWhy a failed render failed
expires_atstring|nullyesWhen download_url stops working; get_render issues a fresh one
formobject–What fill_pdf_form did: the fields filled, those left out (unknown name or invalid value) and those whose calculation or display format no viewer ran
idstringyesrnd_ id of the render
outputstring–The format of the file: pdf, png, jpg, webp, docx or pptx, or zip for the several files of split_pdf and pdf_to_image
page_countnumber|nullyes–
pdfaobject–The PDF/A verdict (PDF/A-2b or PDF/A-3b), when the template declares it
statusstringyes–
template–yesThe template and version rendered; null for html and conversions
unitsnumberyesUnits the render counted

No examples provided.

get_template_schema ~132

Returns the JSON Schema of the `data` object a template expects and the sample data it was designed with, from its published version, else its latest draft. Call it after list_templates and before render or validate_template, to build data that fits; ad-hoc html has no stored schema to read. When the template stores no schema, one is inferred from the sample data: treat that as a guide, not a contract. Read-only and free; an unknown slug returns an error.

NameTypeReqDescription
templatestringyesSlug (e.g. invoice) or tpl_ id, as list_templates returns them
NameTypeReqDescription
sample_dataobjectyes–
schemaobjectyesJSON Schema of data; inferred from sample_data when none is stored
statusstringyespublished, or draft when nothing is published yet
templatestringyes–
versionnumberyesThe version the schema comes from

No examples provided.

get_template_source ~175

Returns what a template version is made of: the body markup (html), css, head, settings (paper, margins, header, footer, fonts), sample data, data sets, data schema, translations and partials, with the version's checksum. Call it before save_template to change a template the user named, and save what you edited with that checksum as base_checksum. Reads the latest version by default, the newest draft a change builds on; published reads what renders use. Word and PowerPoint templates are documents: for them it returns the settings and data, not the document. Read-only and free.

NameTypeReqDescription
templatestringyesSlug (e.g. invoice) or tpl_ id, as list_templates returns them
version––latest (default), published, a version number or a channel name
NameTypeReqDescription
cssstringyes–
data_schema–yes–
data_setsobjectyes–
headstringyes–
htmlstringyes–
i18n–yes–
partialsobjectyes–
sample_dataobjectyes–
settingsobjectyes–
templateobjectyes–
versionobjectyes–

No examples provided.

get_workspace ~117

Returns the workspace and organisation this server acts in, the plan, the environment (live or test) and the units of the current period: included, used and the balance of prepaid units. Call it when the user asks where a document will land or how many renders are left, or when list_templates returns nothing you expected. A signed-in agent works in the workspace chosen when it was connected, which the person changes in Formfeed under Account → Connected agents; an API key works in the workspace it was made for. Read-only and free.

Input schema present but exposes no named parameters.

NameTypeReqDescription
environmentstring–live renders count units; test renders are free
organizationobjectyes–
periodobjectyesThe current billing period
planobjectyes–
unitsobjectyes–
workspaceobjectyes–

No examples provided.

list_templates ~218

Lists the templates of the workspace this server works in (the one chosen at sign-in, or the API key's), most recently changed first: id, slug, name, kind (pdf, image, docx for Word, pptx for PowerPoint), engine, tags and published_version. Call it first to find the slug that get_template_schema, validate_template and render take; skip it when the user already named the template. Returns every match in one answer, without archived templates, and an empty list when nothing matches. A template whose published_version is null has never been published, so render cannot use it yet. Read-only and free.

NameTypeReqDescription
enginestring–Only templates written in this template language
kindstring–Only templates that produce this kind of document
qstring–Text to find in the name or slug, case-insensitive (e.g. invoice)
tagstring–Only templates with this tag; exact match, tags are lowercase with dashes (e.g. billing)
NameTypeReqDescription
templatesarrayyes–

No examples provided.

markdown_to_pdf ~699

Turns a Markdown document into a PDF without a template, e.g. a report, notes or an answer you wrote, and returns the render with status and download_url. It reads GitHub Flavored Markdown (tables, task lists, strikethrough) and footnotes; a YAML front matter block gives the title, author, subject and keywords, else the first heading is the title; a line \newpage starts a new page. Raw HTML in the text is shown as text. A picture named without an address (![Logo](logo.png)) is a file of the workspace library, uploaded in Formfeed; with path, a picture beside the file is sent along instead. The headings become the PDF bookmarks by default, and pdf_ua checks the file against PDF/UA-1 before it is delivered. If the text holds formulas ($…$, $$…$$ or a ```math fence), set math: they are typeset with KaTeX, and a formula that does not parse fails the call naming its line; without math a $ is text, as in prices. If it holds ```mermaid fences, set diagrams: they are drawn by Mermaid; give each an accTitle line, its name in the PDF, and a diagram that cannot be drawn fails the call naming its line. To fill a template with data, use render; to convert an office file, use convert_to_pdf. Every call is a new render: one unit per started five pages on a live key or for a signed-in agent, free with a test key; every plan.

NameTypeReqDescription
cssstring–A stylesheet after the theme, e.g. h1 { color: #0f766e }; the document is inside div.ff-markdown
diagramsboolean–Draws ```mermaid fences with Mermaid (flowcharts, sequences, pie charts and more). Set it when you wrote one, with an accTitle line as its name; left out, a fence prints as code
filenamestring–Name of the PDF behind download_url, e.g. report.pdf
landscapeboolean–Landscape pages
markdownstring–The document as Markdown text, up to 1 MB; pass this or path
mathboolean–Typesets formulas with KaTeX: $…$ and $`…`$ in a line, $$…$$ on lines of their own, ```math fences. Set it when you wrote formulas; left out, a $ stays text
outlineboolean–Bookmarks from the headings (default true); they cost nothing
paperstring–Paper size; A4 when left out
pathstring–Absolute path of a Markdown file on this machine; pictures inside its folder are sent along
pdf_uaboolean–Makes the file a PDF/UA-1 document checked by veraPDF; a file that fails is not delivered and the result names the rules
themestring–document (default) styles the text, in the brand kit fonts and colour where the workspace has one; none leaves the styling to css
titlestring–The PDF title; left out, the front matter title or the first heading
waitboolean–true waits for a render that continues in the background; false returns it as it is, to check later with get_render
NameTypeReqDescription
accessibilityobject–The PDF/UA-1 verdict, when the template declares it
download_urlstring|nullyesSigned link to the file; null until the render succeeded
einvoiceobject–The e-invoice report, when the render made one
environmentstringyes–
error–yesWhy a failed render failed
expires_atstring|nullyesWhen download_url stops working; get_render issues a fresh one
formobject–What fill_pdf_form did: the fields filled, those left out (unknown name or invalid value) and those whose calculation or display format no viewer ran
idstringyesrnd_ id of the render
outputstring–The format of the file: pdf, png, jpg, webp, docx or pptx, or zip for the several files of split_pdf and pdf_to_image
page_countnumber|nullyes–
pdfaobject–The PDF/A verdict (PDF/A-2b or PDF/A-3b), when the template declares it
statusstringyes–
template–yesThe template and version rendered; null for html and conversions
unitsnumberyesUnits the render counted

No examples provided.

pdf_to_image ~401

Draws pages of a PDF as PNG or JPEG pictures and returns the render with download_url: one page gives the picture, which this tool also hands back so you can look at it (up to 2 MB), several pages a ZIP of pictures named by page. At most 100 pages and 120 million pixels a call, about 13 A4 pages at 300 dpi. Use it to see a page before redact_pdf, or for thumbnails. Pass exactly one PDF: source, a render or library file of the workspace; path, a file on this machine; or file_base64. Starter plan and above; one unit per picture on a live key.

NameTypeReqDescription
dpiinteger–Resolution, 36 to 300, 150 when left out; at 72 a pixel stands for a point
file_base64string–The PDF itself, base64 encoded, up to 20 MB; sent with the request and not kept
file_namestring–Name of the PDF given as file_base64 or path, e.g. contract.pdf; the results are named after it
filenamestring–Name of the file behind download_url; the source's name when left out
formatstring–png (the default) or jpg
pagesstring–The pages to draw, such as 1, 1-3,5 or 2- (page 2 to the last); every page when left out
pathstring–Absolute path of a PDF on this machine, up to 100 MB; sent with the request and not kept
qualityinteger–JPEG quality, 1 to 100; ignored for PNG
sourcestring–A PDF of the workspace: the rnd_ id of a PDF render, or a PDF of the file library by name (such as terms.pdf) or fil_ id
NameTypeReqDescription
accessibilityobject–The PDF/UA-1 verdict, when the template declares it
download_urlstring|nullyesSigned link to the file; null until the render succeeded
einvoiceobject–The e-invoice report, when the render made one
environmentstringyes–
error–yesWhy a failed render failed
expires_atstring|nullyesWhen download_url stops working; get_render issues a fresh one
formobject–What fill_pdf_form did: the fields filled, those left out (unknown name or invalid value) and those whose calculation or display format no viewer ran
idstringyesrnd_ id of the render
outputstring–The format of the file: pdf, png, jpg, webp, docx or pptx, or zip for the several files of split_pdf and pdf_to_image
page_countnumber|nullyes–
pdfaobject–The PDF/A verdict (PDF/A-2b or PDF/A-3b), when the template declares it
statusstringyes–
template–yesThe template and version rendered; null for html and conversions
unitsnumberyesUnits the render counted

No examples provided.

redact_pdf ~486

Removes what lies under rectangles of the pages, and every place where a text stands, from the file itself and not just from view: text, the pixels of images under a rectangle, and links and comments it touches. The result is read again: a text that can still be found fails the call with redaction_incomplete, which names rectangles and texts by their number, and nothing is delivered. Rectangles are points from the top-left corner of the page as a viewer shows it, 72 to an inch; get_pdf_info gives the page sizes and pdf_to_image a picture of the page. A text is found whatever its spacing, ignoring case unless match_case is true. A black box is drawn over each removed place, another colour with fill, none with fill null. Pass exactly one PDF: source, a render or library file of the workspace; path, a file on this machine; or file_base64. Starter plan and above; 0.5 units on a live key. The texts are never stored.

NameTypeReqDescription
file_base64string–The PDF itself, base64 encoded, up to 20 MB; sent with the request and not kept
file_namestring–Name of the PDF given as file_base64 or path, e.g. contract.pdf; the results are named after it
filenamestring–Name of the file behind download_url; the source's name when left out
fill––Colour of the box drawn over each removed place, #000000 when left out; null draws none
match_caseboolean–Find a text only in the case it is written in
pathstring–Absolute path of a PDF on this machine, up to 100 MB; sent with the request and not kept
regionsarray–The rectangles to remove, as a viewer shows the page; give regions, text or both
sourcestring–A PDF of the workspace: the rnd_ id of a PDF render, or a PDF of the file library by name (such as terms.pdf) or fil_ id
textarray–Texts to remove wherever they stand, such as a name or an IBAN, found whatever their spacing
whole_wordsboolean–Find a text only where a word boundary stands on each side
NameTypeReqDescription
accessibilityobject–The PDF/UA-1 verdict, when the template declares it
download_urlstring|nullyesSigned link to the file; null until the render succeeded
einvoiceobject–The e-invoice report, when the render made one
environmentstringyes–
error–yesWhy a failed render failed
expires_atstring|nullyesWhen download_url stops working; get_render issues a fresh one
formobject–What fill_pdf_form did: the fields filled, those left out (unknown name or invalid value) and those whose calculation or display format no viewer ran
idstringyesrnd_ id of the render
outputstring–The format of the file: pdf, png, jpg, webp, docx or pptx, or zip for the several files of split_pdf and pdf_to_image
page_countnumber|nullyes–
pdfaobject–The PDF/A verdict (PDF/A-2b or PDF/A-3b), when the template declares it
statusstringyes–
template–yesThe template and version rendered; null for html and conversions
unitsnumberyesUnits the render counted

No examples provided.

render ~579

Creates a document by filling a stored template, or ad-hoc html, with data: a PDF or image, or DOCX, PPTX or PDF from Word and PowerPoint templates. Returns the render with status and download_url; for an image (png, jpg or webp) up to 2 MB the result also carries the picture itself, so look at what you made before handing it on (a PDF comes as its link). Use it to make a document from data; to turn an existing office file into a PDF, use convert_to_pdf, and for a Markdown document, markdown_to_pdf. Stored templates render their published version, so one whose published_version is null fails with template_not_found. Every call is a new render: a live key or a signed-in agent consumes units, a test key is free (watermarked on the Free plan). A render that fails returns status failed and an error with code and message; validate_template finds most causes beforehand. With einvoice the PDF becomes a ZUGFeRD / Factur-X e-invoice built from data._invoice (check the block with check_invoice first): the render then carries einvoice, the validator's report, and a refused invoice names the fields and rules to fix. The link expires at expires_at; get_render issues a fresh one.

NameTypeReqDescription
dataobject–Values for the template, shaped as get_template_schema describes; leave out when it needs none
einvoice––Makes the PDF a ZUGFeRD / Factur-X e-invoice whose XML is built from data._invoice: true for the defaults, an object to choose, false to switch off what the template declares. PDF only; live renders…
enginestring–Template language of html, when it contains expressions to fill from data
filenamestring–Name of the file behind download_url, e.g. invoice-2026-0042.pdf
htmlstring–A complete HTML document to render instead of a stored template, up to 5 MB
localestring–BCP 47 tag for helpers and translations, e.g. de-DE
outputstring–Left out, the template decides: PDF for PDF templates and html, its image format for image templates, its default output for Word and PowerPoint templates. Word templates render docx or pdf, PowerPoi…
templatestring–Slug or tpl_ id of a stored template; pass this or html
waitboolean–Most renders are finished when the call returns; true also waits for one that continues in the background, false returns it as it is (queued or rendering) to check later with get_render
NameTypeReqDescription
accessibilityobject–The PDF/UA-1 verdict, when the template declares it
download_urlstring|nullyesSigned link to the file; null until the render succeeded
einvoiceobject–The e-invoice report, when the render made one
environmentstringyes–
error–yesWhy a failed render failed
expires_atstring|nullyesWhen download_url stops working; get_render issues a fresh one
formobject–What fill_pdf_form did: the fields filled, those left out (unknown name or invalid value) and those whose calculation or display format no viewer ran
idstringyesrnd_ id of the render
outputstring–The format of the file: pdf, png, jpg, webp, docx or pptx, or zip for the several files of split_pdf and pdf_to_image
page_countnumber|nullyes–
pdfaobject–The PDF/A verdict (PDF/A-2b or PDF/A-3b), when the template declares it
statusstringyes–
template–yesThe template and version rendered; null for html and conversions
unitsnumberyesUnits the render counted

No examples provided.

save_template ~518

Saves a template as a draft, never published: renders keep using the published version until a person publishes the draft in Formfeed. With template and base_checksum it saves a new version of that template: read it with get_template_source first, change what the user asked for, and pass only the parts you changed (the others are kept from the version you read). With new_template and html it creates a template whose version 1 is the draft. change_note says what changed; the person reads it before publishing. Returns the saved version, the check of the draft with its sample data (fix every error and save again) and review_url, the page where the person reviews and publishes it: hand that to the user. Needs an API key with template:write, or, for a signed-in agent, the person's permission under Account → Connected agents in Formfeed. Word and PowerPoint templates cannot be saved here. Free; a new template counts towards the plan's template limit.

NameTypeReqDescription
base_checksumstring–With template: the checksum get_template_source returned. When someone saved a newer version since, nothing is saved: read the source again and redo the change on it
change_notestringyesWhat the draft changes, in one sentence, shown in the version history
cssstring–The stylesheet; up to 1 MB
data_schema––JSON Schema of data; null removes the stored one
data_setsobject–Named sample data sets besides sample_data (name → data)
headstring–Extra markup for <head>, such as font links
htmlstring–The body markup in the template language, without <html>, <head> or <body>; up to 2 MB
i18n––Translations: locale → key → text, read by the t helper
new_templateobject–Creates a template whose version 1 is this draft; pass this and html, or template
partialsobject–Partials the template includes (name → source)
sample_dataobject–The data the editor previews with and the draft is checked with; never used by a render
settingsobject–Paper, margins, header, footer, fonts and the other settings, as get_template_source returns them; replaces the stored settings as a whole
templatestring–Slug or tpl_ id of the template to save a new draft of; pass this or new_template
NameTypeReqDescription
diagnosticsarrayyes–
nextstringyes–
okboolean|nullyesfalse when the check of the draft found an error; null when the check could not run
review_urlstring–The page in Formfeed where the person reviews and publishes the draft
templateobjectyes–
versionobjectyes–

No examples provided.

split_pdf ~343

Cuts a PDF into parts, every N pages each or one part per entry of ranges, and returns the render with download_url: a ZIP of the parts, named after the source (contract-1.pdf, contract-2.pdf and so on), or the PDF itself when there is one part. get_pdf_info gives the page count first. Pass exactly one PDF: source, a render or library file of the workspace; path, a file on this machine; or file_base64. Starter plan and above; 0.5 units on a live key. A PDF/A or a password-protected PDF is refused.

NameTypeReqDescription
everyinteger–Pages per part; give every or ranges
file_base64string–The PDF itself, base64 encoded, up to 20 MB; sent with the request and not kept
file_namestring–Name of the PDF given as file_base64 or path, e.g. contract.pdf; the results are named after it
filenamestring–Name of the file behind download_url; the source's name when left out
pathstring–Absolute path of a PDF on this machine, up to 100 MB; sent with the request and not kept
rangesarray–One part per entry, each a page selection such as 1-3,5, or 4- for page 4 to the last; give every or ranges
sourcestring–A PDF of the workspace: the rnd_ id of a PDF render, or a PDF of the file library by name (such as terms.pdf) or fil_ id
NameTypeReqDescription
accessibilityobject–The PDF/UA-1 verdict, when the template declares it
download_urlstring|nullyesSigned link to the file; null until the render succeeded
einvoiceobject–The e-invoice report, when the render made one
environmentstringyes–
error–yesWhy a failed render failed
expires_atstring|nullyesWhen download_url stops working; get_render issues a fresh one
formobject–What fill_pdf_form did: the fields filled, those left out (unknown name or invalid value) and those whose calculation or display format no viewer ran
idstringyesrnd_ id of the render
outputstring–The format of the file: pdf, png, jpg, webp, docx or pptx, or zip for the several files of split_pdf and pdf_to_image
page_countnumber|nullyes–
pdfaobject–The PDF/A verdict (PDF/A-2b or PDF/A-3b), when the template declares it
statusstringyes–
template–yesThe template and version rendered; null for html and conversions
unitsnumberyesUnits the render counted

No examples provided.

validate_einvoice ~410

Says which rules an e-invoice passed, by which validator and release: the file is held to the rule set its specification identifier (BT-24) names, Factur-X and ZUGFeRD by Mustang, XRechnung (CII and UBL) by the KoSIT validator, and each check (syntax, schema, every named rule set) comes back with its own result and findings. Pass exactly one source: render_id, an e-invoice this workspace rendered, which is answered from the report the render keeps and costs nothing; path, an XML file on this machine; or xml_base64, the XML itself. An XML takes one of the organisation's validations of the day (from the Starter plan; Free validates no uploads). Up to 4 MB of CII or UBL; a PDF is not taken. result is passed, failed or not_checked: not_checked means no rule set here is for the file (reason and explanation say why, such as an identifier it does not know), not that the file is wrong. The report says which rules a file passed; it does not say whether the document is a proper invoice for VAT purposes. To check an _invoice block before rendering it, use check_invoice.

NameTypeReqDescription
pathstring–Absolute path of an e-invoice XML on this machine; counts one of the day’s validations
render_idstring–rnd_ id of a render of this workspace that made an e-invoice; free
rulesstring–auto (default) takes the rule set the file's identifier names; a rule set named here judges only a file whose identifier it is for. en16931 holds a render's EN 16931 invoice to CEN's own rules, which…
xml_base64string–The e-invoice XML (CII or UBL), base64 encoded, up to 4 MB; counts one of the day’s validations
NameTypeReqDescription
allowance–yesWhat the day's validations have used after this call; null where nothing was counted
checksarrayyes–
customization_idstring|nullyesThe specification identifier (BT-24) the file names
explanationstring|nullyes–
reasonstring|nullyesWhy it was not checked, such as unknown_customization_id
resultstringyespassed, failed or not_checked; new values may be added
rulesstring|nullyesThe rule set and its release, as the validator names it
validatorstring|nullyesThe validator and its version, e.g. KoSIT validator 1.6.3
xml_sha256string|nullyesSHA-256 of the XML that was judged

No examples provided.

validate_template ~296

Checks a template and its data without rendering: free, no units, nothing stored, no document produced. Call it before render when you assembled the data yourself, or after writing ad-hoc html. With template, the API checks the published version (else the latest, or the version you name) as a render would: syntax, header and footer, errors only this data triggers, and the data against the stored JSON Schema (a wrong type or a missing required field is an error). With html and engine it compiles offline and reports syntax errors, unknown filters and variables missing from data. Returns ok and diagnostics (severity, code, message, plus path, line and column, or part and paragraph for Word and PowerPoint). Warnings leave ok true: settle each before rendering.

NameTypeReqDescription
dataobject–The data the document will be rendered with, shaped as get_template_schema describes. Left out, a stored template is checked with its sample data
enginestring–Template language of html; required with html
htmlstring–Template source to check offline, when there is no stored template; pass this or template
templatestring–Slug or tpl_ id of a stored template; pass this or html
version––With template: the version to check, such as latest for the newest draft or a number; left out, the published one, else the latest
NameTypeReqDescription
diagnosticsarrayyes–
okbooleanyesfalse when a diagnostic is an error
templateobject–The stored version checked; absent for html

No examples provided.

Install

How do I install the Formfeed MCP server?

Formfeed runs locally as an npm package, launched with npx -y @formfeed/mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · @formfeed/mcp

# add to Claude Code
claude mcp add formfeed-dev-formfeed -- npx -y @formfeed/mcp
Common questions

What is the Formfeed MCP server?

Formfeed is an MCP server listed in the public MCP registry as io.github.formfeed-dev/formfeed. Render PDFs and images from templates, validate data and convert Office files to PDF. This page covers its npm package (@formfeed/mcp).

Is the Formfeed MCP server safe to use?

Formfeed scores 92 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 22 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the Formfeed MCP server expose?

Formfeed exposes 18 tools: list_templates, get_template_schema, get_template_source, validate_template, save_template, and 13 more. Their descriptions and schemas cost roughly 6,034 tokens of context every time the server is loaded.

Is the Formfeed MCP server still maintained?

Formfeed is still listed as active in the MCP registry. We last reached this channel on 22 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the Formfeed MCP server under?

Formfeed declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

What did VerifyMCP test on the Formfeed MCP server?

VerifyMCP ran 16 checks on Formfeed, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.