┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
 │ 1. Inspect │ │ 2. Fill │ │ 3. Done │
 │ │ → │ │ → │ │
 │ list_form_ │ │ fill_form │ │ Filled PDF │
 │ fields │ │ │ │ saved to disk │
 │ │ │ │ │ │
 │ Returns every │ │ Writes values, │ │ Open in │
 │ field name, │ │ saves output │ │ Preview or │
 │ type & value │ │ file │ │ send anywhere │
 └─────────────────┘ └─────────────────┘ └─────────────────┘

{
 "mcpServers": {
 "formfill": {
 "command": "/Users/YOUR_USERNAME/Projects/formfill-mcp/venv/bin/python",
 "args": ["/Users/YOUR_USERNAME/Projects/formfill-mcp/server.py"]
 }
 }
}

List the fillable fields in /Users/me/Desktop/w9.pdf using API key ff_free_abc123

Fill the form at /Users/me/Desktop/w9.pdf with:
 name: Jane Smith
 TIN: 12-3456789
 address: 123 Main St, Austin TX 78701
Save to /Users/me/Desktop/w9_filled.pdf
API key: ff_free_abc123

Fill the W-9 at ~/Desktop/fw9.pdf with my name "John Smith", SSN "123-45-6789",
address "456 Oak Ave, Boston MA 02101". Business type: Individual/sole proprietor.
Save to ~/Desktop/fw9_filled.pdf. API key: ff_free_abc123

Fill the rental application at ~/Desktop/rental_app.pdf with these values:
[paste field values]. Save to ~/Desktop/rental_filled.pdf. API key: ff_free_abc123

Fill the 8-page NDA at ~/Desktop/nda.pdf. My name: Jane Smith, Company: Acme Corp,
Date: March 28 2026. Use fill_form_multipage. API key: ff_free_abc123

{
 "ok": true,
 "output_path": "/Users/me/forms/w9_filled.pdf",
 "fields_filled": 12,
 "invalid_fields": []
}

{"ok": false, "error": "Invalid API key"}
{"ok": false, "error": "Usage limit reached. Upgrade at https://formfill.plenitudo.ai"}
{"ok": false, "error": "File not found: /Users/me/missing.pdf"}

git clone https://github.com/knportal/formfill-mcp.git
cd formfill-mcp

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

cp .env.example .env
python manage_keys.py create --tier free
python server.py
# → MCP server running on http://localhost:8000

server.py — MCP server (3 tools)
auth.py — API key validation + usage tracking (SQLite)
stripe_webhook.py — Stripe subscription webhook handler
worker.js — Cloudflare Worker (remote proxy)
manage_keys.py — Key management CLI
data/keys.db — API key store
data/usage.db — Monthly usage counters