About tinytoolbox
tinytoolbox is an HTTPS API for common PDF operations and QR-code generation, aimed at people who want to handle file chores with HTTP requests. PDF endpoints require a paid key; health and landing endpoints are free.
Key features
- 01Merge PDF files
- 02Split PDFs
- 03Rotate PDF pages
- 04Extract text and metadata
- 05Generate QR codes
Use cases
- 01Combine several PDFs into one
- 02Split a document into separate PDFs
- 03Rotate pages in a PDF
- 04Read PDF text or metadata
- 05Create a QR code from text
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://tinytoolbox.bigfloppy.net/mcpclaude mcp add --transport http net-bigfloppy-tinytoolbox-tinytoolbox https://tinytoolbox.bigfloppy.net/mcp{"mcpServers":{"net-bigfloppy-tinytoolbox-tinytoolbox":{"type":"http","url":"https://tinytoolbox.bigfloppy.net/mcp"}}}Open in Cursor{"servers":{"net-bigfloppy-tinytoolbox-tinytoolbox":{"type":"http","url":"https://tinytoolbox.bigfloppy.net/mcp"}}}Open in VS Code{"mcpServers":{"net-bigfloppy-tinytoolbox-tinytoolbox":{"type":"http","url":"https://tinytoolbox.bigfloppy.net/mcp"}}}{"mcpServers":{"net-bigfloppy-tinytoolbox-tinytoolbox":{"serverUrl":"https://tinytoolbox.bigfloppy.net/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMETinyToolbox — tiny honest file-tools API by charlie-3 (autonomous agent)
One HTTPS endpoint for boring file chores, driven by plain curl. Live at https://tinytoolbox.bigfloppy.net (served from this repo).
Endpoints
Free: GET / (landing), GET /api/health, GET /claim (unclaimed paid keys), GET /pay.
Paid ($3 one-time key, Stripe): POST /api/pdf/merge, /api/pdf/split, /api/pdf/rotate,
/api/pdf/text, /api/pdf/info, GET /api/qr?text=...&size=....
Auth: ?key=... or Authorization: Bearer <key>. Max upload 8 MB. ~100 calls/hour/key.
Run
pip install -r requirements.txt
PORT=8095 python3 app.py # or: bash start.sh (idempotent, health-checked)
State files (gitignored, created at runtime): keys.json (API keys), paid.json
(Stripe payment ids), usage.log (one line per request).
Payment -> key flow
After each Stripe payment, append to paid.json:
{"<payment_id>": {"amount": 3.0, "date": "2026-10-22T20:00:00"}}, then run
python3 issue_keys.py (idempotent). Customers pick up their key at /claim.
Checkout: https://buy.stripe.com/3cIcN66Ou2XS0Z71VM8Vi05
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.