JustFill PDF Form Automation
Detect, review and fill existing PDF forms from JSON or Excel; reuse saved templates
Connector by mrmaciej1 · GitHub account verified by the MCP Registry
Install
Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/mrmaciej1-justfill-pdf-forms
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Remote endpoint
https://api.justfill.app/api/mcpRemote (HTTP)
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 3 read · 7 write · 3 delete · 1 not yet classified
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- Not scanned yet
- Runs as
- Python package
Tools by what they do 14
Read from the source code; the running server may list different tools.
Read 3 · Look things up without changing anything.
list_fieldslist_templatesrender_preview
Write 7 · Create, change, send or run things.
add_fieldclose_workspacefill_pdfrender_filled_previewsave_templateupdate_fieldupdate_fields
Delete 3 · Delete, drop, revoke or wipe things.
prune_fieldsremove_fieldremove_fields
Not yet classified 1 · We could not tell from the name and description.
open_pdf
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
JUSTFILL_API_KEY
Network hosts it talks to 1
api.justfill.app· found in remote endpoint, install command
Files it touches
- Any path the agent passes to its tools
Tools (14)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
add_fieldAdd a field the detector missed (a false negative). Coordinates are percentages of the page (0-100), top-left origin — read them off the render_preview image proportionally. align ('left'|'center'|'right') and vertical_align ('top'|'middle'|'bottom') control where the value sits inside the box when the PDF is filled.
close_workspaceRelease the current PDF and field data when work is finished. Saved templates and output PDFs are not deleted. This operation is idempotent, which makes it safe to call from automation cleanup blocks.
fill_pdfFill the PDF and save it. `values` maps field id -> text value (checkboxes: "true"/"yes"/"x" to tick). Fields not present in `values` stay empty. AcroForm fields are filled natively inside the PDF; everything else is drawn at its exact box. The response's `warnings` list flags values that will be shrunk or truncated to fit their box — fix those before delivering the document.
list_fieldsList the current working fields (optionally one page only).
list_templatesList saved templates on this account (name + field count + hash).
open_pdfOpen a PDF (or a scanned image: jpg/png/tiff) and detect its fillable fields. Images are converted to a single-page PDF automatically (deterministically, so a template saved for a photo matches the same photo next time). Resolution order (best source wins): 1. Saved template matching this exact file (deterministic, confidence 1.0) 2. Embedded AcroForm fields (deterministic, confidence 1.0) 3. ML detection (each field carries a confidence score) force_detect=True skips steps 1-2 and re-runs ML detection from scratch — use it to rebuild a layout when the saved template is wrong or stale…
prune_fieldsBulk-delete fields matching ALL given criteria (e.g. detection noise). field_type: exact type match (e.g. 'cell'); confidence_below / width_below / height_below: strictly-less-than thresholds (w/h in % of page); page_index: limit to one page; exclude_ids: always keep these. Returns the removed ids so the operation is auditable (and reversible via add_field if it cut too much).
remove_fieldDelete a field that isn't a real input (a false positive).
remove_fieldsDelete many fields in one call (batch version of remove_field).
render_filled_previewPreview how the filled page will look BEFORE generating the PDF. Draws `values` (field id -> text; checkboxes get an X) into their boxes on the rendered page. Costs nothing — no fill is consumed. Typography is an approximation of the final output (the server typesets the real PDF), so use it to verify placement, alignment and obvious overflow, then fill_pdf.
render_previewRender a page with the working field boxes drawn on it. Look at this image to VERIFY placement: blue boxes are deterministic (template/AcroForm/agent-placed); green/orange/red are ML detections by confidence (>=0.7 / >=0.4 / <0.4). Each box is labeled with its field id.
save_templateSave the current (reviewed) field layout as a reusable template. Next time this exact PDF is opened — by you or another agent session on this account — open_pdf returns these fields with confidence 1.0 and no ML pass at all. This is what makes repeat filling deterministic. Before saving, give every field a short semantic name (update_fields with name=..., e.g. 'age_score', 'total_abcd2') — names are stored in the template, so the next session maps values by meaning instead of guessing from coordinates. Also remove false positives first (remove_fields).
update_fieldMove/resize/rename a field, or set its text alignment. align: 'left'|'center'|'right'; vertical_align: 'top'|'middle'|'bottom' — where the value sits inside the box in the filled PDF.
update_fieldsUpdate many fields in one call (batch version of update_field). Each item: {"field_id": "...", and any of x, y, w, h, name, field_type, align, vertical_align}. Items with an unknown field_id are reported back, the rest are still applied.
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 0
- Weekly downloads
- 45
- Last commit
- Oct 20, 2026 (8 days ago)
- Last release
- Aug 24, 2026 (2 months ago)
- Last package publish
- Aug 24, 2026 (2 months ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.mrmaciej1/justfill-pdf-forms- Version
- 0.4.10
- Auth
- Auth not stated, API key
- Packages
- pypi justfill-mcp
- License
- MIT
- Repository
- github.com/mrmaciej1/justfill-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
JustFill PDF Form Automation MCP server. Agent Mart. https://agentmart.dev/connectors/mrmaciej1-justfill-pdf-forms (last updated 2026-10-24)