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
Chalk Labs
Need help deploying JustFill PDF Form Automation?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
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, install config and code. Checked Nov 1, 2026.
- Tools
- 3 read · 7 write · 3 delete · 1 not yet classified
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- None found
- 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 3
api.justfill.app· found in remote endpoint, install commandgithub.com· found in codejustfill.app· found in code
Files it touches
- Your home directory (~)
- 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 (11 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
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get JustFill PDF Form Automation running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
JustFill PDF Form Automation MCP server. Agent Mart. https://agentmart.dev/connectors/mrmaciej1-justfill-pdf-forms (last updated 2026-10-24)