TinyToolbox MCP server
Commit Oct 27, 2026Performs PDF manipulations like merging, splitting, and rotating, generates QR codes, and scans for malicious content via a single API endpoint.
Also known as wminno/tinytoolbox
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.1.2
- Last commit
- Oct 27, 2026
- License
- —
What is TinyToolbox MCP?
TinyToolbox performs PDF manipulations like merging, splitting, and rotating, generates QR codes, and scans for malicious content via a single API endpoint.
Summary generated from the project's README
About TinyToolbox MCP server
Automating repetitive file chores like merging or splitting PDF documents is what tinytoolbox enables for developers. This remote API provides a single HTTPS endpoint to handle various document manipulations and utility tasks through simple curl commands. Users can perform PDF operations such as rotating pages, extracting text, or retrieving file information, as well as generating QR codes with specific sizes.
Accessing the paid features requires a one-time three dollar key obtained via Stripe. Once you have a key, you can authenticate using a query parameter or a Bearer token. The service imposes an 8 MB upload limit per request and a rate limit of approximately 100 calls per hour per key. It is designed for those who need a straightforward way to process files without managing complex local dependencies.
What you can do with it
- 1Combine multiple PDF filesAsk the AI to merge several separate documents into a single PDF file.
- 2Extract text from documentsInstruct the client to read the textual content contained within a PDF.
- 3Generate custom QR codesRequest the creation of a QR code for a specific string of text at a chosen size.
- 4Split a large PDFHave the AI divide a single PDF document into smaller individual parts.
Written from the project's README. Every use case is checked against a quote from it.
How to install TinyToolbox MCP
Formats verified 10 Nov 2026Install TinyToolbox MCP in Claude Code
$ claude mcp add --transport http tinytoolbox https://tinytoolbox.bigfloppy.net/mcpInstall TinyToolbox MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"tinytoolbox": {
"url": "https://tinytoolbox.bigfloppy.net/mcp"
}
}
}Install TinyToolbox MCP in VS Code
.vscode/mcp.json
{
"servers": {
"tinytoolbox": {
"type": "http",
"url": "https://tinytoolbox.bigfloppy.net/mcp"
}
}
}Install TinyToolbox MCP in Codex
~/.codex/config.toml
[mcp_servers.tinytoolbox] url = "https://tinytoolbox.bigfloppy.net/mcp"
Install TinyToolbox MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"tinytoolbox": {
"httpUrl": "https://tinytoolbox.bigfloppy.net/mcp"
}
}
}README
View on GitHubTinyToolbox — 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
TinyToolbox MCP questions
How do I add TinyToolbox MCP to Claude Code?
Run claude mcp add --transport http tinytoolbox https://tinytoolbox.bigfloppy.net/mcp in your terminal. Add --scope user to make it available in every project.
How do I add TinyToolbox MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What are the available PDF operations?
The service supports merging, splitting, rotating, extracting text, and retrieving metadata from PDF files.
How much can I upload at once?
The maximum upload size allowed is 8 MB.
What are the rate limits for the paid API?
Paid keys are limited to approximately 100 calls per hour.
How do I authenticate my requests?
You can authenticate using a query parameter or a Bearer token in the Authorization header.