check_credits
Show how many GuruPDF credits the user has left, and how to get more.
LABSCO SUMMARY
The whole conversion catalogue behind four calls, so the tool list stays small.
A server that exposed every conversion as its own tool would put more than a hundred definitions in the model's context on every turn. Here the catalogue is something the model looks up when it needs it, and the work happens against files already on your disk.
What it is
A Node server in front of GuruPDF's conversion service. Four calls cover the whole surface: submit a local file or URL for any supported conversion, poll the job, list what conversions exist, and check credits. Results are downloaded back to disk.
What you get
- Any of GuruPDF's conversions on a local file or a URL — PDF to and from Word, Excel and PowerPoint, images, ebooks, plus OCR, compress, merge, split, rotate, protect and watermark
- A job checked by its id, with the finished result written to disk rather than left on a download page
- The catalogue of supported conversions, filterable by input format, so you can ask what is possible before trying
- Your remaining credit balance and how to top it up
- Files read and written on your machine — no manual upload and download step
Requirements
A recent Node.js and a free GuruPDF API key in GURUPDF_API_KEY; the token comes from Profile, API tokens after signup. No install step — npx fetches gurupdf-mcp on first run. Every account gets daily credits without a credit card.
Setup effort
One command plus a key — npx -y gurupdf-mcp, then supply credentials
USE CASES
01
Turning a document into the format someone asked for
Name the local file and the target format; the converted file lands back on disk next to it.
02
Checking what is even possible with a file you have
List the conversions filtered by the input format before deciding what to ask for.
03
Getting a large scan through an email size limit
Submit it for compression or OCR and pick the result up by job id when it finishes.
04
Knowing whether the next batch will go through
Read the credits left before starting a run of conversions rather than after it stalls.
4 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
convert_file
Convert or process a local file (or URL) with GuruPDF. Convert between 100+ formats (PDF ⇄ Word/Excel/PowerPoint, images, ebooks, etc.) or run a PDF tool (compress, merge, split, rotate, protect, watermark, OCR…). Saves the result next to the input and returns the path.
get_status
Check a GuruPDF conversion job by its id (uuid). If it's finished, downloads the result to disk.
list_conversions
List the conversions and tools GuruPDF supports, optionally filtered by an input file format.
BEFORE YOU INSTALL
What to know first
Tools you get
4 tools when we connected. The 126 conversions are formats or slugs passed to convert_file, such as compress-pdf or merge-pdf; list_conversions shows which apply to a given input.
Requires
- npx on PATH
- GURUPDF_API_KEY in your environment
Where it runs
All 4 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 4 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y gurupdf-mcpMCP Clients
Claude Desktop, Cursor, Windsurf
JSON
{
"mcpServers": {
"gurupdf": {
"command": "npx",
"args": [
"-y",
"gurupdf-mcp"
],
"env": {
"GURUPDF_API_KEY": "<YOUR_GURUPDF_API_KEY>"
}
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"gurupdf": {
"command": "npx",
"args": [
"-y",
"gurupdf-mcp"
],
"env": {
"GURUPDF_API_KEY": "<YOUR_GURUPDF_API_KEY>"
}
}
}
}
