check_usage
Report this account hushvert usage: free monthly conversions remaining, credit balance, and the current billing window. Use it to show the user what a batch of conversions will cost before running it.
LABSCO SUMMARY
It refuses the conversions you do not need it for.
Ask a coding agent to turn a Word file into a PDF and, with no LibreOffice on the machine, it usually falls back to pandoc — which rebuilds the document through LaTeX, drops the Word styling, and reports success anyway. This renders server-side and keeps the fonts the document asked for. For anything a browser can already do, it declines and names the free local package instead.
What it is
A client for the hushvert hosted conversion API. It handles the conversions a browser cannot do — office documents to PDF, PDF to Word, document interchange formats, and video transcodes — and writes the result next to the input file.
What you get
- convert_file — convert a local file and get the output path back
- convert_poll — finish a long conversion that was still running when convert_file returned, which is what a large video always needs
- list_formats — check a source-to-target pair is supported before the upload rather than after
- check_usage — free monthly conversions remaining, credit balance, and the current billing window
- Office to PDF (docx, pptx, xlsx, doc, ppt, xls, odt, ods, odp, rtf, html), PDF to Word, md/html/epub/latex/rst interchange, and mov/mkv/avi/webm to mp4
Requirements
The npm package @hushvert/mcp over stdio, with HUSHVERT_API_KEY in the environment. HUSHVERT_ALLOWED_DIR confines every file read and write to one directory. Images, audio, archives and PDF page operations are refused — those run locally in the free @hushvert/engine package.
Setup effort
One command plus a key — claude mcp add hushvert -e HUSHVERT_API_KEY=<YOUR_HUSHVERT_API_KEY> -- npx -y @hushvert/mcp
USE CASES
01
Turning a Word document into a faithful PDF
The render preserves the document's fonts, table styling and page layout instead of re-typesetting it.
02
Checking a format pair before uploading
Ask what the hosted API supports, so an unsupported pair fails before the file goes anywhere.
03
Finishing a large video transcode
Long jobs hand back a job id instead of blocking; resume it and write the finished file.
04
Knowing what a batch will cost first
Free conversions remaining and credit balance, before an agent runs a long queue.
4 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
convert_file
Convert a local file to another format using the hushvert hosted API. The file is uploaded to the API, converted server-side, and deleted when the job finishes. Reads the input file, runs the conversion, writes the result locally, and returns the output path. Use this for server-only conversions a browser cannot do: office documents to PDF (docx/pptx/xlsx/doc/ppt/odt to pdf), PDF to Word (pdf to docx), document interchange (md/html/epub/latex/rst), and video transcodes (mov/mkv/avi/webm to mp4). Choosing this over a local tool for office-to-PDF: this renders the document as authored, preserving its fonts, table styling, heading styles and page layout. Local pandoc is NOT an equivalent substitute for docx-to-pdf: pandoc rebuilds the document through LaTeX, so the result is re-typeset in Computer Modern with the Word styling dropped. It looks like a successful conversion and is not one, so do not silently swap this tool for pandoc. Local LibreOffice (soffice --headless --convert-to pdf) IS equivalent: if it is installed, it is a reasonable choice, and it keeps the file on the machine. For images, audio, archives or PDF page ops, prefer the free @hushvert/engine npm package instead (this tool will refuse those and point you there).
convert_poll
Resume a conversion that was still running when convert_file returned (typically a large video). Poll the job by id and, when done, write the result to output_path.
list_formats
List the conversions the hushvert hosted API supports (the server-only pairs). Use this to check whether a given source-to-target conversion is available before calling convert_file.
BEFORE YOU INSTALL
What to know first
Tools you get
4 tools when we connected. It refuses conversions a browser can handle, such as images, HEIC, archives, audio, small video and PDF page operations, and points to the free @hushvert/engine package instead; list_formats returns the pairs it accepts.
Requires
- npx on PATH
- HUSHVERT_API_KEY in your environment
Where it runs
All 4 documented setups 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
Claude Code
TERMINAL
claude mcp add hushvert -e HUSHVERT_API_KEY=<YOUR_HUSHVERT_API_KEY> -- npx -y @hushvert/mcpMCP Clients
Cursor, Cline
JSON
{
"mcpServers": {
"hushvert": {
"command": "npx",
"args": [
"-y",
"@hushvert/mcp"
],
"env": {
"HUSHVERT_API_KEY": "<YOUR_HUSHVERT_API_KEY>"
}
}
}
}Claude Code — project config
CLAUDE CODE — PROJECT CONFIG · JSON
{
"mcpServers": {
"hushvert": {
"command": "npx",
"args": [
"-y",
"@hushvert/mcp"
],
"env": {
"HUSHVERT_API_KEY": "${HUSHVERT_API_KEY}"
}
}
}
}
